APRT gate, ROUTE_TRANSACTION function
The ROUTE_TRANSACTION function of the APRT gate is used to dynamically route transactions (which are defined to be dynamic and not automatically initiated) based on decisions made by the dynamic transaction routing program. For transactions which are automatically initiated or are defined to be remote and not dynamic, DFHAPRT will statically route such transactions.
Input Parameters
- DTRTRAN
- indicates whether or not dynamic transaction routing is available.
- Values for the parameter are:
- NO
- YES
- DYNAMIC
- indicates whether or not the transaction is defined as dynamic.
- Values for the parameter are:
- NO
- YES
- REMOTE
- indicates whether or not the transaction is defined as remote.
- Values for the parameter are:
- NO
- YES
- REMOTE_NAME
- is the four-character transaction identifier by which this transaction is to be known on the remote CICS region.
- REMOTE_SYSTEM
- is the name of the remote system if the abend was raised in the client transaction to reflect an abend occurring in the DPL server.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- LOOP
- The following values are returned when RESPONSE is EXCEPTION:
- ALL_SESSIONS_BUSY
- DTRTRAN_REJECTED
- ISC_DISABLED
- NOTAUTH
- PROGRAM_NOT_FOUND
- REMOTE_CONN_OOS
- REMOTE_CONN_OOS_SYS_CHGD
- ROUTE_FAILED
- TRANSACTION_ABEND
- ABEND_CODE
- is the four-character transaction abend code.
- RAN_LOCALLY
- indicates whether or not the transaction ran on the local CICS region (that is, was not routed to a remote CICS region).
- Values for the parameter are:
- NO
- YES
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.