ABAB gate, CREATE_ABEND_RECORD function

The CREATE_ABEND_RECORD function of the ABAB gate is used to create an abend record; that is, a trnasaction abend control block (TACB).

Input Parameters

ABEND_CODE
Optional parameter
The four-character transaction abend code.
ACCESS_REGISTERS
Optional parameter
The contents of the access registers at the time of a program check or operating system abend.
ALET
Optional parameter
The access list entry token (ALET) at the time of a program check or operating system abend.
ALL_FP_REGISTERS
Optional parameter
The contents of the floating point register values in the order 0 - 15 at the time of a program check or operating system abend.
BEAR
Optional parameter
The value of the breaking event address register (BEAR) at the time of a program check or operating system abend.
CURRENT_ACCESS_VALUES
Optional parameter
The current access register values are saved in the TACB.
CURRENT_FP_VALUES
Optional parameter
The current FP register values are saved in the TACB. If the task has not used the additional FP registers only the original FP registers are saved in the TACB. If any of the additional FP registers have been used by the task all the FP registers (0-15) and the FPC register are saved in the TACB.
CURRENT_VRR_VALUES
Optional parameter
The current vector register values are saved in the TACB.
ERROR_MESSAGE
Optional parameter
The error message sent from the remote system if the abend was raised by DFHZAND.
ERROR_OFFSET
Optional parameter
The offset of a program check or operating system abend in the failing application program or CICS(R) AP domain program.
EXECUTION_KEY
Optional parameter
A code that indicates the execution key at the time the abend was issued, or at the time the operating system abend or program check occurred.
FAILING_PROGRAM
Optional parameter
The name of the program in which the abend occurred.
FAILING_RESOURCE
Optional parameter
The name of the system TCTTE (the connection) if the abend was raised by DFHZAND.
FLOATING_POINT_REGISTERS
Optional parameter
The contents of the original floating point registers at the time of a program check or operating system abend.
FPC_REGISTER
Optional parameter
The value of the floating point control register at the time of a program check or operating system abend.
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. This is an alternative parameter to GENERAL_REGISTERS. If GENERAL64_REGISTERS is specified, you cannot use the H64G_REGISTERS parameter.
GREG_ORDER
Optional parameter
An indication of the order of the registers passed in the GENERAL_REGISTERS and GENERAL64_REGISTERS parameters. DFHSRP saves the registers in the abend record in the order 0 - 15, and INQUIRE_ABEND_RECORD always returns them in this order.
Values for the parameter are as follows:
  • R0TOR15
  • R14TOR13
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. If H64G_REGISTERS is specified, you cannot use the GENERAL64_REGISTERS parameter.
INTERRUPT_DATA
Optional parameter
The interrupt code, instruction length code, and other data at the time of a program check or operating system abend.
PSW|PSW16
Optional parameter
The contents of the program status word (PSW) or the 16 byte PSW at the time of a program check or operating system abend.
REMOTE_SYSTEM
Optional parameter
The name of the remote system if the abend was raised in the client transaction to reflect an abend occurring in the DPL server.
REQUEST_ID
Optional parameter
The request ID from the TCTTE for a terminal-oriented task.
SENSE_BYTES
Optional parameter
The SNA sense bytes if the abend was raised by DFHZAND.
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 as follows:
  • BASESPACE
  • NOSPACE
  • SUBSPACE
STATUS_FLAGS
Optional parameter
The status flags at the time of the abend.
STOKEN
Optional parameter
The subspace token (STOKEN) at the time of a program check or operating system abend.
STORAGE_TYPE
Optional parameter
A code that indicates the storage hit on an OC4 abend.
TEA
Optional parameter
The translation exception address at the time of a program check or operating system abend.
VECTOR_REGISTERS
Optional parameter
The contents of the vector registers at the time of a program check or operating system abend.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
ABEND_TOKEN
The token allocated by ABAB for this abend. The token must be passed on subsequent UPDATE_ABEND_RECORD and START_ABEND requests to ABAB. The token is no longer valid after a START_ABEND request.
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


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