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

This field is not used by the distributed routing program. On invocation, it is set
to 'N'.
DYRERROR
has a value only when DYRFUNC is set to 1. It indicates the type of error that
occurred during the last attempt at route selection. The possible values are:
0 The selected sysid is unknown.
1 The selected system is not in service.
2 The selected system is in service, but no sessions are available.
3 An allocate request has been rejected, and SYSIDERR returned to the
application program. This error occurs for one of the following reasons:
1. An XZIQUE global user exit program requested that the allocate be
rejected, or
2. CICS rejected the allocate request automatically because the
QUEUELIMIT value specified on the CONNECTION resource
definition has been reached.
4 A queue of allocate requests has been purged, and SYSIDERR
returned to all the waiting application programs. This error occurs for
one of the following reasons:
1. An XZIQUE global user exit program requested that the queue be
purged, or
2. CICS purged the queue automatically because the MAXQTIME limit
specified on the CONNECTION resource definition has been
reached.
5 The selected system does not support this function.
For BTS processes and activities and non-terminal-related START
requests, this error occurs if the distributed routing program tries to
route a request to a region that is not connected by an MRO or APPC
parallel-session link.
For method requests for enterprise beans and CORBA stateless
objects, this error occurs if the distributed routing program tries to route
a request to a region that is not connected by an MRO link.
For inbound Web services requests, this error occurs if the distributed
routing program tries to route a request to a pre-CICS TS for z/OS,
Version 3.1 region.
The next six values all apply to attempts to route START requests. For the
meanings of these error conditions, see the CICS Application Programming
Reference manual.
6 The EXEC CICS START command returned LENGERR.
8 The EXEC CICS START command returned INVREQ.
9 The EXEC CICS START command returned NOTAUTH.
C The EXEC CICS START command returned TRANSIDERR.
D The EXEC CICS START command returned IOERR.
E The EXEC CICS START command returned USERIDERR.
F An XPCERES or XICERES global user exit program on the target
region has set a return code of UERCRESU, meaning that a required
Chapter 18. Writing a distributed routing program 649