Changes to JVM profiles

The settings in JVM profiles change between releases. This section summarizes the changes to JVM profile options, across supported CICS® releases.

The obsolete, changed, and new options in JVM profiles are summarized here. For more details about the options, see JVM profiles: options and samples. Note that the column for V4.1 is removed to give more space for the additional columns. There were no changes to JVM profiles in V4.1.

Table 1. New options in JVM profiles
Option V4.2 V5.1 V5.2 V5.3 V5.4
DFH_UMASK         Applies for the lifetime of the JVM server, not only during start-up.
CICS_WLP_MODE       TYPE: Liberty JVM server NEW: choose the level of integration between CICS and Liberty
CLASSPATH_PREFIX          
CLASSPATH_SUFFIX          
com.ibm.cics.jvmserver.override.ccsid   TYPE:All JVM Environments      
com.ibm.cics.jvmserver.unclassified.tranid       TYPE: Liberty JVM server and OSGi JVM server  
com.ibm.cics.jvmserver.unclassified.userid       TYPE: Liberty JVM server and OSGi JVM server  
com.ibm.cics.jvmserver.wlp.autoconfigure   TYPE: Liberty JVM server and OSGi JVM server      
com.ibm.cics.jvmserver.wlp.server.host   TYPE: Liberty JVM server      
com.ibm.cics.jvmserver.wlp.server.http.port   TYPE: Liberty JVM server      
com.ibm.cics.jvmserver.wlp.server.name   TYPE: Liberty JVM server      
com.ibm.cics.jvmserver.wlp.jdbc.driver.location   TYPE: Liberty JVM server      
JAVA_PIPELINE TYPE: Non OSGi (Axis 2)        
OSGI_BUNDLES TYPE: OSGi JVM server        
OSGI_CONSOLE TYPE: OSGi JVM server        
OSGI_FRAMEWORK_TIMEOUT TYPE: OSGi JVM server        
JNDI_REGISTRATION     TYPE: OSGi JVM server    
SECURITY_TOKEN_SERVICE TYPE: Non OSGi JVM server        
WSDL_VALIDATOR     TYPE: OSGi JVM server    
WLP_INSTALL_DIR   TYPE: Liberty JVM server      
WLP_OUTPUT_DIR   TYPE: Liberty JVM server      
WLP_USER_DIR   TYPE: Liberty JVM server      
Table 2. Changed and obsolete options in JVM profiles
Option Status CICS and Java™ launcher action Replace with Notes
&JVM_NUM Obsolete n/a n/a Pooled JVM option that is not supported in a JVM server.
-generate Obsolete n/a n/a Pooled JVM option that is not supported in a JVM server.
CICS_DIRECTORY Obsolete Java launcher uses the value of the USSHOME system initialization parameter USSHOME system initialization parameter Do not specify. CICS issues message DFHSJ0534 if found.
CICS_HOME Obsolete Java launcher uses the value of the USSHOME system initialization parameter USSHOME system initialization parameter Do not specify.
CLASSCACHE Obsolete n/a n/a Pooled JVM option that is not supported in a JVM server.
CLASSPATH Replaced by equivalents JVM does not start CLASSPATH_SUFFIX - For non OSGi server CICS issues message DFHSJ0523 if found.
ibm.jvm.shareable. application.class.path Obsolete CICS adds entries to standard classpath For non OSGi server Obsolete for Java 5 and later versions.
DISPLAY_JAVA_ VERSION   Accepted n/a Shows JVM version in CICS MSGUSR log.
GC_HEAP_THRESHOLD Obsolete n/a n/a Pooled JVM option that is not supported in a JVM server.
ibm.jvm.crossheap.events Obsolete Java launcher ignores n/a Pooled JVM option that is not supported in a JVM server.
ibm.jvm.events.output Obsolete Java launcher ignores n/a Pooled JVM option that is not supported in a JVM server.
ibm.jvm.reset.events Obsolete Java launcher ignores n/a Pooled JVM option that is not supported in a JVM server.
ibm.jvm.resettrace.events Obsolete Java launcher ignores n/a Pooled JVM option that is not supported in a JVM server.
ibm.jvm.unresettable. events.level Obsolete Java launcher ignores n/a Pooled JVM option that is not supported in a JVM server.
IDLE_TIMEOUT Obsolete n/a n/a Pooled JVM option that is not supported in a JVM server.
INVOKE_DFHJVMAT Obsolete n/a n/a Pooled JVM option that is not supported in a JVM server.
JAVA_DUMP_OPTS Withdrawn from sample profiles Accepted -Xdump Deprecated in Java 5.
LEHEAPSTATS Obsolete n/a n/a Pooled JVM option that is not supported in a JVM server.
LIBPATH Replaced by equivalents CICS treats as LIBPATH_ SUFFIX LIBPATH_SUFFIX (LIBPATH_PREFIX also available) CICS issues message DFHSJ0538 if found. You do not need to specify directories for base library path, only directories that you add.
MAX_RESETS_ TO_GC Obsolete n/a n/a Pooled JVM option that is not supported in a JVM server.
OSGI_BUNDLES Not supported in Liberty JVM server Liberty JVM server does not enable with this option n/a Deploy OSGi bundles in a Liberty JVM server as part of an enterprise bundle archive (EBA) or as library bundles.
REUSE Obsolete n/a n/a Pooled JVM option that is not supported in a JVM server.
TMPREFIX Obsolete CICS prefixes to standard class path CLASSPATH_PREFIX CICS issues message DFHSJ0521 if found. Move classes with care.
TMSUFFIX Obsolete CICS places on standard class path CLASSPATH_SUFFIX CICS issues message DFHSJ0522 if found.
VERBOSE Withdrawn from sample profiles Accepted -verbose:gc Works as before if specified in old format.
Xcheck (JVM default is NO) Withdrawn from sample profiles Accepted -Xcheck Specify this option only if other than JVM default.
Xdebug (JVM default is NO) Withdrawn from sample profiles Accepted -Xdebug (no value) to set debug on Specify this option only if other than JVM default.
Xnoclassgc (JVM default is NO) Withdrawn from sample profiles Accepted -Xnoclassgc (no value) to specify no class garbage collection Specify this option only if other than JVM default
Xresettable=YES Obsolete JVM does not start n/a Pooled JVM option that is not supported in a JVM server.
Xverify (JVM default is remote) Withdrawn from sample profiles Accepted n/a Do not specify, use JVM default.
Xinitacsh Obsolete Java launcher ignores Add value to -Xms Pooled JVM option that is not supported in a JVM server.
Xinitth Obsolete Java launcher ignores Add value to -Xms Pooled JVM option that is not supported in a JVM server.
Xinitsh Obsolete Java launcher ignores Add value to -Xms Pooled JVM option that is not supported in a JVM server.

