JavaCICSClient node

The JavaCICSClient node icon

This page contains information on:

The JavaCICSClient node initiates a syncronous connection to a CICS Server via the CICS Transaction Gateway (CICS TG) Client daemon. The CICS Server must be configured to allow incoming client connections and the CICS TG Client must be configured to connect to the CICS Server.

The JavaCICSClient node issues a request (External Call Interface - ECI) to execute a specified application program on a CICS Server. The name of the program to be executed is configured as a node attribute. The input message is serialized and sent in the COMMAREA to the CICS Server. On return from the CICS Server, the resulting message in the COMMAREA is propagated onwards as a BLOB message body which can be reparsed if needed by a Reset Content Descriptor node.

In the event of an error indication from the CICS Server, the original message is propagated onwards through the failure terminal and an error is logged to the event log.

The JavaCICSClient node utilizes the services of the IBM CICS TG Client daemon . This product must be installed and configured on each machine on which an WMQI broker will run an instance of a message flow that contains the JavaCICSClient node.

The JavaCICSClient node runs on all the platforms supported by the WMQI V2.1 broker and the CICS TG Client daemon. This includes z/OS.

JavaCICSClient node terminals

in	The input terminal that accepts a message for processing by the node.
failure	The output terminal to which the message is propagated if an error occurred.
out	Propagates the message received in the CICS commarea as BLOB to the next node in the message flow.

Configuring the JavaCICSClient node

To deploy the JavaCICSClient node to a WMQI broker, the following is required:

The CICS TG Client daemon (part of the CICS Transaction Gateway (CICS TG) product) installed in the same system where the broker is running
Access to a CICS Transaction Gateway (CICS TG) that is connected to the CICS application server region or if the broker is running on the same z/OS image as CICS then the JavaCICSClient can connect directly using the local connection (local://)
Add to the CLASSPATH environment variable (in z/OS update CLASSPATH in the mqsicompcif and ENVFILE files) the following jar files:
- (ctg_install_dir)\classes\ctgclient.jar
- (ctg_install_dir)\classes\ctgserver.jar
Add to the PATH (LIBPATH in z/OS) environment variable (in z/OS update LIBPATH in the mqsicompcif and ENVFILE files) the following subdirectories:
- (ctg_install_dir)\bin
In z/OS, add to the STEPLIB (or LINKLST) library concatenation for the broker start up JCL the following libraries:
- (cics_hlq).SDFHEXCI

JavaCICSClient node properties

All the following properties are on the Basic tab

Property

Default

Description

Name of CICS Region

Mandatory

This is the APPLID of the CICS region that this node is going to connect to.

Name of CICS Program

Mandatory

Name of the CICS program to be executed to process the data in the COMMAREA.

CICS Userid

Userid to access the CICS region if required

Userid's Password

Password to access the CICS region.

CICS Transaction name

Name of the CICS Transaction to be used to run the CICS program. If this is not specified, CICS will use the mirror transaction CSMI.

CICS Transaction Gateway URL

local://

URL for the host where the CICS Gateway is running. Use local:// if the gateway is running on the same host as the WMQI broker or use tcp://hostname or IP address if the gateway is running on a remote host.

CICS Transaction Gateway port

2006

Port number that CICS Transaction Gateway is listening.

Length of commarea

0

Length in bytes of the commarea that is passed to the CICS program. This length must match the size of the commarea expected by the program.

Remove MQMD

Check

To indicate if the MQMD is expected by the CICS program in the commarea.

Property	Default	Description
Name of CICS Region	Mandatory	This is the APPLID of the CICS region that this node is going to connect to.
Name of CICS Program	Mandatory	Name of the CICS program to be executed to process the data in the COMMAREA.
CICS Userid		Userid to access the CICS region if required
Userid's Password		Password to access the CICS region.
CICS Transaction name		Name of the CICS Transaction to be used to run the CICS program. If this is not specified, CICS will use the mirror transaction CSMI.
CICS Transaction Gateway URL	local://	URL for the host where the CICS Gateway is running. Use local:// if the gateway is running on the same host as the WMQI broker or use tcp://hostname or IP address if the gateway is running on a remote host.
CICS Transaction Gateway port	2006	Port number that CICS Transaction Gateway is listening.
Length of commarea	0	Length in bytes of the commarea that is passed to the CICS program. This length must match the size of the commarea expected by the program.
Remove MQMD	Check	To indicate if the MQMD is expected by the CICS program in the commarea.