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 may 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
-231 to +231-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 -231 to +231-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.
[ Top of Page | Previous Page | Next Page | Contents | Index ]