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.