HP 3000 Manuals

MPE/iX Commands Reference Manual Volume I

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  }] [,] [{RECURSION  }]
       [{NOLIST}]     [{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.

The LIST/NOLIST option specifies whether command lines in a UDC are
printed before execution of each command.  RECURSION/ NORECURSION
determines the search order for commands cataloged.

RECURSION starts the UDC search at the beginning of the cataloged
commands.  NORECURSION, the default setting, starts the search at the
command currently executing.  RECURSION and NORECURSION do not have any
meaning in a command file, because command files are not cataloged.  The
default is NORECURSION.

Nesting of IF and WHILE blocks in UDC's is limited to a combined total of
30 levels.  Each IF or WHILE block read by the Command Interpreter
increments the nesting count even if it resides within a different UDC.
It is especially important to remember this when using the recursion 
option which may make it easy to increment the nesting count beyond 30.

Use 

This command is available in a session, job, program, or in BREAK.
Pressing Break has no effect on this command.

Example 

To send a line-by-line listing of the command file to $STDLIST as it
executes, within the command file, enter:

     OPTION LIST 

Related Information 

Commands      SETCATALOG, SHOWCATALOG, UDC header for static options

Manuals       None

MPE/iX 5.0 Documentation