Undocumented options

Table 2 lists only the options that were formerly used in the sample files that are supplied with CICS, together with the new options. Some options for JVM profiles and JVM properties files did not appear in the sample files that are supplied with CICS in previous CICS releases, but were documented in the CICS documentation. Some of these options are removed from the CICS documentation.

The java.compiler option is not documented because its primary use was to disable the Java just-in-time (JIT) compiler during the development process for applications in a resettable JVM. In a continuous JVM, this option is not required for that purpose.

The remaining undocumented options are still valid, but they can now be specified in the standard Java way (rather than in a special way for CICS), and so the documentation for the IBM® 64-bit SDK for z/OS®, Java Technology Edition and other Java documentation can be used. If you have any of these options in an existing JVM profile for CICS, they are still accepted.

The main categories of valid options that are not documented are as follows:
  • The options that relate to assertions. You can find more information about programming with assertions, and about activating or deactivating assertions, at the Oracle Technology Network Java website.
  • Various Java nonstandard options (beginning with -X), including -Xmaxe , -Xmaxf , -Xmine , -Xminf , -Xrundllname , and -Xrs . You can find more information about these options in the Java SDK documentation, which is available from Resource Information for Java.
  • Various JVM system properties, most of which must not be changed by users of the IBM JVM with CICS .

Changes to JVM profile symbols

&CONFIGROOT;
When you use this symbol in a JVM profile, the absolute path of the directory where the JVM profile is located is substituted at run time.
&JVMNUM;
This symbol is obsolete. If this symbol was used, for example, as part of the file name for a Java memory dump, CICS substituted the unique JVM number for it at run time. The symbol could be specified for any type of output from the JVM, and used in combination with the APPLID symbol (CICS region APPLID). The -generate option for stdout and stderr files provided the unique JVM number automatically.
&JVMSERVER;
When you use this symbol in a JVM profile, the name of the JVMSERVER resource is substituted at run time. Use this symbol to create unique output or dump files for each JVM server.
&USSHOME;
When you use this symbol in a JVM profile, the symbol is replaced with the value of the USSHOME system initialization parameter. Use this symbol to automatically pick up the home directory for z/OS UNIX where CICS supplies its libraries for Java and the Liberty technology.

For information about the other supported JVM profile symbols, see JVM profiles: options and samples.



jvmprofile_changes.html | Timestamp icon Last updated: Sunday, 4 June 2017