CICS Transaction Gateway V5 The WebSphere ... - IBM Redbooks

252 CICS Transaction Gateway V5
SETROPTS RACLIST(SURROGAT) REFRESH
Installation of the CICS ECI resource adapter
Resource adapters are packaged in Resource Adapter Archive (RAR) files,
which like EAR files are archives made up of JAR files and a deployment
descriptor. The CICS ECI resource adapter for z/OS is provided in the file
cicseciRRS.rar in the deployable directory of the CICS TG installation.
This cicseciRRS.rar resource adapter archive is designed exclusively for z/OS. It
makes use of the two-phase commit capability of RRS to provide support for
global transactions. All non-z/OS platforms use the cicseci.rar file instead.
Unlike WebSphere Application Server Advanced Edition, WebSphere Application
Server for z/OS does not work with RAR files directly, so you must extract the
contents of the RAR file into a directory, and point the WebSphere classpath to
each JAR file in this directory.
To install the CICS ECI resource adapter, we entered the following commands
under OMVS:
► export PATH=/usr/lpp/java/IBM/J1.3/bin:$PATH
This adds the bin directory of our Java1.3 installation to the PATH
environment variable.
► cd /usr/lpp/ctg500/ctg/deployable
This changes directory to the location where the CICS TG supplies the
cicseciRRS.rar file.
► jar -xvf cicseciRRS.rar
This extracts the following files, as shown in Example 10-3.
Example 10-3 Extract of cicseciRRS.rar
$ SC66¨ /usr/lpp/ctg500/ctg/deployable: jar -xvf cicseciRRS.rar
created: META-INF/
extracted: META-INF/MANIFEST.MF
extracted: META-INF/ra.xml
extracted: ccf2.jar
extracted: ctgclient.jar
extracted: ctgserver.jar
extracted: cicseciRRS.jar
extracted: cicsframe.jar
extracted: libCTGJNI.so
extracted: libCTGJNI_g.so
We then used the following commands to add execute permissions for all users
to the CICS TG JNI shared library (libCTGJNI.so):