Previous Topic: FormatNext Topic: OUTPUT Command


Operands

The OPTION command has the following operands:

Operand

Explanation

ERROR, label

Indicates a label at which program execution will continue in case an ACL/E processing error occurs. At the label you can:

Issue the RESUME command to resume execution of the program.

Terminate execution of the program.

Perform other ACL/E processing.

When this operand is used, the variable &ERR_RC is set with the return code of the error, and the variable &ERR_MSG is set with the text of the error message.

FLOW,ON|OFF

Indicates whether or not the ACL/E program records the sequence of executed commands in the message log. The default is OFF, which prevents commands from being recorded in the log.

IMAGE,APPL|APPL_NOSEND

IMAGE,APPL indicates that an alternate image is to be removed from the screen and the application image redisplayed. IMAGE,APPL_NOSEND removes the alternate image, but does not redisplay the application image.

MAXI,n|50

Indicates the total number of statements (n) that can be executed by an ACL/E program. The default is 50. You can specify an integer between zero and 64,000.

KEYERR,ON|OFF

Indicates whether or not the ACL/E program terminates if an error occurs when the program is keying data into an input field. The default is ON, which causes the program to terminate. This operand exists for compatibility with earlier versions of ACL/E, and it is recommended that the ERROR operand be used. KEYERR, OFF overrides the OPTION,ERROR command if a -KEY-OPERATION ENCOUNTERED AN OUT-OF-BOUNDS CONDITION error occurs.

TERM,ON|OFF

Indicates whether or not the application data is sent to the terminal during ACL/E program execution. The default is OFF, which prevents data from being sent.

TIME=N,label

Indicates a time-out value for ACL/E processing. If no activity occurs for the time-out period, the program resumes at the statement marked with the label. N specifies the time-out period in seconds. A value of OFF prevents the program from timing out.

TIME,OFF

Prevents the program from timing out.

RESIDENT,ON|OFF

Indicates whether or not the ACL/E program remains in storage after the program ends. The default is OFF, which prevents the program from being stored.