Configuring workload management using a CICS request exit (SC09)

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

The figure shows workload from a connection factory in 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 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. This example uses CICS Transaction Gateway connecting to CICS Transaction Server V4.1 over IPIC and WebSphere Application Server V8.0.

Table 1. Values used in this scenario
Component 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 available for you to download:

Information Information

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tg_latest/help/topic/com.ibm.cics.tg.doc//ctgunx/sc09_ha_ipic_ovr.html