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.
- 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
- 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.
- 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
- 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.
- 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.
- Follow the instructions in Building the Java samples.