ACCEPT
Requests interactive assignment of a value for a local or
global symbol during the execution of a command procedure.
Format
ACCEPT symbol-name
Parameters
symbol-name
Specifies a 1- through 255-alphanumeric character symbol
to be given a value.
Qualifiers
/CONVERT[=SHORT | LONG]
/NOCONVERT ( Default)
Specifies that the terminator symbol value be converted from
its raw value into a symbolic value. The keyword of SHORT
or LONG indicates which style of name to return. If neither
is specified, SHORT is used by default. The symbolic values
returned listed in Table 1-1. Where a LONG code is blank,
the SHORT code is returned.
By default, no conversion of the terminator symbol value
occurs.
/DEFAULT_VALUE=string
/NODEFAULT_VALUE (Default)
Specifies an default value for the symbol. This is used if the
resultant input string has a zero length.
By default, no default value is used.
By default, an error status is displayed.
By default, characters are echoed.
Overrides any ON condition action specified.
/GLOBAL
Specifies that the symbol be placed in the global symbol ta-
ble. If you do not specify the /GLOBAL qualifier, the symbol is
placed in the local symbol table.
/HELP[=(keyword[,...])]
/NOHELP (Default)
Specifies help to be used when a user presses
Help
key. Any
combination of the following keywords may be used:
Keyword Usage
By default, no help is used.
By default, no initial value is used.
/PROMPT=string
/NOPROMPT
Specifies an alternate prompt string to be displayed when
reading.
By default, the prompt string "Data:#" is displayed.
By default, a maximum symbol value size of 255 is used.
By default, the terminator is not returned.
By default, no timeout will occur.
By default, the terminator characters are echoed.
By default, Control B (also Up-arrow), Return, Control W
and Control Z are terminator characters.
Note that escape sequences are also terminators. All function
keys (F6 - F20), extended function keys (E1 - E6), pro-
grammable function keys (PF1 - PF4), and the down-arrow
key generate escape sequences.
/UPPERCASE
/NOUPPERCASE (Default)
Specifies whether lowercase characters entered at the key-
board are converted to uppercase.
By default, lowercase characters are not converted to upper-
case.
/WINDOW
/NOWINDOW (Default)
Specifies whether a character cell terminal or window
method is used to accept the symbol value.
By default, a character cell terminal method is used.