Installing the publish and retract sample programs

This section describes how to install the CICSConnectionFactoryPublish and CICSConnectionFactoryRetract programs. How to install the CCI Connector application is described in Installing the CCI Connector sample.

The CICS-supplied JAR file CICSCCISamples.jar contains the object (.class) files for the sample programs. CICS installs CICSCCISamples.jar into the /usr/lpp/cicsts/cicsts31/samples/cci directory (where cicsts31 is the value of the CICS_DIRECTORY variable used by the DFHIJVMJ job during CICS installation). Also installed into the /usr/lpp/cicsts/cicsts31/samples/cci directory are the source (.java) files of the programs.

To install the CICSConnectionFactoryPublish and CICSConnectionFactoryRetract programs:

  1. Add the JAR file containing the programs, /usr/lpp/cicsts/cicsts31/samples/cci/CICSCCISamples.jar, to the CLASSPATH statement in the JVM profile that the programs will use. As supplied, the sample programs use the CICS-supplied sample JVM profile DFHJVMPR, which is the default if no JVM profile is specified in the program's resource definition. CICS installs DFHJVMPR into the /usr/lpp/cicsts/cicsts31/JVMProfiles directory (where cicsts31 is the value of the CICS_DIRECTORY variable used by the DFHIJVMJ job during CICS installation).
  2. Place your edited version of DFHJVMPR in the HFS directory specified on the JVMPROFILEDIR system initialization parameter. (In a default CICS installation, JVMPROFILEDIR specifies /usr/lpp/cicsts/cicsts31/JVMProfiles.)
  3. Use CEDA to install transactions CCPB and CCRT from group DFH$CCI.
  4. Use CEDA to install programs DFJ$CCPB and DFJ$CCRT from group DFH$CCI.
    Note: If your CICS region uses program autoinstall, this last step is not required.