Filter
Top Products
– The CICS Gateway for Java™
v Calls from external CICS interface (EXCI) client programs
v External Call Interface (ECI) calls from any of the CICS Client workstation
products
v Distributed Computing Environment (DCE) remote procedure calls (RPCs)
v ONC/RPC calls.
A program-link request received from outside CICS can be dynamically routed by:
v Defining the program to CICS Transaction Server for OS/390 as DYNAMIC(YES)
v Coding your dynamic routing program to route the request.
When the dynamic routing program is invoked
For eligible program-link requests, CICS invokes the dynamic routing program as
follows:
v Before the linked-to program is executed, to either:
– Obtain the SYSID of the region to which the link should be routed.
Note: The address of the caller’s communications area (COMMAREA) is
passed to the routing program, which can therefore route requests by
COMMAREA contents if this is appropriate.
– Notify the routing program of a statically-routed request. This occurs if the
program is defined as DYNAMIC(YES)—or is not defined—but the caller
specifies the name of a remote region on the SYSID option of the LINK
command.
In this case, specifying the target region explicitly takes precedence over any
SYSID returned by the dynamic routing program.
v If an error occurs in route selection—for example, if the SYSID returned by the
dynamic routing program is unavailable or unknown, or the link fails on the
specified target region—to provide an alternate SYSID. This process iterates until
either the program-link is successful or the return code from the dynamic routing
program is not equal to zero.
Special case—care!
If all the following are true, the route selection call fails
but the routing
program is not reinvoked for a route selection error
:
1. The program is not defined on the local region.
2. Program autoinstall is not active on the local region.
3. On the route selection call, the routing program routes the link request
to the local region.
Therefore, to dynamically route a program link request
that the routing
program may route locally
, you should do either of the following:
1. Install a program definition on the local region, specifying
DYNAMIC(YES).
2. Set program autoinstall active, using it to install a definition that
specifies DYNAMIC(YES).
v After the link request has completed, if reinvocation was requested by the routing
program.
dynamic routing of DPL requests
558
CICS TS for OS/390: CICS Customization Guide
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
||
|
|
|