INQUIRE JVMPROFILE

Identify JVM profiles that have been used in a CICS region, and report their full path name and association with the shared class cache.

Read syntax diagramSkip visual syntax diagramINQUIRE JVMPROFILE
 
                                   .------------------------.
                                   V                        |
>>-INQUIRE JVMPROFILE(data-value)----+--------------------+-+--><
                                     +-HFSNAME(data-area)-+
                                     +-CLASSCACHEST(cvda)-+
                                     '-REUSEST(cvda)------'
 

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Description

The INQUIRE JVMPROFILE command retrieves the full path name of the HFS file for a JVM profile, and tells you whether or not a JVM with this profile uses the shared class cache.

INQUIRE JVMPROFILE can only find JVM profiles that have been used during the lifetime of this CICS region, for JVMs that can run applications. It does not find JVM profiles that have not been used, or JVM profiles that have only been used for the master JVM that initializes the shared class cache.

Browsing

You can browse through all of the JVM profiles that have been used in a CICS region by using the browse options (START, NEXT, and END) on INQUIRE JVMPROFILE commands. Note that INQUIRE JVMPROFILE commands do not support the AT option for browsing. In browse mode, the JVM profiles are returned in alphabetical order. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

Options

JVMPROFILE(data-value)
specifies the 8-character name of the JVM profile, as used in a program definition.

When you use the name of a JVM profile 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.

HFSNAME(data-area)
returns a 255-character area containing the full path name of the HFS file for the JVM profile.
CLASSCACHEST(cvda)
returns a CVDA value indicating whether JVMs that use this JVM profile are worker JVMs dependent on the shared class cache. CVDA values are:
CLASSCACHE
The JVM profile specifies the use of the shared class cache.
NOCLASSCACHE
The JVM profile does not specify the use of the shared class cache.
REUSEST(cvda)
returns a CVDA value indicating the level of reusability for JVMs that are created using this JVM profile. CVDA values are:
RESET
JVMs with this JVM profile are resettable.
REUSE
JVMs with this JVM profile are continuous.
NOREUSE
JVMs with this JVM profile are single-use.

Conditions

END
RESP2 values:
2
There are no more JVM profiles to browse.
ILLOGIC
RESP2 values:
1
A START has been given when a browse of JVM profiles is already in progress, or a NEXT or an END has been given without a preceding START.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
NOTFND
RESP2 values:
3
The named JVM profile was not found.
[[ Contents Previous Page | Next Page Index ]]