HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 5 Command Definitions L-O

OPTION

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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.

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

Feedback to webmaster