CICSClient node

The CICSClient node icon

This page contains information on:

CICSClient node terminals
Configuring the CICSClient node
Node properties

The CICSClient node initiates a CICS Universal Client connection to a CICS Server. The CICS Server must be configured to allow incoming client connections and the CICS Client must be configured for use with the CICS Server.

The CICSClient node issues a request to execute a specified application on a CICS Server. The name of the program to be executed is configured to the node as a node attribute. When the node is reached, the current message tree is serialized and sent as the COMMAREA to the CICS Server. On return from the CICS Server, the resulting response 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 MQSI event log.

The CICSClient node utilizes the services of the IBM CICS Universal Client. This product must be installed and configured on each machine on which an MQSI broker will run an instance of a message flow that contains the CICSClient node. The CICS Universal Client must be configured to allow connectivity to the target CICS Server.

Node terminals

The CICSClient node provides the following terminals:

in

The input terminal that accepts a message for processing by the node.

out

The output terminal to which the message is propagated. The CICS Commarea returned is passed as output in the message tree.

failure The output terminal to which the input message is propagated if an error is encountered while attempting to execute the CICS transaction on the server.

Configuring the CICSClient node

The CICSClient node must be configured with at least the names of the CICS Server on which the program is to be executed as well as the name of the program.

MQGet node properties

Property	Default	Description
Name of CICS Region		Name of CICS Server on which the program will execute.
Name of CICS Program		Name of the CICS program to be executed on the CICS Server.
CICS Userid		Optional userid against under which the CICS program will execute.
CICS Password		Optional password for the userid. Must be supplied if the Userid attribute is present.
Length of Commarea	0	Optional over-ride for Commarea length. If not supplied or 0 value, the Commarea length will be derived from the length of the serialized message tree data.
Remove MQMD	Yes	Optional indicator to specify whether or not any MQMD header present should be removed from the serialized message before sending to the CICS Server.

in	The input terminal that accepts a message for processing by the node.
out	The output terminal to which the message is propagated. The CICS Commarea returned is passed as output in the message tree.
failure	The output terminal to which the input message is propagated if an error is encountered while attempting to execute the CICS transaction on the server.