CICS Connection — Connection Configuration Panel

In the Connection Configuration panel, you can provide the information of the CICS region that the plug-in connects to.

The following table lists the configurations in the Connection Configuration panel of the CICS Connection shared resource when the CICS option is selected for Connection Type :

Field Module Property? Description
Connection Type No Type of the connection. It has the following options:
  • CICS
  • CTG
Host Name Yes The host name or IP address of the machine running the CICS region.

Default: localhost

Port Yes The number of the TCP port, which CICS is listening to.

Default: 9911

Range: 0 - 65535

Userid Yes The user ID that is used to create the TCP connection. This user ID becomes the default user ID for all interactions executed using this resource.
Password Yes The password for this user ID.
Transaction Name Yes The name of the CICS socket listener transaction. Options are:
  • Production: it is translated to SXNE. This is the default value.
  • Debug: it is translated to SXNT.
  • The character name (in four uppercase letters) of the transaction if you have copied or renamed the CICS socket listener transaction during installation.
Alternate Hosts Yes

A list of host:port URIs that together comprise a group of CICS regions that are used to service interactions. These regions must support all the programs used by activities sharing this region resource, and must also have the same version of the plug-in host software installed.

In the dialog provided, enter each URI on a separate line. Alternately, the URIs can be comma, semi-colon, or space delimited.

In the event that the current CICS region becomes unavailable, new connections are established using the next available region. The "active" region becomes the default for new connections until it too becomes unavailable, in which case the next region is tried. If no regions are available, the interaction fails.

For pooled region resources, the loss of a CICS region might result in the failure of the interactions being currently executed, after which the pool migrates to the next available CICS region.

Character Set No The encoding in which the CICS system is running.

Default: IBM037

Socket Option Linger Yes The number of seconds that a slow TIBCO ActiveMatrix BusinessWorks activity collects its data from the network after the CICS interaction is completed.

Default: 0 (option is not set)

Range: 0 - 255

Clear Text Credentials Yes Normally the user ID and password sent to the CICS system are encrypted. Select this check box to not encrypt the user ID and password sent to the CICS system if Transport Layer Security is not enabled.

Clearing text credentials might be necessary if your site has implemented a custom security exit that cannot decrypt the user ID and password. See Security for z/OS Components.

Test Connection No Click this button to test the host and port specifications to determine whether the socket listener is up. If the port is open, a simple program runs to ensure that the basic infrastructure is working.

The following table lists the configurations in the Connection Configuration panel of the CICS Connection shared resource when the CTG option is selected for Connection Type :

Field Module Property? Description
CTG Host Yes The host name of the CICS CTG Gateway machine.
CTG Port Yes The port on which the CTG Gateway daemon is running
Userid Yes The user ID to be used when logging to the CTG Gateway daemon process.
Password Yes The password to be used when logging to the CTG Gateway daemon process.
CTG Tran Yes Enter the CTG transaction id as defined in CICS. By default, the value is SXEX which is synonymous to "Production".
CTG Server Name Yes The name of the CTG server.
CTG Socket Timeout Yes The socket timeout for interactions between the bwengine and CTG Gateway daemon.
Test Connection No Click this button to test the connection. If the CTG server name is not known, it is listed.