IBM SC34-6814-04 - Manual (Page 675)

DYRPROCT
is the process-type of the BTS process to which the process or activity being
routed belongs.
This field applies only to the routing of BTS processes and activities.
DYRPRTY
is not used by the distributed routing program. On invocation, it is set to zeroes.
DYRQUEUE
identifies whether or not the request is to be queued if no sessions are
immediately available to the remote system identified by DYRSYSID.
This field is not used by the distributed routing program. On invocation, it is set
to 'Y'.
DYRRETC
contains a return code that tells CICS how to proceed. The possible values are:
0 Route the request.
Non-zero
Do not route the request. CICS treats requests for BTS processes and
activities as unserviceable (see the description of unserviceable
requests in “If an error occurs in route selection” on page 628). START
requests receive the SYSIDERR condition. Method requests for
enterprise beans and CORBA stateless objects receive an exception.
Whenever the routing program is invoked, DYRRETC is set to 0. When it is
invoked for route selection or because an error occurs in route selection, if you
want CICS to route the request to the region specified in the DYRSYSID field,
you must leave it set to 0.
You do not need to set a return code when the routing program is invoked for
notification, routing complete, transaction initiation, transaction termination, or
abend. (Any code you set is ignored by CICS.)
DYRRTPRI
indicates whether or not the dispatch priority of the transaction should be
passed to the application-owning region, if the connection between the
terminal-owning region and the application-owning region is MRO.
This field is not used by the distributed routing program. On invocation, it is set
to 'N'.
DYRSRCTK
is the MVS workload management service and reporting class token for the
routed transaction. Your routing program should not alter this value, which is set
by CICS and used by CICSPlex SM.
Note: For non-terminal-related START requests, this field is set to zeroes. Do
not change it.
DYRSYSID
is the system identifier (sysid) of a CICS region. The exact meaning of this
parameter depends on the value of DYRFUNC:
v When DYRFUNC is set to 0 (route selection), DYRSYSID contains:
– The CICS region name specified on the REMOTESYSTEM option of the
installed transaction definition, or,
– If REMOTESYSTEM is not specified, the system name of the local CICS
region.
Chapter 18. Writing a distributed routing program 653