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 runtime 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, you must 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.
- IMSJ2C
- In a J2EE environment, specifies use of an IMS™ J2C connector.
- IMSTCP
- Specifies use of the TCP/IP connector from IMS Connect. Select this option if you are
running non-J2EE code that accesses IMS.
Note: IMS Connect must be installed on the host
machine where the IMS program resides. On the client machine, the following
set of IMS Connector
for Java jar
files must be in the classpath when the calling program is started:
- ccf2.jar
- connector.jar
- imsico.jar
- 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.