location in callLink element

The linkage options part, callLink element, property location specifies how the location of a called program is determined at run time. The property location is applicable in the following situation:

• The value of property type is ejbCall or remoteCall;

• The value of property remoteComType is JAVA400, CICSECI, CICSSSL, CICSJ2C, or TCPIP; and

• One of these statements applies:
  • If you are generating a Java program, property pgmName refers to a program that is called by the program being generated

  • 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 system function sysVar.remoteSystemID when the call occurs.

system name

Specifies the location where the called program resides.

If you are generating a Java program or wrapper, the meaning of this property depends on property remoteComType:

• If the value of remoteComType is JAVA400, location refers to the iSeries system identifier

• If the value of remoteComType is CICSECI or CICSSSL, location refers to the CICS system identifier

• If the value of remoteComType is CICSJ2C, location refers to the JNDI name of the ConnectionFactory object that you establish for the CICS transaction invoked 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 remoteComType is TCPIP, location refers to the TCP/IP hostname, and no default value exists

• If all the next conditions apply, location refers to the library of the called program--
  • The called program is an EGL-generated Java program that runs locally on iSeries

  • The value of remoteComType is DIRECT or DISTINCT

  • The value of remotePgmType is EXTERNALLYDEFINED

Related concepts
Linkage options part

Related tasks
Editing the callLink element of a linkage options part
Setting up the J2EE server for CICSJ2C calls

Related reference
callLink element

pgmName in callLink element
remoteComType in callLink element
type in callLink element