ABAB gate, START_ABEND function

The START_ABEND function of the ABAB gate is used to start transaction abend processing.

Input Parameters

ABEND_TOKEN
is the token allocated by ABAB for this abend (on a preceding CREATE_ABEND_RECORD request).
DUMP
Optional parameter
indicates whether a transaction dump should be produced for this abend.
Values for the parameter are:
  • NO
  • YES
IGNORE_HANDLES
Optional parameter
indicates whether this abend should be passed to any EXEC CICS HANDLE routines that are active. IGNORE_HANDLES(YES) results in EXEC CICS HANDLE being ignored at all levels of the program stack.
Values for the parameter are:
  • NO
  • YES

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
The following values are returned when RESPONSE is EXCEPTION:
  • INVALID_TOKEN
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
RETRY_ADDRESS
If an XPCTA exit requests retry, control returns to the point of invocation of start_abend, passing the retry address. This address includes the AMODE indicator in the first bit; it can be used as the target address in a DFHAM TYPE=BRANCH by the caller of START_ABEND GENERAL_REGISTERS is also set to point to the list of registers to be used for the retry, and SPACE to indicate the subspace. START_ABEND GENERAL64_REGISTERS and H64G_REGISTERS are also set to point to the list of registers to be used for the retry if this information is available.
GENERAL_REGISTERS
Optional parameter
The contents of the general purpose registers at the time of a program check or operating system abend.
GENERAL64_REGISTERS
Optional parameter
The contents of the 64-bit general purpose registers at the time of a program check or operating system abend.
H64G_REGISTERS
Optional parameter
The contents of the high order words of the 64-bit general purpose registers at the time of a program check or operating system abend.
SPACE
Optional parameter
An indication whether the task was in SUBSPACE or BASESPACE mode at the time of a program check or operating system abend.
Values for the parameter are:
  • BASESPACE
  • NOSPACE
  • SUBSPACE


dfhs3_ABABstart_abend.html | Timestamp icon Last updated: Monday, 5 June 2017