Building the JCICS sample programs

The Java™ source and makefiles are stored in the z/OS® UNIX System Services HFS during CICS® installation. To build the samples in the z/OS UNIX System Services environment, you must define three environment variables and install a group. You can define the environment variables in the profile for z/OS UNIX System Services, using the export command, or you can enter the export command manually when z/OS UNIX System Services is running.
  1. PATH is the z/OS UNIX System Services search path. Define the PATH environment variable by adding:
    /usr/lpp/java142/J1.4/bin
    where java142/J1.4 is the install location that was set up when you installed the IBM® Software Developer Kit for z/OS, Java 2 Technology Edition, Version 1.4.2. This is the path for the Java executables. You can use the export command to add the path as follows:
    export /usr/lpp/java142/J1.4/bin:$PATH
  2. CICS_HOME is the installation directory prefix of CICS Transaction Server for z/OS. Define the CICS_HOME environment variable as follows:
    /usr/lpp/cicsts/cicsts31
    where cicsts31 is defined by the USSDIR installation parameter when you installed CICS TS (cicsts31 is the default). You can use the export command to set the directory prefix as follows:
    export CICS_HOME=/usr/lpp/cicsts/cicsts31

    The $CICS_HOME/samples/dfjcics directory contains the makefiles.

    The $CICS_HOME/samples/dfjcics/examples directory contains the Java source.

  3. JAVA_HOME specifies the path to the IBM Software Developer Kit for z/OS, Java 2 Technology Edition, Version 1.4.2 subdirectories. Define the JAVA_HOME environment variable as follows:
    /usr/lpp/java142/J1.4/ 
    where java142/J1.4/ is the install location that was set up when you installed the IBM Software Developer Kit for z/OS, Java 2 Technology Edition, Version 1.4.2
  4. Install the group DFH$JVM in order to run the samples. CICS resource definitions for all the sample programs and transactions are supplied in this group.
  5. Optional: If you want to run the Web sample program, which is invoked via a browser, you need to follow the instructions in the CICS Internet Guide. Use the web sample application DFH$WB1A to confirm that CICS web support is configured correctly.
  6. Follow the instructions in Building the Java samples.