Identify JVMs in a CICS® region and report their status.
INQUIRE 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).
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.
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.