EXITCTL instruction

The EXITCTL instruction sets or modifies the contents of the four signed fullword exit-control parameters that the assembler maintains for each type of exit.


>>-+-----------------+--EXITCTL--------------------------------->
   '-sequence_symbol-'            

             .--------------------------.   
             V                      (1) |   
>--exit_type---,--+---------------+-----+----------------------><
                  '-control_value-'

Notes:

From one to four values to be supplied.

sequence_symbol

Is a sequence symbol.

exit_type

Identifies the type of exit to which this EXITCTL instruction applies. Exit_type must have one of the following values:

SOURCE: Sets the exit-control parameters for the user-supplied exit module specified in the INEXIT suboption of the EXIT assembler option.
LIBRARY: Sets the exit-control parameters for the user-supplied exit module specified in the LIBEXIT suboption of the EXIT assembler option.
LISTING: Sets the exit-control parameters for the user-supplied exit module specified in the PRTEXIT suboption of the EXIT assembler option.
PUNCH: Sets the exit-control parameters for the user-supplied exit module specified in the OBJEXIT suboption of the EXIT assembler option when it is called to process the object module records generated when the DECK assembler option is specified.
OBJECT (z/OS and CMS): Sets the exit-control parameters for the user-supplied exit module specified in the OBJEXIT suboption of the EXIT assembler option when it is called to process the object module records generated when the OBJECT or GOFF assembler option is specified.
ADATA: Sets the exit-control parameters for the user-supplied exit module specified in the ADEXIT suboption of the EXIT assembler option.
TERM: Sets the exit-control parameters for the user-supplied exit module specified in the TRMEXIT suboption of the EXIT assembler option.

control_value

Is the value to which the corresponding exit-control parameter should be set. For each exit type, the assembler maintains four exit-control parameters known as EXITCTL_1, EXITCTL_2, EXITCTL_3, and EXITCTL_4. Therefore, up to four values can be specified. Which exit-control parameter is set is determined by the position of the value in the operand of the instruction. You must code a comma in the operand for each omitted value. If specified, control_value must be either:

A decimal self-defining term with a value in the range -2³¹ to +2³¹-1.
An expression in the form *±n, where * is the current value of the corresponding exit-control parameter to which n, a decimal self-defining term, is added or from which n is subtracted. The value of the result of adding n to or subtracting n from the current exit-control parameter value must be in the range -2³¹ to +2³¹-1.

If control_value is omitted, the corresponding exit-control parameter retains its current value.

The following example shows how to set the exit-control parameters EXITCTL_1 and EXITCTL_3 for the LISTING exit without affecting the contents of the other exit-control parameters:

         EXITCTL LISTING,256,,*+128

See the section "EXITCTLn" in the HLASM Programmer's Guide for information about how EXITCTL values are passed to each type of exit.

The assembler initializes all exit-control parameters to binary zeros.