General
Application areas: | Starting, interrupting and terminating; see "Starting, interrupting and terminating" |
Macro type: | Type S, MF format 1: standard/L/E form; see "S-type macros" |
Program interrupts can be processed with STXIT routines. They run as separate processes (and have their own PCB and processing level).
No return code relating to the execution of the EXIT macro is transferred.
Macro description
The EXIT macro terminates an STXIT process.
The user may specify whether another STXIT routine assigned to the same event class is to be activated; if this is not the case, the interrupted process is continued or the program is terminated.
Notes
If the STXIT routine is assigned to the “ABEND” or “normal program termination” event class, the program is terminated by the system after the EXIT macro, provided that all the STXIT routines for these STXIT event classes have been executed (if CONTINU=YES) and the event (e.g. LOGOFF(ABEND)) has been terminated by the system.
An STXIT routine assigned to the “end of the program runtime” event class should be terminated with the TERM macro.
Macro format and description of operands
EXIT |
CONTINU=YES / NO / STD ,TERM={NO / (PRGR[,DUMP] ,NORMAL]) / (STEP[,DUMP] [,NORMAL])} [,MF=L / (E,..)] |
CONTINU=
Defines whether another STXIT routine of the same event class is to be started.
YES
Another STXIT routine is started.
NO
No other STXIT routine is started.
STD
This option normally corresponds to CONTINU=YES. It has a different meaning only if all of the following three conditions are fulfilled:
the STXIT class is 'PROGRAM CHECK' or 'UNRECOVERABLE PROGRAM ERROR',
all previous STXIT routines of this STXIT class have terminated with CONTINU=STD, and
there are no more STXIT routines of the same STXIT class.
In this case the program is resumed as if these STXIT routines had never existed, i.e. the error recovery envisaged for the fault which has occurred is started.
TERM=
Specifies whether the program is to be terminated (if no other STXIT routines of the same STXIT event class are activated in the program).
NO
The program is not to be terminated.
(PRGR[,DUMP][,NORMAL])
The program is to be terminated.
If DUMP is specified, a user dump is also output.
If NORMAL is specified, the program is terminated normally.
Default setting is ABNORMAL, i.e. the program is terminated abnormally.
(STEP[,DUMP][,NORMAL])
In an interactive task, the program is terminated.
In a batch task, the program additionally branches to the next SET-JOB-STEP, or EXIT-JOB command.
If DUMP is specified, a user dump is also output. If NORMAL is specified, the program is terminated normally.
Default setting is ABNORMAL, i.e. the program is terminated abnormally.)
MF=
For a general description of the MF operand, its operand values and any subsequent operands (e.g. for a prefix), see "S-type macros". The valid MF values are given at the start of the macro description under “Macro type” and are included in the macro format.
For an example, see section “STXIT procedure with contingency processing”.