under the DYRTYPE parameter the value X'4' is not listed because it is never
passed to the distributed routing programit occurs only on a program-link-related
call to the dynamic routing program.
If you use the same program as both a distributed routing program and a dynamic
routing program, for descriptions of the parameters and values that are significant
on dynamic routing calls refer to “Parameters passed to the dynamic routing
program” on page 607.
DYRABCDE
is the abend code returned when the transaction associated with a routed
request abends in the target region.
This field is significant when the distributed routing program is invoked for
termination of a routed request. Any value other than blanks indicates that the
transaction has abended in the target region (which, for the distributed routing
program, is also the region in which the routing program is invoked).
For method requests for enterprise beans and CORBA stateless objects, an
abend code of 'AIID' indicates that the target CorbaServer is disabled in the
target region. For specific information about coding a routing program to handle
a disabled CorbaServer, see “Dealing with a disabled CorbaServer” on page
635.
For general information about how to handle other types of abend, see “Dealing
with an abend on the target region” on page 644.
DYRABNLC
is an abnormal event code, or null.
This field is significant when the distributed routing program is invoked for
termination of a routed request. Any value other than null indicates that an
abnormal event, other than a transaction abend, has occurred in the region to
which the request was routed (which, for the distributed routing program, is also
the region in which the routing program is invoked). Your routing program
should not route further requests to the same region until the cause of the error
has been investigated and rectified.
This field is intended for use by CICSPlex System Manager. Currently, it is set
only by DB2. For more information, see the CICS DB2 Guide.
DYRACMAA
is not used by the distributed routing program. On invocation, it is set to zeroes.
DYRACMAL
is not used by the distributed routing program. On invocation, it is set to zeroes.
DYRACTCMP
indicates whether or not the BTS activity is completing. (When a process is
being routed, DYRACTCMP indicates whether the root activity is completing.)
This field applies only to the routing of BTS processes and activities. Its
contents are significant on transaction termination calls.
The possible values are:
Y This is the final activation of the BTS activity.
N This is not the final activation of the BTS activity.
Chapter 18. Writing a distributed routing program 647