Use the CONTROL statement to define processing options for a CLIST. The options are in effect from the time CONTROL executes until either the CLIST terminates or it issues another CONTROL statement.

CLISTs that do not issue CONTROL statements or one of the above variables execute with the following options: NOPROMPT, NOSYMLIST, NOLIST, NOCONLIST, CAPS, MSG, and FLUSH. The user can set PROMPT and LIST by entering them as keywords on the EXEC command or subcommand issued to invoke the CLIST.

CONTROL has no default operands. If you enter CONTROL with no operands, the system uses options already defined by system default, the EXEC command, or a previous CONTROL statement. In addition, when there are no operands specified, the system displays those options currently in effect.

>>-+--------+--CONTROL--+----------+--+-----------+------------->
   '-label:-'           +-PROMPT---+  +-SYMLIST---+   
                        '-NOPROMPT-'  '-NOSYMLIST-'   

>--+--------+--+-----------+--+--------+--+-------+------------->
   +-LIST---+  +-CONLIST---+  +-CAPS---+  +-MSG---+   
   '-NOLIST-'  '-NOCONLIST-'  +-NOCAPS-+  '-NOMSG-'   
                              '-ASIS---'              

>--+---------+--+------+--+-------------+----------------------><
   +-FLUSH---+  '-MAIN-'  '-END(string)-'   
   '-NOFLUSH-'                              

label

A name the CLIST can reference in a GOTO statement to branch to this CONTROL statement. label is one-to-31 alphanumeric characters, beginning with an alphabetic character.

PROMPT |NOPROMPT

PROMPT

TSO/E commands in the CLIST may prompt the terminal for input. (The PROMPT operand on the PROFILE command must also be in effect.)

NOPROMPT

TSO/E commands in the CLIST may not prompt the terminal for input.

SYMLIST | NOSYMLIST

SYMLIST

Each executable statement is displayed at the terminal before it is scanned for symbolic substitution. Executable statements include commands, subcommands, and CLIST statements.

NOSYMLIST

Executable statements are not displayed at the terminal before symbolic substitution.

LIST | NOLIST

LIST

Commands and subcommands are displayed at the terminal after symbolic substitution but before execution.

NOLIST

Commands and subcommands are not displayed at the terminal.

CONLIST | NOCONLIST

CONLIST

CLIST statements are displayed at the terminal after symbolic substitution but before execution.

NOCONLIST

CLIST statements are not displayed at the terminal after symbolic substitution.

CAPS | NOCAPS | ASIS

CAPS

Character strings are converted to uppercase letters before being processed.

NOCAPS or ASIS

Character strings are not converted to uppercase before being processed.

MSG | NOMSG

MSG

Informational messages from commands and statements in the CLIST are displayed at the terminal.

NOMSG

Informational messages from commands and statements in the CLIST are not displayed at the terminal.

FLUSH | NOFLUSH

FLUSH

The system can erase (flush) the queue of nested CLISTs called the input stack unless NOFLUSH or MAIN is encountered. The system normally flushes the stack when an execution error occurs.

NOFLUSH

The system cannot flush the CLIST when an error occurs.

Note: To protect a CLIST from being flushed, the CLIST must contain an error routine.

MAIN

This is the main CLIST in your TSO/E environment and cannot be deleted by a stack flush request from the system. When MAIN is specified, the NOFLUSH condition is assumed for this CLIST, regardless of whether FLUSH was in effect. This operand is required for CLISTs containing attention routines that do anything other than terminate the CLIST.

END(string)

A character string recognized by the CLIST as a replacement for an END statement that concludes a DO or SELECT statement, or a subprocedure. string is 1-4 alphanumeric characters, beginning with an alphabetic character.