Defining remote resources for DPL

You may have to define remote server programs if you are using CICS® DPL. A remote server program is a program that resides on another CICS system. CICS program-control LINK requests that are made against a remote program are shipped to the remote system by means of CICS DPL.

Defining remote server programs

A remote server program can be defined using the CEDA transaction. Figure 57 shows the program attributes that you need to specify. How you specify the attributes depends on whether DPL requests for the program are to be routed to the remote region statically or dynamically.

Figure 57. Defining a remote program (DPL)
DEFINE
   PROGRAM(name)
   GROUP(.....)
   DESCRIPTION(......)
 Remote Attributes
   REMOTESYSTEM(name)
   REMOTENAME(name)
   TRANSID(name)
   DYNAMIC(NO|YES)

The name of the remote system

To route DPL requests for the program statically:

An EXEC CICS LINK command that names the program is shipped to the server region named on the REMOTESYSTEM option.

To route DPL requests for the program dynamically:

An EXEC CICS LINK command that names the program causes the dynamic routing program to be invoked. The routing program can select the server region to which the request is shipped.

Program names

The name by which the server program is known on the local CICS system is specified in the PROGRAM option. This is the name that is used in LINK requests by client programs in the local system.

The name by which the server program is known on the remote CICS system is specified in the REMOTENAME option. This is the name that is used in LINK requests that are shipped by CICS to the remote system.

If the name of the server program is to be the same on both the local and the remote systems, the REMOTENAME option need not be specified.

Transaction names

It is possible to use the program resource definition to specify the name of the mirror transaction under which the program, when used as a DPL server, is to run. The TRANSID option is used for this purpose.

For dynamic requests that are routed using the CICSPlex® System Manager (CICSPlex SM), the TRANSID option takes on a special significance, because CICSPlex SM’s routing logic is transaction-based. CICSPlex SM routes each DPL request according to the rules specified for its associated transaction.

Note:
The CICSPlex SM system programmer can use the EYU9WRAM user-replaceable module to change the transaction ID associated with a DPL request.

For introductory information about CICSPlex SM, see the CICSPlex SM Concepts and Planning manual.

When definitions of remote server programs aren’t required

There are some circumstances in which you may not need to install a static definition of a remote server program:

Related concepts
Which remote resources need to be defined?
Local and remote names for resources
Overview of DPL
Related tasks
Defining local resources for DPL
Application programming for CICS DPL
Defining remote resources for function shipping
Defining remote resources for asynchronous processing
Defining remote resources for transaction routing
Defining remote resources for DTP
[[ Contents Previous Page | Next Page Index ]]