Configuring workload management using a CICS request exit (SC09)

Edit online

This scenario shows how to configure workload management using a CICS® request exit to select a server.

Note: This example uses CICS Transaction Gateway connecting to CICS Transaction Server V5.3 over IPIC and IBM® WebSphere® Application Server V8.0. For the minimum requirements, see Prerequisites.

This scenario uses the default name ctg.ini for the configuration file.

The figure shows workload from a connection factory in IBM WebSphere Application Server being served by a Gateway daemon. Any supported JEE application server can be used in this scenario.

This figure shows XA transactions in a high availability scenario with connections to CICS over IPIC.
Figure 1. Transactions over IPIC in a high availability scenario

The Gateway daemon is connected to CICS servers CICSA1 and CICSA2 using the IPIC protocol. The work in CICS will be handled by one of CICSA1 or CICSA2. In this scenario, the Gateway daemon is configured for dynamic server selection using a CICS request exit. Dynamic server selection is performed at the start of each new transaction and manages the associated transactional affinity with the selected CICS server, for the life of the transaction.

Note: The connection factory definition in IBM WebSphere Application Server does not need to contain details of the actual CICS servers.

Follow the step-by-step instructions in this scenario to implement workload management using a CICS request exit.

Table 1. Values used in this scenario
ComponentComp- onent Property Where set Details
CICS TG Gateway daemon configuration ctg.ini
cicsrequestexit=com.ibm.ctg.samples.ha.RoundRobinExit
protocol@tcp.handler=com.ibm.ctg.server.TCPHandler
protocol@tcp.parameters=port=2006;
CICS TG IPIC connection to CICSA1 ctg.ini
name=CICSA1
hostname=server.ibm.com
port=4149
CICS TG IPIC connection to CICSA2 ctg.ini
name=CICSA2
hostname=server.ibm.com
port=4150
CICS TG Round robin ha.ini
CICSL1=CICSA1,CICSA2
CICS TG CLASSPATH Environment variables
The location on the file system of the CA1T
CICS request exit JAR file.
CICS TG CTG_HACONFIG Environment variables
The location on the file system of the round robin
CICS request exit policy file.
CICS TS CICSA1 TCPIPService for IPIC connection Using CEDA on CICSA1
name=IPIC4149
protocol=IPIC
port=4149
CICS TS CICSA2 TCPIPService for IPIC connection Using CEDA on CICSA2
name=IPIC4150
protocol=IPIC
port=4150
WAS CICS TG ECI resource adapter connection factory J2C connection factories
name=ECI-CICSTG
WAS CICS TG ECI resource adapter connection factory J2C connection factories JNDI Name=eis/CICSTG
WAS CICS TG ECI resource adapter connection factory CICS TG ECI resource adapter connection factory connection pool properties
Maximum connections=100
WAS Connection factory details CICS TG ECI resource adapter connection factory custom properties
ConnectionURL=tcp://server.ibm.com
PortNumber=2006
ServerName=CICSL1
The sample configuration file and High Availability policy file for this scenario are provided in the directory <install path>/samples/scenarios/sc09:
  • ctg.ini
  • ha.ini