INQUIRE JVMPOOL

Retrieve information about the pool of JVMs in the CICS address space.

Read syntax diagramSkip visual syntax diagramINQUIRE JVMPOOL
 
>>-INQUIRE JVMPOOL--+-------------------------+----------------><
                    +-TOTAL(data-area)--------+
                    +-PHASINGOUT(data-area)---+
                    +-STATUS(data-area)-------+
                    +-JVMLVL0TRACE(data-area)-+
                    +-JVMLVL1TRACE(data-area)-+
                    +-JVMLVL2TRACE(data-area)-+
                    '-JVMUSERTRACE(data-area)-'
 

Conditions: NOTAUTH

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

Description

The INQUIRE JVMPOOL command returns information about the pool of JVMs in the CICS region. There can be only one pool of JVMs in a CICS region, therefore there is no name or identifier required on this command.

CICS determines the information you request from the actual JVMs that are started and pre-initialized in the CICS region.

Options

JVMLVL0TRACE(data-area), JVMLVL1TRACE(data-area), JVMLVL2TRACE(data-area), JVMUSERTRACE(data-area)
return a 240-character data value giving the current options for JVM tracing, which are used when the associated level of tracing has been activated using the CICS-supplied transaction CETR, the SET TRACETYPE command, or the system initialization parameter SPCTRSJ. Trace levels 29-32 for the SJ component correspond to JVMLVL0TRACE, JVMLVL1TRACE, JVMLVL2TRACE and JVMUSERTRACE respectively.
PHASINGOUT(data-area)
returns a fullword binary field giving the number of JVMs that are marked for removal from the JVM pool. These JVMs are still allocated to a task that is currently executing, or has executed, a Java program in the JVM.

When you issue an EXEC CICS SET JVMPOOL TERMINATE command (or the equivalent CEMT command), all the JVMs in the JVM pool are marked for removal. When you issue an EXEC CICS PERFORM CLASSCACHE TERMINATE command (or the equivalent CEMT command), all worker JVMs using the active shared class cache are marked for removal.

STATUS(cvda)
returns a CVDA indicating the overall status of the JVM pool. The CVDA values are:
ENABLED
The pool is enabled for use and Java programs can execute using JVMs from the pool. This is the normal status.
DISABLED
The pool is disabled, and new requests cannot be serviced from the pool. Programs can still be executing if they were started before the JVM pool became disabled.
TOTAL(data-area)
returns a fullword binary field giving the number of JVMs that have been initialized and are available for use or allocated to tasks. This total includes JVMs that are in the process of being terminated and removed from the region and included on the PHASINGOUT count.

Conditions

NOTAUTH
RESP2 value:
100
The user associated with the issuing task is not authorized to use this command.
[[ Contents Previous Page | Next Page Index ]]