Configuring a TXSeries region to communicate with the CICS JEE inbound resource adapter

This topic explains how to configure a TXSeries region to communicate with the CICS JEE inbound resource adapter.

To configure TXSeries for Outbound communication to WebSphere Application Server, perform the following steps.

Create a Listener Definition (LD) and set the Protocol attribute to IPIC.
Set the TCPAddress attribute to define the network adapter addresses. The attribute can be specified as follows.
- The Internet Protocol (IP) address in dotted decimal notation. For example, 1.23.45.67. Do not use leading zeros when specifying an address in dotted decimal notation; CICS interprets such an entry as octal.
- The Internet Protocol (IP) address in dotted hexadecimal notation. For example, 0x01.0x17.0x2D.0x43.
- The host name that is defined in the Internet name service. For example, aix5.cicsland.com.
Set the TCPService attribute to the TCP/IP service name. The TCP/IP service name refers to an entry in the services file provided by the operating system. In open systems such as AIX, the services file is in the /etc/ directory. In Microsoft Windows, the file is in the C:\windows\system32\drivers\etc directory. You must add a unique service name and assign a unique TCP port for the service name in the services file. For example,
```
cicsipc1        8598/tcp  #TCP listener1 for region regionName
```
For more information on services files, see your operating system documentation.
Set ActivateOnStartup=yes so the Listener starts when the region starts.
Create a Communication Definition (CD) and set the ConnectionType=cics_ipic.
Set RemoteLUName="IPIC1234".
Set RemoteNetworkName="IPIC1234".
Set RemoteTCPAddress to the hostname or IP address that the JEE inbound resource adapter is listening on.
Set RemoteTCPPort to the port that the JEE inbound resource adapter is using as specified by the inboundPort value.
Set SendCount if you want to increase the maximum number of IPIC sessions. Default is 100.
Set PreferredRecovery=xa.
Set SupportedRecovery=xa.
If your region is not configured with any of the XA supported product definition, you can use “cicsjee” SwitchLoadFile file that is provided with the product to make the TXSeries region support XA transactions with WebSphere Application Server.
For example, you can run:
```
cicsadd -c xad -r regionName WASTX XAOpen=" " SwitchLoadFile="/usr/lpp/cics/bin/cicsjee"
```

Restart the region after doing all the settings.

Example

The following sample command adds an LD entry for IPIC to the CICS region's permanent database:

cicsadd -r cics -P -c ld LD1
              TCPAddress="aix2.cicsland.com" TCPService="cicsipic"
              Protocol=IPIC  ActivateOnStartup=yes

cicsadd –r cics –P –c cd
              WASx ConnectionType=cics_ipic RemoteLUName="IPIC1234" RemoteNetworkName="IPIC1234"
              ListenerName="LD1" RemoteTCPAddress="WAS_ip_address" RemoteTCPPort=2007
              SupportedRecovery=xa

For more information on how to configure TXSeries, see http://www.ibm.com/support/knowledgecenter/SSAL2T_9.1.0/com.ibm.cics.tx.doc/ic-homepage.html.