IBM SC33-1683-02 User Manual

Page 619

Advertising
background image

This field applies only to the routing of BTS processes and activities,

not to the

routing of non-terminal-related START requests.

DYRACTN

is the name of the BTS activity being routed. (When a process is being routed,
DYRACTN returns the name of the root activity—that is, DFHROOT.)

This field applies only to the routing of BTS processes and activities,

not to the

routing of non-terminal-related START requests.

DYRBLGTH

is not used by the distributed routing program. On invocation, it is set to zeroes.

DYRBPNTR

is not used by the distributed routing program. On invocation, it is set to zeroes.

DYRCABP

indicates whether or not you want CICS to continue standard abend processing.

This field is not used by the distributed routing program. On invocation, it is set
to 'Y'.

DYRCOMP

is the CICS component code. For calls to the distributed routing program, it is
always set to 'SH'.

DYRCOUNT

is a count of the times the distributed routing program has been invoked for this
request with DYRFUNC set to ‘0’, ‘1’, or ‘3’. This field allows you to limit the
number of times your program tries to route a request.

DYRDTRRJ

indicates whether the transaction, which is defined by the common transaction
definition specified on the DTRTRAN system initialization parameter, is to be
rejected, or accepted for processing.

This field is not used by the distributed routing program. On invocation, it is set
to 'N'.

DYRDTRXN

indicates whether the transaction to be routed is defined by the common
transaction definition specified on the DTRTRAN system initialization parameter,
or by a specific transaction definition.

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

parameters passed to DFHDSRP

Chapter 17. Writing a distributed routing program

587

|
|

|
|
|

|
|

|
|

|
|

|
|

|
|

|
|
|

|
|
|
|

|
|
|
|

|
|

|
|
|
|

|
|

|
|
|

||

||

||

||
|

|
|

Advertising