JVM server linkable interface containers

The JVM server linkable interface containers are used on the DFHSJJS-V1 channel to send and receive information between two application programs. Use the JVM server linkable client containers on the DFHNODE channel to send and receive information between a user-written application program and a pipeline handler.

CICS® provides a channel-based interface to call a Java™ program that is running in a JVM server. This interface is provided for vendor implementations that use JVM servers for non-OSGi Java programs. It is not for use with OSGi Java programs. See more in Linking to a JVM server.

DFHSJ-ERROR container

DFHSJ-ERROR is a container of DATATYPE(BIT). Errors generated during validation or execution of DFHSJJI are returned as a fullword binary value in the DFHSJ-ERROR container.

The following validation errors can be returned by DFHSJJI:
1
The specified channel name is not valid. The channel name must be specified as DFHSJJS-V1.
2
The container DFHSJ-JVMSERVER does not exist, or is empty.
3
The name specified in the DFHSJ-JVMSERVER container is too long. The name must be 1 - 8 characters long.
4
The container DFHSJ-USERCLASS does not exist, or is empty.
5
The name specified in the DFHSJ-USERCHANNEL container is not valid. The name must be 1 - 16 characters long.
6
The XML received from the PIPELINE is invalid.
The following execution errors can be returned by DFHSJJI:
51
The specified JVMSERVER does not exist.
52
The specified JVMSERVER exists, but is not enabled.
53
The specified wrapper class was not found in the class path.
54
The Java user program ended abnormally.
55
The attach thread method failed; a non-zero return code was received from AttachCurrentThread().
56
The specified method and signature combination was not found in the user class.
57
The detach thread method failed; a non-zero return code was received from DetachCurrentThread().
58
An unhandled exception was thrown inside the JVM.
59
The domain was called without a parameter list in the container.
60
The thread failed and was terminated.
61
The program was not able to create a new thread because the maximum number of threads has been reached or LE Enclave has terminated.

DFHSJ-JVMSERVER container

DFHSJ-JVMSERVER is a container of DATATYPE(CHAR). It contains the 8-character name of the JVMSERVER in which the target program is to run.

If the name of the JVMSERVER is less than 8-characters, the container must be padded with trailing blanks.

Use this container with channel DFHSJJS-V1 if the channel is passed between two application programs. Use this container with channel DFHNODE if the channel is passed between a pipeline handler and an application program.

DFHSJ-USERCLASS container

DFHSJ-USERCLASS is a container of DATATYPE(CHAR). It contains the name of the Java class to be run in the JVM server.

Use this container with channel DFHSJJS-V1 if the channel is passed between two application programs. Use this container with channel DFHNODE if the channel is passed between a pipeline handler and an application program.

DFHSJ-USERMTHDNM container

DFHSJ-USERMTHDNM is a container of DATATYPE(CHAR). It contains the name of the method in the user class to be run in the JVM server.

If the name of the method is not specified, the main() method is run.

Use this container with channel DFHSJJS-V1 if the channel is passed between two application programs. Use this container with channel DFHNODE if the channel is passed between a pipeline handler and an application program.

DFHSJ-USERMTHDSG container

DFHSJ-USERMTHDSG is a container of DATATYPE(CHAR). It contains the signature of the method specified in the DFHSJ-USERMTHDNM container.

If the signature of the method is not specified, the signature defaults to ([Ljava/lang/String;)V, which means that the method accepts an array of type String and returns void, V.

Use this container with channel DFHSJJS-V1 if the channel is passed between two application programs. Use this container with channel DFHNODE if the channel is passed between a pipeline handler and an application program.

DFHSJ-USRCHANNEL container

DFHSJ-USRCHANNEL is a container of DATATYPE(CHAR). It contains the name of the channel to be passed to the target program.

If the name of the channel is not specified, the channel name defaults to DFHSJJS-V1 or DFHNODE.

Use this container with channel DFHSJJS-V1 if the channel is passed between two application programs. Use this container with channel DFHNODE if the channel is passed between a pipeline handler and an application program.