Installing: Installing Third-Party JAR Files for the CICS Adapter

Installing Third-Party JAR Files for the CICS Adapter

This section includes information for installing and configuring the IBM CICS Transaction Gateway(CTG). The CTG must be installed and configured as the underlying connection transport to access z/OS CICS transactions.

Running the Third-Party Library Installer

The Installer script requires the installation of Apache Ant version 1.7 or above, it can be downloaded from the following location:

http://ant.apache.org/or

you can use the ant version distributed with Java CAPS.

To Run the Third-Party Installer

The following steps are for running the Third-Part Installer with default settings. If you are running the Installer for specific instantiations of Netbeans or GlassFish (separately), you must specify each specifically when running ant (for example, ant install-glassfish or ant-install-netbeans).

Download the Adapter's Third Party Library Installer zip file from the Java CAPS Repository and extract it into a working directory.
c:\JavaCAPS6\ThirdPartyInstaller
Open a command window and navigate to the directory that you extracted the Third Party Installer zip file.
cd c:\JavaCAPS6\ThirdPartyInstaller
Set ANT_HOME to point to your home directory of your ANT installation.
set ANT_HOME=C:\JavaCAPS6\netbeans\java2\ant
Set JAVA_HOME to point to your JDK installation.
set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_03
Set your PATH to include the bin directory of your ANT installation.
set PATH=C:\JavaCAPS6\netbeans\java2\ant
Customize the build.properties as follows: (For more information on build properties, refer to Table 1)
1. Modify the product.name= to only process the cicsadapterra.
2. Modify the cicsadapterra.thirdpartyfiles= to point to the IBM CTG Third Party libraries.
  Examples:
  
  Windows — cicsadapterra.thirdpartyfiles=C:/Program Files/IBM/CICS Transaction Gateway/classes/ctgclient.jar;C:/Program Files/IBM/CICS Transaction Gateway/classes/ctgserver.jar
  
  Solaris — cicsadapterra.thirdpartyfiles= /opt/IBM/cicstg/classes/ctgclient.jar; /opt/IBM/cicstg/classes/ctgserver.jar
Note - The only file that must be modified/customized is build.properties.
Shutdown the instances of JavaCAPS Netbeans and GlassFish.
Invoke the Third Party Installer by typing ant.
Restart your JavaCAPS Netbeans instance.

Build Properties for the Installation of Third-Party Libraries

Third-Party Installer Build Properties

Name	Description	Value
netbeans.home (C:/JavaCAPS6/netbeans)	Indicates the location of the Netbeans installation.	For a default installation of Java CAPS, the location will be C:/JavaCAPS6/netbeans/ for Windows, or ~/JavaCAPS6/netbeans/ for UNIX. *Caution -* This property is automatically set by default. If you change the default property, you must customize the rest of the installation to match this property.
glassfish.home (C:/JavaCAPS6/glassfish)	Indicates the location of the GlassFish installation. This allows third-party libraries to be copied to the right location in the runtime environment.	For a default installation of JavaCAPS, the location will be C:/JavaCAPS6/glassfish for Windows, or ~/JavaCAPS6/glassfish for UNIX *Caution -* This property is automatically set by default. If you change the default property, you must customize the rest of the installation to match this property.
installation.domains	Indicates the domains in the GlassFish installation where the third-party libraries will be placed.	The default for installation.domains is domain1
product.name	Indicates the products that require third-party jar files to be installed (select any or all that are required). Do not modify product names, as they are used to install the jar files using the specific product name.	The product.name property depends on which Third-Party jar files will be installed. For this installation, the property would be cicsadapterra
thirdpartyfiles	A path-like structure that indicates the location of third-party libraries. This structure must give the location of files. In other words, this is not a search path, but rather a location path	For each adapter, these libraries vary depending on platform. For example: db2connectadapter.thirdpartyfiles= vsamadapter.thirdpartyfiles= cicsadapterra.thirdpartyfiles=C:/Program Files/IBM/CICS Transaction Gateway/classes/ctgclient.jar;C:/Program Files/IBM/CICS Transaction Gateway/classes/ctgserver.jar siebeleaiadapter80.thirdpartyfiles= siebeleaiadapter78.thirdpartyfiles= siebeleaiadapter77.thirdpartyfiles= siebeleaiadapter75x.thirdpartyfiles=

Installing Upgrading Designing Configuring Deploying Monitoring Administering Troubleshooting Reference JBI Components
Close Print View
Installing: Installing Third-Party JAR Files for the CICS Adapter