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.


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