The
location property of the
callLink element
of the linkage options part specifies how the location of a called
program is determined at run time. The
location property
affects the generation of the calling program. The
location property
is applicable in the following situation:
- The value of the type property is ejbCall or remoteCall;
- The value of the remoteComType property
is JAVA400, CICSECI, CICSSSL, CICSJ2C, TCPIP, DIRECT, IMS2J2C,
IMSTCP, or DISTINCT.
- If you are generating a Java™ wrapper, pgmName refers
to a program that is called by way of the Java wrapper.
Select a value from this list:
- PROGRAMCONTROLLED
- Specifies that the location of the called program is obtained
from the sysVar.remoteSystemID system function
when the call occurs.
- system name
- Specifies the location where the called program resides.
If
you are generating a CICS® COBOL
program, the following rules apply for system name:
- You can specify the name of the connection definition that has
the following characteristics:
- Is installed in the CICS region
where the calling program runs; and
- Defines the connection with the CICS region
where the called program runs.
- If you do not specify the PROGRAMCONTROLLED value or a connection
definition, the location of the called program is determined from
the entry for the called program in the CICS Processing
Program Table (PPT) or RDO PROGRAM entry.
If you are generating a Java program
or wrapper, the meaning of the location property
depends on the remoteComType property in
the following ways: