IBM SC33-1683-02 Server User Manual


 
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.
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.
The distributed routing program can accept the value of DYRSYSID or
change it before returning to CICS.
If the sysid you return to CICS is the same as the local sysid, CICS executes
the request on the local region.
v When DYRFUNC is set to ‘1’ (route selection error), DYRSYSID contains the
CICS region name returned to CICS by the distributed routing program on its
previous invocation. If you want CICS to retry routing, you must change
DYRSYSID before returning to CICS.
v When DYRFUNC is set to ‘2’ (termination of a routed request), DYRSYSID
contains the name of the target region on which the completed transaction
executed. (This is also the region on which the distributed routing program is
invoked.)
v When DYRFUNC is set to ‘3’ (notification):
For BTS processes and activities, 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.
For non-terminal-related START requests, DYRSYSID contains:
- The remote CICS region name specified on the SYSID option of the
EXEC CICS START command, or
- If SYSID is not specified, the remote 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.
Any change to the value of DYRSYSID is ignored.
v When DYRFUNC is set to ‘4’ (transaction abend), DYRSYSID contains the
name of the target region on which the transaction abended. (This is also the
region on which the distributed routing program is invoked.)
parameters passed to DFHDSRP
Chapter 17. Writing a distributed routing program 591
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|