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.
| Option | V3.2 | V4.1 | V4.2 | V5.1 | V5.2 | V5.3 |
|---|---|---|---|---|---|---|
| CICS_WLP_MODE | TYPE: Liberty JVM servers | |||||
| CLASSPATH_PREFIX |
|
|||||
| CLASSPATH_SUFFIX |
|
|||||
| com.ibm.cics.jvmserver.override.ccsid |
|
|||||
| com.ibm.cics.jvmserver.unclassified.tranid |
|
|||||
| com.ibm.cics.jvmserver.unclassified.userid |
|
|||||
| com.ibm.cics.jvmserver.wlp.autoconfigure |
|
|||||
| com.ibm.cics.jvmserver.wlp.server.host |
|
|||||
| com.ibm.cics.jvmserver.wlp.server.http.port |
|
|||||
| com.ibm.cics.jvmserver.wlp.server.name |
|
|||||
| com.ibm.cics.jvmserver.wlp.jdbc.driver.location |
|
|||||
| DISPLAY_JAVA_VERSION |
|
|||||
| JAVA_DUMP_ TDUMP_PATTERN |
|
|||||
| JAVA_PIPELINE |
|
|||||
| LIBPATH_PREFIXX |
|
|||||
| LIBPATH_SUFFIX |
|
: | ||||
| PURGE_ESCALATION_TIMEOUT | NEW with APAR, compatible with: All JVM Environments | |||||
| OSGI_BUNDLES |
|
|||||
| OSGI_CONSOLE |
|
|||||
| OSGI_FRAMEWORK_ TIMEOUT |
|
|||||
| JNDI_REGISTRATION |
|
|||||
| SECURITY_TOKEN_SERVICE |
|
|||||
| WSDL_VALIDATOR |
|
|||||
| WLP_INSTALL_DIR |
|
|||||
| WLP_OUTPUT_DIR |
|
|||||
| WLP_USER_DIR |
|
| 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. |
| 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
stdoutandstderrfiles 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.