BDTXASRV

BDTXASRV invokes abend services during abend recovery processing. This service must be invoked as part of abend recovery processing so that a task can continue to run. Abend services cannot clean up after a task. It is the responsibility of the abending task to properly release all acquired resources. Failure to do so can seriously impact the proper functioning of BDT. Abend services are only available to functions running in the BDT address space.

&label  BDTXASRV      &TYPE=  {EXIT }
                              {RETRY}
                      ,&GSD=
                      ,&SDWA=
                      ,&SAPURGE= (R13)
                      ,&NORMAL=
                      ,&RESTART= *
                      ,&TERM= *,
                      ,&RCVMOD= BDTABMN
                      ,&RCVLABEL= BDTABMN

Parameter	Subparameter	Explanation
&label		Optional label associated with the first instruction generated by the BDTXASRV macro.
&TYPE=		Specifies whether abend services is being invoked for ESTAE exit routine processing (TYPE=EXIT), or for ESTAE retry routine services (TYPE=RETRY). For proper recovery, the ESTAE exit routine should issue this macro with TYPE=EXIT, which records the abend environment and issues an SVC dump if necessary, then issue this macro a second time in the retry routine, which performs general cleanup and provides a BDT formatted dump, if necessary.
&GSD=		Specifies the address of the generalized subtask directory (GSD) for the task for which abend services is invoked.
&SDWA=		Specifies the address of the system diagnostic work area (SDWA).
&SAPURGE=		Specifies the address of the lowest save area to be retained for the function following abend services processing. Abend services frees all save areas below the specified save area. This ensures that BDT save areas trapped by an abend will not be permanently lost. The default address is in register 13.
&NORMAL=		Specifies the exit to be taken if normal abend recovery is permitted. The normal exit address may be contained in a register. If this exit receives control, the function may recover from the abend and resume processing. The function must ensure that the environment is left with all data sets closed, all system acquired resources returned to the system.
&RESTART=		Specifies the exit to be taken if the operator requests that the executing function be canceled and subsequently restarted. The restart address may be contained in a register. If the exit receives control, the function must perform any required clean-up. The function must then return to the address 4 bytes past the address contained in TVT JSSRT. This applies to functions running under control of DAPs only (i.e. jobs), not resident functions. Resident functions should specify the same address for RESTART and TERM, and proceed as for TERM. This parameter is required if TYPE=RESTART is coded.
&TERM=		Specifies the exit be taken if recovery from the abend is not possible. The termination exit address may be contained in a register. If this exit receives control, the function must perform any required clean-up operations and exit. This parameter is required if TYPE=RESTART is coded.
&RVCMOD=		Specifies the name of the recovery routine (ESTAE) that issues the BDTXASRV macro. The default is BDTABMN.
&RCVLABEL=		Specifies the name of the recovery routine (ESTAE exit) label that issues the BDTXASRV macro. The default is BDTABMN.