Configuring CICS Transaction Gateway for high availability

Edit online

To configure CICS® Transaction Gateway for high availability, you need to create a number of configuration files.

The configuration file and the policy file are installed under the directory <install_path>/samples/scenarios/sc09.

The configuration files used to define a gateway for high availability are:
  • A CICS Transaction Gateway configuration file.
  • A High Availability policy file for use with the round robin CICS request exit.

CICS Transaction Gateway configuration file

Create a CICS Transaction Gateway configuration file ctg.ini using the values suggested in the table Configuring workload management using a CICS request exit (SC09):

You must define server definitions for the Gateway daemon to communicate with CICS over IPIC in remote mode. To define the CICS server definitions for the Gateway daemon. Edit the IPICSERVER sections within the ctg.ini file:
  • Set HOSTNAME to the name of the IBM® z/OS® machine that hosts your CICS server.
  • Set PORT to the port number that your CICS server uses to listen for incoming IPIC requests.
For example:
SECTION IPICSERVER = CICSA1
    DESCRIPTION=IPIC connection to CICSA1
    HOSTNAME=server.ibm.com
    PORT=4149
ENDSECTION

SECTION IPICSERVER = CICSA2
    DESCRIPTION=IPIC connection to CICSA2
    HOSTNAME=server.ibm.com
    PORT=4150
ENDSECTION

Configure round robin CICS request exit

Set the environment variable to point to the round robin policy file:

  1. Add the CA1T SupportPac jar to the CLASSPATH.
  2. Copy the sample ha.ini file to the configuration settings folder.
  3. Set the environment variable CTG_HACONFIG to the location of the ha.ini file.