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:

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 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 Setting up the J2EE server for IMSJ2C calls. By convention, the name of the ConnectionFactory object begins with eis/, as in the following example:
      eis/IMS1
  • If the value of remoteComType is IMSTCP, locationhas the following value:
      host:portNumber/dataStoreName
    host
    TCP/IP host name or address that refers to the machine 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 remoteComType is TCPIP, location refers to the TCP/IP host name or address 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

Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.