6 Invoked because CICS has finished trying (successfully or
unsuccessfully) to route the request to the target region.
This invocation occurs on the routing region. It signals that (unless the
routing region and the target region are one and the same) the routing
regions responsibility for this transaction has been discharged. The
routing program might, for example, use this invocation to release any
resources that it has acquired on behalf of the transaction.
The DYRTYPE field tells you the type of routing or notification request.
DYRLEVEL
is the level of CICS required in the target AOR to successfully process the
routed request. The possible values are:
X'00' Any currently-supported version of CICS is able to process the request.
X'01' CICS TS for z/OS, Version 2.2. This value may be set only for method
requests for enterprise beans and CORBA stateless objects.
X'02' CICS TS for z/OS, Version 2.3. This value may be set only for method
requests for enterprise beans and CORBA stateless objects.
X'03' CICS TS for z/OS, Version 3.1. This value may be set for:
v DPL requests that have a channel associated with them.
Note: The routing of DPL requests is handled by the dynamic
routing program.
v START requests that have a channel associated with them.
v Inbound web services requests.
v Method requests for enterprise beans and CORBA stateless objects.
X'04' CICS TS for z/OS, Version 3.2.
Note that values greater than X'00' indicate the specific, not the minimum, level
of CICS required to process the request successfully.
This parameter is a migration aid, intended to help you perform a rolling
upgrade of a multi-region logical server, whereby one region at a time is
upgraded from one release of CICS to the next, without bringing down the
server. Requests that require a specific level of CICS can be routed to an
appropriate AOR.
Note:
1. This mixed level of operation, in which different CICS regions in the
same logical server are at different levels of CICS, is intended to be
used only for rolling upgrades. It should not be used permanently,
because it increases the risk of failure in some interoperability
scenarios. The normal, recommended, mode of operation is that all
the regions in a logical sever should be at the same level of CICS
and Java.
2. Do not attempt to use the DYRLEVEL field until you have read the
definitive information about upgrading CICS EJB/CORBA servers in
the Java Applications in CICS.
DYRLPROG
is not used by the distributed routing program. On invocation, it is set to null
characters.
Chapter 18. Writing a distributed routing program 651