CICS loads the JVM profiles from the CICS® UNIX directory
that is specified by the JVMPROFILEDIR system
initialization parameter. You must change the value of the JVMPROFILEDIR parameter
to a new location and copy the supplied sample JVM profiles into this
directory so that you can use them to verify your installation.
Before you begin
The USSHOME system
initialization parameter must specify the root directory for CICS
files on z/OS UNIX.
About this task
The CICS-supplied sample JVM profiles are customized for
your system during the CICS installation process, so you can use them
immediately to verify your installation. You can customize copies
of these files for your own Java applications.
The settings
that are suitable for use in JVM profiles can change from one CICS
release to another, so for ease of problem determination, use the
CICS-supplied samples as the basis for all profiles. Check the upgrading
information to find out what options are new or changed in the JVM
profiles.
Procedure
- Set the JVMPROFILEDIR system
initialization parameter to the location on z/OS UNIX where
you want to store the JVM profiles used by the CICS region.
The
value that you specify can be up to 240 characters long.
The
supplied setting for the JVMPROFILEDIR system
initialization parameter is /usr/lpp/cicsts/cicsts52/JVMProfiles,
which is the installation location for the sample JVM profiles. This
directory is not a safe place to store your customized JVM profiles,
because you risk losing your changes if the sample JVM profiles are
overwritten when program maintenance is applied. So you must always
change JVMPROFILEDIR to specify a different z/OS® UNIX directory
where you can store your JVM profiles. Choose a directory where you
can give appropriate permissions to the users who must customize the
JVM profiles.
- Copy the supplied sample JVM profiles from their installation
location to the z/OS UNIX directory.
When
you install CICS, the sample
JVM profiles are placed in a zFS directory. This directory is specified
by the USSDIR parameter in the DFHISTAR installation
job. The default installation directory is /usr/lpp/cicsts/cicsts52/JVMProfiles.
Results
You have copied the sample JVM profiles to a zFS directory
and configured CICS to use that directory. The sample JVM profiles
contain default values so that you can use them immediately to set
up a JVM server.
What to do next
Ensure that CICS and Java have enough memory to run Java
applications, as described in Setting the memory limits for Java. You
must also ensure that the CICS region has access to the z/OS UNIX
directories where Java is installed and the Java applications are
deployed. For more information, see Giving CICS regions access to z/OS UNIX directories and files.