location in callLink element

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 CICSECI, CICSSSL, CICSJ2C, DIRECT, DISTINCT, IMS2J2C, IMSTCP, JAVA400, JCICS or TCPIP.
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:

If the value of the remoteComType property is JAVA400, location refers to the iSeries® system identifier.
If the value of the remoteComType property is CICSECI, CICSEXCI, CICSSSL or JCICS, location refers to the CICS® system identifier.
If the value of the remoteComType property is CICSJ2C, location refers to the JNDI name of the ConnectionFactory object that you establish for the CICS® transaction started by the call. You establish that ConnectionFactory object when setting up the J2EE server, as described in Setting up the J2EE server for CICSJ2C calls. By convention, the name of the ConnectionFactory object begins with eis/, as in the following example:
```
  eis/CICS1
```
If the value of the remoteComType property is IMSJ2C, location refers to the JNDI name of the ConnectionFactory object that you establish for the IMS™ transaction invoked by the call. You establish that ConnectionFactory object when setting up the J2EE server, as described in the topic "Setting up the J2EE server for IMSJ2C calls" in the list of related topics below. By convention, the name of the ConnectionFactory object begins with eis/, as in the following example:
```
eis/IMS1
```
If the value of the remoteComType property is IMSTCP, location has the following value:
```
host:portNumber/dataStoreName
```
host

TCP/IP host name or address that refers to the system where the called program runs on IMS™

portNumber

Number of the port used for TCP/IP connections by the target IMS™ Connect installation

dataStoreName

Target IMS™ datastore name, which must match the ID parameter of the Datastore element that is specified in the IMS™ Connect configuration member
If the value of the remoteComType property is TCPIP, location refers to the TCP/IP host name or address.
If the value of the remoteComType property is DEBUG, location refers to the host name of the system where the Eclipse workbench is running.
If the value of the remoteComType property is DISTINCT, location is used only in the iSeries® environment, where it contains the name of the library that contains the DLL or program. The library property contains the name of the DLL or program.
If all of the following conditions apply, then location refers to the library of the called program:
- The calling program is an EGL-generated Java™ program that runs on iSeries®;
- The value of the remoteComType property is DIRECT or DISTINCT; and
- The value of remotePgmType is EXTERNALLYDEFINED;