JVMSERVER attributes

Describes the syntax and attributes of the JVMSERVER resource.

JVMSERVER(name)

Specifies the 1 - 8 character name of the JVMSERVER resource.

Acceptable characters: `A-Z a-z 0-9 $ @ # . - _ % ? ! : \| = , ;`

It is preferable not to use names that start with DFH because these characters are reserved for use by CICS® for PROGRAM, FILE and JVMSERVER. CICS can delete or discard them and replace them with CICS resources when you upgrade or provide new function or fixes. For PROGRAM and FILE, the DFH limit is policed when you are creating in a bundle, and issues a warning when you are creating it online. For JVMSERVER, there is no DFH limit and no warning when you are creating in a bundle, or when you are creating it online.

DESCRIPTION(text)

In this field, you can provide a description of the resource that you are defining. The description text can be up to 58 characters in length. No restrictions apply to the characters that you can use. However, if you use parentheses, ensure that each left parenthesis has a matching right one. If you use the CREATE command, for each single apostrophe in the text code, use two apostrophes.

GROUP(groupname)

Every resource definition must have a GROUP name. The resource definition becomes a member of the group and is installed in the CICS system when the group is installed.

Acceptable characters: `A-Z 0-9 $ @ #` Any lowercase characters that you enter are converted to uppercase.

The GROUP name can be up to 8 characters in length.

JVMPROFILE(jvmprofile)

Specifies the 1 - 8 character name of the JVM profile containing the JVM options for running a JVM server. The file containing the JVM profile must have a file extension of .jvmprofile. Start of change

For a JVM profile for a JVMSERVER resource defined by online resource definition, the file path is specified by the system initialization parameter JVMPROFILEDIR.
For a JVM profile for a JVMSERVER resource that is defined in a CICS bundle, the file path is relative to the root directory of the CICS bundle. The file containing the JVM profile must be packaged in the CICS bundle with the JVMSERVER resource. For more information, see Referencing zFS artifacts in a bundle.

The JVM profile name cannot consist of a single or double period. The set of acceptable characters in the JVM profile name is more restricted when the JVMSERVER resource is defined in a CICS bundle using CICS Explorer®.

Acceptable characters for JVMPROFILE name in an online JVMSERVER resource: `A-Z a-z 0-9 @ # . - _ % & ? ! : \| " = , ; < >`

Acceptable characters for JVMPROFILE name in a JVMSERVER resource definition in a CICS bundle: `A-Z a-z 0-9 @ # - _ % ! =`

LERUNOPTS(DFHAXRO|program)

Specifies the 1 - 8 character name of the program that defines the runtime options for the Language Environment® enclave. DFHAXRO is a supplied program that provides a set of default values. The source for DFHAXRO is in the hlq.SDFHSAMP library if you want to change the defaults for any of the Language Environment runtime options.

If you want to use a different program, put the program in the hlq.SDFHLOAD library and specify the program name in uppercase characters.

STATUS(ENABLED|DISABLED)

Specifies the initial status of the JVMSERVER resource when it is installed.

ENABLED: The JVM server runtime environment is available for use.
DISABLED: The JVM server runtime environment is not available for use.

THREADLIMIT(15|number)

Specifies the maximum number of threads that are allowed in the Language Environment enclave for the JVM server. Each thread runs under a T8 TCB. You can specify a limit in the range of 1 - 256 threads.

If you specify a thread limit that exceeds the maximum of 2000 threads that is allowed for the CICS region, taking into account all other enabled and disabled JVMSERVER resources, CICS allocates the remaining threads up to 2000 to the resource as the thread limit value. If CICS is already at the maximum number of JVMSERVER threads, the resource installs in a disabled state.