IBM SC33-1683-02 User Manual

Page 601

Advertising
background image

You can change DYRLPROG on any call to the dynamic routing program, but it
is effective only when DYRFUNC is ‘0’ or ‘1’.

DYRNETNM

is the netname of the CICS region identified in DYRSYSID.

If the DYRNETNM value is changed by the initial invocation of the dynamic
routing program, CICS tries to route the request to the CICS region with the
new netname.

DYROPTER

specifies whether the dynamic routing program is to be reinvoked when the
routed transaction or link request terminates (successfully or unsuccessfully).
The possible values are:

N

The dynamic routing program is not to be reinvoked. This is the default.

Y

The dynamic routing program is to be reinvoked.

You can specify this option for transactions or link requests that are routed to
remote CICS regions and also for those that are executed locally.

DYRPROCCMP

is not used by the dynamic routing program. On invocation, it is set to nulls.

DYRPROCID

is not used by the dynamic routing program. On invocation, it is set to nulls.

DYRPROCN

is not used by the dynamic routing program. On invocation, it is set to nulls.

DYRPROCT

is not used by the dynamic routing program. On invocation, it is set to nulls.

DYRPRTY

can be used to set the dispatch priority of the task in the application-owning
region, if the connection between the terminal-owning region and
application-owning region is MRO.

Transaction routing

Before invoking the dynamic routing program, CICS sets this value to ‘0’
(zero).

Program-link requests

Before invoking the dynamic routing program, CICS sets this value to the
priority of the task that issued the program-link request.

On return from the initial invocation of the dynamic routing program, if the
DYRRTPRI value is ‘Y’ CICS passes the DYPPRTY value to the
application-owning region.

DYRQUEUE

identifies whether or not the request is to be queued if no sessions are
immediately available to the remote system identified by DYRSYSID. The
possible values are:

Y

The request is to be queued if necessary. This is the default.

N

The request is not to be queued.

DYRRETC

contains a return code that tells CICS how to proceed.

parameters passed to DFHDYP

Chapter 16. Writing a dynamic routing program

569

|
|

|

|

|

|
|

|
|

|
|

|
|

|

|
|
|

Advertising