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:

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 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 JAVA400J2C, location refers to the JNDI name specified in the application server.
  • If the value of the remoteComType property is CICSECI, CICSEXCI, or CICSSSL, 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;

Feedback