The name of a JVM profile can be up to 8 characters in length. The name of a JVM properties file can be any length, but for ease of use, choose either the name of the JVM profile that references it, or another short name.
The name of a JVM profile or JVM properties file can include the following characters:
A-Z a-z 0-9 @ # . - _ % &
$
? ! : | " = , ; < >
When creating your own JVM profile or JVM properties file, do not give it a name beginning with DFH, because these characters are reserved for use by CICS®.
As JVM profiles and JVM properties files are HFS files, case is important. When you specify the name of a JVM profile or JVM properties file anywhere in CICS, you must enter it using the same combination of upper and lower case characters that is present in the HFS file name. The CEDA panels accept mixed case input for the JVMPROFILE field irrespective of your terminal's UCTRAN setting. However, this does not apply when values for this field are supplied on the CEDA command line, or when you are using another CICS transaction such as CEMT or CECI. If you need to enter the name of a JVM profile in mixed case when you use CEDA from the command line or when you use another CICS transaction, ensure that the terminal you use is correctly configured, with upper case translation suppressed.
Options in a JVM profile, or system properties in a JVM properties file, take the form of a keyword and value separated by an = sign. For example:
VERBOSE=NO
ibm.jvm.events.output=event.log
Each JVM option or system property is therefore a name and value element pair.
Only the JVM options listed in Options in JVM profiles are recognized by CICS for use in a JVM profile. However, there is no such restriction for a JVM properties file. CICS passes all the system properties in a JVM properties file to the JVM unchanged. You should bear in mind that only the system properties described in the CICS documentation are supported by CICS, although the JVM can support a much wider range of system properties. System properties for JVMs documents the system properties that are particularly relevant for JVMs in a CICS environment, including some which are defined by CICS. Persistent Reusable Java Virtual Machine User's Guide, SC34-6201, lists command-line options, JVM options and system properties that are used in a persistent reusable JVM in a z/OS® environment, some of which are provided in a different format by options in the JVM profile in CICS. The IBM® Developer Kit and Runtime Environment, Java 2 Technology Edition, Version 1.4.2 Diagnostics Guide, SC34-6358, which is available to download from www.ibm.com/developerworks/java/jdk/diagnosis/ documents other system properties that are used for JVM trace and problem determination. The Java™ class libraries include other system properties, and applications might have their own system properties. There is no central repository of all system properties for the JVM.
Follow these rules when coding JVM profiles and JVM properties files:
LIBPATH=\
/usr/lpp/cicsts/cicsts31/lib:\
/usr/lpp/cicsts/cicsts31/ctg:\
/usr/lpp/java142/J1.4/bin:\
/usr/lpp/java142/J1.4/bin/classic
# Uncomment the following line to specify a classpath
# for Java classes that are CICS programs or Corba
# applications, but not EJB jars.
#
# ibm.jvm.shareable.application.class.path=user.jar:user.directory
JVM profiles and JVM properties files can also contain blank lines, which are also ignored. You can use blank lines as a separator between options or groups of options.
Escape sequence | Character value |
---|---|
\b | Backspace |
\t | Horizontal tab |
\n | Newline |
\r | Carriage return |
\" | Double quote |
\' | Single quote |
\\ | Backslash |
\xxx | The character corresponding to the octal value xxx, where xxx is between 000 and 377 |
\uxxxx | The Unicode character with encoding xxxx, where xxxx is one to four hexadecimal digits (see note below for more information). |
Xms=6291456
Xms=6144K
Xms=6M