AT&T UNIX™PC Unix System V Users Manual - tenox

SHFORM (I) {AT&T UNIX PC only ) SHFORM (I)
NAME shform - displays menus and forms and returns user input to
Bourne Shell procedures.
SYNOPSIS
RET = 'shform [-u] formname'
DESCRIPTION
The shform process displays a menu or form, waits for user input,
and returns the result to the shell procedure.
Formname is a text document, called a form description file, that
describes the menu or form to be displayed. Entries in the file use
a keyword = value syntax. (The form and menu keywords are
described below.) The file must be located in the fusrflibfua
directory. To insert a comment in the file, start the line with a
pound sign ( # ).
The value returned by the file is stored in the shell variable RET
as a list of words separated by spaces. If an error occurs, then $?
will contain an error code.
-u causes shform to place its menu or form in the current window,
resizing it appropriately to fix the menu or form. This option is
recommended.
Shform returns the following exit codes:
0-AOK
1 - Argument error
2 - Out of memory (malloc failed)
3 - Internal table overflow
4 - Syntax error in form description file
The words in $RET are as follows:
word 1 = Name of terminating key
if form, words 2 -n = Values of the form's fields
if menu, word 2 = Name of selected menu item
if multiselect menu, words 2 - n = Name of selected
menu items
Form Definition Keywords
Form = form name
Flags the start of a form. It is followed by a series of field
definitions. The form name specified here is used as the
title of the form. Only one Form keyword can be used in
the file.
Name = field name
Follows a Form keyword and starts a field definition. The
field name specified here is used as the prompt for the
field. The field name definition is followed by field attribute
definitions:
Prompt = prompt string
Displayed on the prompt line when the field is the current
field.
- 1 -