Configuring the JVM server profile

The task shows the steps that are required to configure the JVM.

About this task

The batch container runs in the CICS® JVM server environment and requires a JVM server profile that is configured for your environment.

Note: A profile that is configured for modern batch, must specify an EBCDIC code page:

-Dfile.encoding= Specifies the code page for reading and writing characters by the JVM. By default, a JVM on z/OS uses the EBCDIC code page IBM1047 (or cp1047).

By default, CICS searches the directory named by the CICS SIT parameter, JVMPROFILEDIR for a file named batchcontainer-config.xml. You can use a different zFS location for the batch container configuration file, by adding the option -Dcom.ibm.cics.batch.config to the JVM profile. For example: 
-Dcom.ibm.cics.batch.config=/u/cicsuser/batchfp/batchcontainer-config.xml

Two sample JVM profiles are supplied in the <install root>/batchfp/jvmprofiles. They are DFHBAT51 for v5.1, and DFHBAT42 for v4.2.

Procedure

  1. Copy the CICS supplied sample to the directory named in the JVMPROFILEDIR SIT parameter of the CICS region, and give it the name BATCHPRF. Customize BATCHPRF for your environment as described in JVM profiles: options and samples.
  2. Open the copied configuration file in an editor and replace the following parameters with their actual locations:
    • Substitute @java_dir@ for the location of your Java installation.
    • Substitute @batchinst@ for the location of the feature pack.
    • Substitute @db2inst@ for the location of your DB2 installation.
  3. Set the WORK_DIR parameter to a directory into which the JVM can read and write data.
    For example:
    WORK_DIR=/cicsbatch/workdir