INQUIRE JVM

Identify JVMs in a CICS® region and report their status.

Read syntax diagramSkip visual syntax diagramINQUIRE JVM
 
                            .-------------------------.
                            V                         |
>>-INQUIRE JVM(data-value)----+---------------------+-+--------><
                              +-AGE(data-area)------+
                              +-ALLOCAGE(data-area)-+
                              +-CLASSCACHEST(cvda)--+
                              +-EXECKEY(cvda)-------+
                              +-PHASINGOUTST(cvda)--+
                              +-PROFILE(data-area)--+
                              +-REUSEST(cvda)-------+
                              '-TASK(data-area)-----'
 

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

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

Description

The INQUIRE JVM command allows you to inquire on the status of a particular JVM, by specifying its JVM token. You can also use the browse function to browse through all of the JVMs in a CICS region, and to identify a JVM about which you want to inquire.

The INQUIRE JVM command does not find the master JVM that initializes the shared class cache. It only finds JVMs that are, or could be, allocated to tasks.

Browsing

You can browse through all of the JVMs in a CICS region by using the browse options (START, NEXT, and END) on the INQUIRE JVM command. The browse starts at the first JVM in the JVM pool, and moves through them in order of their JVM tokens. The browse guarantees that data for each JVM that exists prior to the first INQUIRE JVM NEXT command, and still exists after the last INQUIRE JVM NEXT command, is returned on exactly one INQUIRE JVM NEXT call. JVMs that are started while the browse is in progress can be found by the browse. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

Options

JVM(data-value)
specifies or returns the JVM token, a fullword binary value that identifies the JVM. This information is returned by an INQUIRE JVM browse, and you can then specify the JVM token for the JVM about which you want to inquire. Start of changeThe JVM token used in CICS is the same number that is used to identify the JVM in the z/OS® UNIX environment, where it is known as the process id (PID) for the JVM.End of change
AGE(data-area)
returns a fullword binary value giving the number of seconds since the JVM was initialized.
ALLOCAGE(data-area)
returns a fullword binary value giving the number of seconds for which the JVM has been allocated to its task, or zero if the JVM is not currently allocated to a task.
CLASSCACHEST(cvda)
returns a CVDA value indicating whether the JVM is a worker JVM dependent on the shared class cache. CVDA values are:
CLASSCACHE
The JVM profile for this JVM specified the use of the shared class cache.
NOCLASSCACHE
The JVM profile for this JVM did not specify the use of the shared class cache.
EXECKEY(cvda)
returns a CVDA value indicating the EXECKEY of the JVM. CVDA values are:
CICSEXECKEY
The JVM executes in CICS key.
USEREXECKEY
The JVM executes in user key.
PHASINGOUTST(cvda)
returns a CVDA value indicating whether the JVM is being phased out as a result of an EXEC CICS SET JVMPOOL TERMINATE or EXEC CICS PERFORM CLASSCACHE TERMINATE command (or the equivalent CEMT commands). CVDA values are:
PHASEOUT
The JVM is being phased out.
NOPHASEOUT
The JVM is not being phased out. It is available for allocation, or will be available for allocation when the current allocation is ended.
PROFILE(data-area)
returns the 8-character name of the profile used to initialize this JVM.
REUSEST(cvda)
returns a CVDA value indicating the level of reusability for this JVM. CVDA values are:
RESET
The JVM profile for this JVM specified that it is resettable (or in the case of a worker JVM, the JVM profile for the master JVM specified that the master and worker JVMs are resettable).
REUSE
The JVM profile for this JVM specified that it is continuous (or in the case of a worker JVM, the JVM profile for the master JVM specified that the master and worker JVMs are continuous).
NOREUSE
The JVM profile for this JVM specified that it is single-use.
TASK(data-area)
returns a 4-byte packed decimal value giving the task to which the JVM is allocated, or zero if the JVM is not currently allocated to a task.

Conditions

END
RESP2 values:
2
There are no more JVMs to browse.
ILLOGIC
RESP2 values:
1
A START has been given when a browse of JVMs 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:
4
The named JVM was not found
[[ Contents Previous Page | Next Page Index ]]