N The transaction is not rejected.
This indicator is always set to the reject condition when the dynamic routing
program is invoked. To dynamically route a transaction defined by the
DTRTRAN definition, you must change this to the accept condition.
If you reject the transaction, message DFHAC2001—“Transaction ‘tranid’ is
unrecognized”—is sent to the user’s terminal for dynamic transaction routing.
For Link3270 requests, the BRIH returned to the client will contain a return code
indicating that the transaction was not found, and a compcode indicating that
the routing program rejected the transaction specified on the DTRTRAN system
initialization parameter.
DYRDTRXN
indicates whether the transaction to be routed is defined by the common
transaction definition specified on the DTRTRAN system initialization parameter,
or by a specific transaction definition.
This field applies only to dynamic transaction routing and Link3270 requests
(not to the routing of program-link requests).
The possible values are:
Y The transaction is defined by the definition specified by the system
initialization parameter DTRTRAN. That is, there is no resource
definition for the input transaction identifier (id).
For dynamic transaction routing, the transaction is initiated in the
terminal-owning region using the transaction id specified by the system
initialization parameter, DTRTRAN.
For dynamic transaction routing, the input transaction id is passed to
the dynamic routing program in the DYRTRAN field. For Link3270
requests the common transaction definition is used to determine the
routing characteristics of the request. The request still contains the
original transaction id, not the common transaction id. If the request is
run locally, the request is passed to the driver successfully, but the
driver will fail to start the user transaction as it is not defined.
N The transaction is not defined by the definition specified by the system
initialization parameter, DTRTRAN. There is an installed resource
definition for the input transaction id.
For dynamic transaction routing, the transaction is initiated in the
terminal-owning region using the input transaction id. The transaction id
passed to the dynamic routing program in the DYRTRAN field is the
remote transaction id from the transaction resource definition (if this is
different from the input transaction id).
For Link3270 requests, the transaction id passed to the routing program
in the DYRTRAN field is the remote transaction id defined in the
TRANSACTION resource definition.
For an explanation of the DTRTRAN system initialization parameter, see the CICS
System Definition Guide.
DYRERROR
has a value only when DYRFUNC is set to ‘1’. It indicates the type of error that
occurred during the last attempt at route selection. The possible values are:
0 The selected sysid is unknown.
1 The selected system is not in service.
612 Customization Guide