IBM SC33-1683-02 User Manual

Page 599

Advertising
background image

For an explanation of the DTRTRAN system initialization parameter, see the
CICS System Definition Guide.

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. This occurs if the
routing program tries to:

1. Route a transaction initiated by an EXEC CICS START command to

a pre-CICS TS Release 3 region, or to a CICS TS Release 3
region that is not connected by an MRO or APPC parallel-session
link.

2. Route a program-link request across an LU6.1 connection.

The following values all apply to attempts to route program-link requests. For
the meanings of these error conditions, see the

CICS Application Programming

Reference manual.

6

The EXEC CICS LINK command returned LENGERR.

7

The EXEC CICS LINK command returned PGMIDERR.

8

The EXEC CICS LINK command returned INVREQ.

9

The EXEC CICS LINK command returned NOTAUTH.

A

The EXEC CICS LINK command returned TERMERR.

B

The EXEC CICS LINK command returned ROLLEDBACK.

DYRFUNC

tells you the reason for this invocation of the dynamic routing program. The
possible values are:

0

Invoked for route selection.

1

Invoked because an error occurred in route selection.

parameters passed to DFHDYP

Chapter 16. Writing a dynamic routing program

567

|

||
|

|
|
|
|

|

|
|
|

||

||

||

||

||

||

|

Advertising