408 Chapter 5
Command Definitions L-O
OPTION
OPTION
Modifies the runtime environment of user-defined commands and command files. It is used
within the body of a user command to set up and change the environment dynamically.
(Native Mode)
NOTE Be sure to distinguish between the OPTION command and OPTION used in the
header of a user command.
The OPTION command (described here) accepts only the LIST/NOLIST and
RECURSION/NORECURSION parameters. OPTION used in the header of a UDC
or a command file accepts the HELP/NOHELP, LOGON/NOLOGON, BREAK/NO
BREAK, and PROGRAM/NOPROGRAM parameters, in addition to the
LIST/NOLIST and RECURSION/NORECURSION parameters.
Syntax
OPTION[ { LIST NOLIST } ] [ ,] [ { RECUR NORECURSION } ]
Parameters
LIST Displays the command lines in a user command (UDC or command file)
before each command in the user command is executed.
NOLIST Suppresses the display of the command lines in a user command when it is
executed. NOLIST is the default.
RECURSION Begins the search for UDCs at the beginning of the cataloged commands
list. RECURSION and NORECURSION do not have any meaning in a
command file, because command files are not cataloged.
NORECURSION Begins the UDC search at the command currently executing and
continues, in order, through the UDC catalog, as in MPE V/E. Default.
RECURSION and NORECURSION do not have any meaning in a command
file, because command files are not cataloged.
NOTE OPTION values are set to defaults whenever a command file or UDC is
executed. If OPTION is specified as part of the user command definition then
OPTION will be reset to this value if another UDC or command file is called
from the user command. If OPTION is not set in the header of a UDC or
command file then it's value will not be retained across calls to other
UDC/command files.
Operation Notes
The OPTION command modifies the environment of user-defined commands (UDCs) and
command files, giving users more flexibility in modifying the user command environment.
When OPTION appears in a user command header, it is static and affects the entire
command.
