CICS_EPI_EVENT_END_TRAN

Purpose

The CICS_EPI_EVENT_END_TRAN event indicates the end of a transaction that was running against a terminal resource. If the transaction failed, the EndReason and EndReturnCode specify the cause. If the transaction completed normally, the EndReason field is set to CICS_EPI_TRAN_NO_ERROR and EndReturnCode is set to CICS_EPI_NORMAL. If the transaction was pseudoconversational, the TransId field contains the name of the next transaction required. The application should start this transaction by issuing a CICS_EpiStartTran call.

The CICS_EPI_EVENT_END_TRAN event occurs when a transaction running against a terminal resource abends or ends following execution of a RETURN command for which the IMMEDIATE option was not specified.

Fields completed

Event
The CICS_EPI_EVENT_END_TRAN event code.
EndReason
An indication of what caused the end transaction event. It can be one of the following values:
CICS_EPI_TRAN_NO_ERROR
Normal transaction termination.
CICS_EPI_TRAN_NOT_STARTED
The transaction failed to start.
CICS_EPI_TRAN_STATE_UNKNOWN
The transaction failed to complete.
CICS_EPI_READTIMEOUT_EXPIRED
The read timeout expired.
TransId
The name of the next transaction to start, if the previous transaction was pseudoconversational. This name is 4 characters long and null-terminated. If there is no next transaction, the field is set to nulls.
EndReturnCode
A string containing the CICS_EPI_returncode.