remoteComType in callLink element

The linkage options part, callLink element, property remoteComType specifies the communication protocol used in the following case:

Select one of the following values.

DEBUG

Causes the called program to run in the EGL debugger, even when the calling program is running in a Java run-time or Java debug environment. You might use this setting in the following cases:

  • You are running a Java program that uses an EGL Java wrapper to call a program written with EGL; or

  • You are running an EGL-generated calling program that calls a program written with EGL.

The preceding situations can occur outside the WebSphere Test Environment, but can also occur within that environment, as when a JSP invokes a program written with EGL. In any case, the effect is to invoke the EGL source, not an EGL-generated program.

If you are using the WebSphere Test Environment, the caller and called programs must both be running there; the call cannot be from a remote machine.

When you use DEBUG, you set the following properties in the same callLink element--

  • library, which names the project that contains the called program

  • package, which identifies the package that contains the called program; but you do not need to set this property if the caller and called programs are in the same package

If the caller is not running in the EGL debugger and is not running in the WebSphere Test Environment, set these properties of the callLink element:

  • serverid, which should specify the listener's port number if it's not 8346; and

  • location, which must contain the hostname of the machine where the Eclipse workbench is running.

DIRECT

Specifies that the calling program or wrapper uses a direct local call, which means that the calling and called code run in the same thread. No TCP/IP listener is involved, and the value of property location is ignored. DIRECT is the default.

A calling Java program does not use the EGL middleware, but a calling wrapper uses that middleware to handle data conversion between EGL and Java primitive types.

If the EGL-generated Java code is calling a non-EGL-generated dynamic link library (DLL) or a C or C++ program, it is recommended that you use the remoteComType value DISTINCT.

DISTINCT

Specifies that a new run unit is started when calling a program locally. The call is still considered to be remote because EGL middleware is involved.

You can use this value for an EGL-generated Java program that calls a dynamic link library (DLL) or a C or C++ program.

CICSECI

Specifies use of the CICS Transaction Gateway (CTG) ECI interface, as is needed when you are debugging or running non-J2EE code that accesses CICS.

CTG Java classes are used to implement this protocol. To specify the URL and port for a CTG server, assign values to the callLink element, properties ctgLocation and ctgPort. To identify the CICS region where the called program resides, specify the location property.

CICSJ2C

Specifies use of a J2C connector for the CICS Transaction Gateway.

CICSSSL

Specifies use of the Secure Socket Layer (SSL) features of CICS Transaction Gateway (CTG). The JSSE implementation of SSL is supported.

CTG Java classes are used to implement this protocol. To specify additional information for a CTG server, assign values to the following callLink element properties:

  • ctgKeyStore

  • ctgKeyStorePassword

  • ctgLocation

  • ctgPort, which in this case is the TCP/IP port on which a CTG JSSE listener is listening for requests. If ctgPort is not specified, the CTG default port of 8050 is used.

To identify the CICS region where the called program resides, specify the location property.

JAVA400

Specifies use of the IBM Toolbox for Java to communicate between a Java wrapper or program and a COBOL program that was generated (by EGL or VisualAge Generator) for iSeries.

TCPIP

Specifies that the EGL middleware uses TCP/IP.

Related concepts
Linkage options part

Related tasks
Editing the callLink element of a linkage options part

Related reference
ctgKeyStore in callLink element
ctgKeyStorePassword in callLink element
ctgLocation in callLink element
ctgPort in callLink element
Editing the callLink element of a linkage options part
Setting up the J2EE server for CICSJ2C calls
Setting up the TCP/IP listener for a called appl in a J2EE appl client module
Setting up the TCP/IP listener for a called non-J2EE application