Filter
Top Products
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 inbound Web service requests, DYRSYSID contains:
- The CICS region name specified on the REMOTESYSTEM option of
the installed transaction definition (for the transaction named in the
DFHWS-TRANID container); or,
- If REMOTESYSTEM is not specified, the system name of the local
CICS region.
– For enterprise beans and CORBA stateless objects, DYRSYSID
contains:
- The CICS region name specified on the REMOTESYSTEM option of
the installed transaction definition (for the transaction specified on the
REQUESTMODEL 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.)
v When DYRFUNC is set to 5 (transaction initiation), DYRSYSID contains the
name of the target region on which the routed request is to be executed.
(This is also the region on which the distributed routing program is invoked.)
v When DYRFUNC is set to 6 (routing completed), DYRSYSID contains the
name of the target region to which CICS tried (successfully or
unsuccessfully) to route the request.
DYRTRAN
contains the transaction name.
654 Customization Guide