[next] [previous] [contents]

  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.

  /DISPLAY_STATUS (Default)
  /NODISPLAY_STATUS

  Specifies whether an error status is displayed. If /NODISPLAY_
  STATUS is specified, the inhibit message modifier is set in the
  exit status, thus stopping DCL from displaying the messages
  associated with the status.

  By default, an error status is displayed.

  /ECHO (Default)
  /NOECHO

  Specifies whether characters are echoed as they are entered
  at the keyboard.

  By default, characters are echoed.

  /ERROR=label

  Transfers control to the location specified by the label key-
  word (in the current command procedure) when an accept
  error occurs. If no error routine is specified and an error
  occurs during the accepting of the symbol, the current ON
  condition action is taken.

  Overrides any ON condition action specified.
If an error occurs and the target label is successfully given
  control, the reserved global symbol $STATUS retains the
  error code.

  /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



  LIBRARY=library-file The HELP library in which
                                              to find the subject. If this
                                              keyword is not supplied, the
                                              default HELP library search
                                              list is used.
  [NO]LOOP Specifies whether the ACCEPT
                                              command keeps requesting a
                                              value after HELP has been
                                              supplied. By default, LOOP is
                                              assumed.
  SUBJECT=subject The subject on which help will
                                              be supplied.

  By default, no help is used.

  /INITIAL_VALUE=string
  /NOINITIAL_VALUE (Default)

  Specifies an initial value for the symbol. This is used as
  though the user had already entered the text specified in the
  string.

  By default, no initial value is used.

  /LOCAL (Default)

  Specifies that the symbol be placed in the local symbol table
  for the current command procedure.

  /PROMPT=string
  /NOPROMPT

  Specifies an alternate prompt string to be displayed when
  reading.

  By default, the prompt string "Data:#" is displayed.

  /SIZE=n

  Specifies the maximum size of the symbol value. If you enter
  the /SIZE qualifier, you must specify a value, and the value
  must be from 0 through 255.

  By default, a maximum symbol value size of 255 is used.

  /TERMINATOR=term-symbol-name
  /NOTERMINATOR (Default)

  Specifies a symbol to be given the value of the terminator.
  The terminator symbol is placed in the same symbol table as
  the symbol-name parameter.

  By default, the terminator is not returned.

  /TIME_OUT=n
  /NOTIME_OUT (Default)

  Specifies the number of seconds after which the ACCEPT
  command is terminated if no input is received. If you enter
  the /TIME_OUT qualifier, you must specify a value, and the
  value must be from 0 through 255.

  By default, no timeout will occur.

  /TRMECHO (Default)
  /NOTRMECHO

  Specifies whether the terminator characters are echoed as
  they are entered at the keyboard.

  By default, the terminator characters are echoed.

  /TRMKEYS=string

  Specifies optional extra terminator characters. The string is a
  set of terminator characters which must have ASCII values
  in the range 0 through 31.

  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.

  Examples
  1.
{system-prompt}
        {user-response}