JVM pool - JVMPOOL

The Java virtual machine (JVM) pool (JVMPOOL) views display information about the pool of JVMs in the CICS address space.

Supplied views

To access from the main menu, click:

CICS operations views > Enterprise Java component operations views > JVM pool

Table 1. Views in the supplied JVM pool (JVMPOOL) view set
View Notes
JVM pool

EYUSTARTJVMPOOL.DETAIL1

Detailed trace control information about a selected JVM pool.
JVM pool

EYUSTARTJVMPOOL.DETAIL2

Detailed pool statistics information about a selected JVM pool.
JVM pool

EYUSTARTJVMPOOL.DETAILED

Detailed general information about a selected JVM pool.
JVM pool

EYUSTARTJVMPOOL.DISABLE

Set the selected pool status to disabled, preventing new requests from being serviced from the pool. Programs that were started before the command was issued are allowed to execute to completion.
JVM pool

EYUSTARTJVMPOOL.ENABLE

Set the selected pool status to enabled for use so that Java programs can execute using JVMs from the pool.
JVM pool

EYUSTARTJVMPOOL.FORCEPURGE

Terminate tasks using JVMs by the SET TASK FORCEPURGE mechanism, and terminate the JVMs. If you do not specify a JVM profile, all JVMs in the pool are terminated. For CICS TS 3.2 and later regions, you can specify a JVM profile to limit termination to JVMs with that profile.
JVM pool

EYUSTARTJVMPOOL.PHASEOUT

Mark JVMs for deletion when they finish running their current Java program. If you do not specify a JVM profile, all JVMs in the pool are marked for deletion. For CICS TS 3.2 and later regions, you can specify a JVM profile to limit termination to JVMs with that profile.
JVM pool

EYUSTARTJVMPOOL.PURGE

Terminate all tasks using JVMs by the SET TASK PURGE mechanism, and terminate the JVMs. If you do not specify a JVM profile, all JVMs in the pool are terminated. For CICS TS 3.2 and later regions, you can specify a JVM profile to limit termination to JVMs with that profile.
JVM pool

EYUSTARTJVMPOOL.SET

Set the status of the selected JVM pool.
JVM pool

EYUSTARTJVMPOOL.START

Initialize the JVMPOOL using the START option. You specify a number of JVMs to be started for a JVM profile. You also specify the execution key for the JVMs.
JVM pool

EYUSTARTJVMPOOL.TABULAR

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

Actions

Table 2. Actions available for JVMPOOL views
Action Description
DISABLE Set the selected pool status to disabled, preventing new requests from being serviced from the pool. Programs that were started before the command was issued are allowed to execute to completion.
ENABLE Set the selected pool status to enabled for use so that Java programs can execute using JVMs from the pool.
FORCEPURGE Terminate tasks using JVMs by the SET TASK FORCEPURGE mechanism, and terminate the JVMs. If you do not specify a JVM profile, all JVMs in the pool are terminated. For CICS TS 3.2 and later regions, you can specify a JVM profile to limit termination to JVMs with that profile.
PHASEOUT Mark JVMs for deletion when they finish running their current Java program. If you do not specify a JVM profile, all JVMs in the pool are marked for deletion. For CICS TS 3.2 and later regions, you can specify a JVM profile to limit termination to JVMs with that profile.
PURGE Terminate all tasks using JVMs by the SET TASK PURGE mechanism, and terminate the JVMs. If you do not specify a JVM profile, all JVMs in the pool are terminated. For CICS TS 3.2 and later regions, you can specify a JVM profile to limit termination to JVMs with that profile.
SET Set the status of the selected JVM pool.
START Initialize the JVMPOOL using the START option. You specify a number of JVMs to be started for a JVM profile. You also specify the execution key for the JVMs.

Fields

Table 3. Fields in JVMPOOL views
Field Attribute name Description
JVM LVL0 Trace control JVMLVL0TRACE The default option for JVM Level 0 trace, corresponding to trace level 29 of the SJ component. The default setting for this level of tracing maps to trace point level 0 for JVMs, which is reserved for extraordinary events and errors. Unlike CICS exception trace, which cannot be switched off, the JVM Level 0 trace is normally switched off unless JVM tracing is required.
JVM LVL1 Trace control JVMLVL1TRACE The default option for JVM Level 1 trace, corresponding to trace level 30 of the SJ component. The default setting for this level of tracing maps to trace point level 1 for JVMs.
JVM LVL2 Trace control JVMLVL2TRACE The default option for JVM Level 2 trace, corresponding to trace level 31 of the SJ component. The default setting for this level of tracing maps to trace point level 2 for JVMs.
JVM USER Trace control JVMUSERTRACE The default option for JVM user trace, corresponding to trace level 32 of the SJ component.
Number of Java virtual machines (JVM) for removal PHASINGOUT 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. JVMs are marked for removal as a result of a JVMPOOL Phaseout, Purge or Forcepurge action or as a result of a CLCACHE Phaseout, Purge or Forcepurge action.
JVM profile directory PROFILEDIR The name of the z/OS UNIX directory that contains the JVM profiles in CICS. This value is taken from the JVMPROFILEDIR system initialization parameter.
Current pooled (class cache) JVMs SJGCURRCACHE The number of JVMs currently in the pool that use the shared class cache, so are pooled JVMs. JVMs use the shared class cache if they were created using JVM profiles that specify CLASSCACHE=YES. This count includes both pooled JVMs that are in use by a Java program, and pooled JVMs that are awaiting reuse.
Number of current JVMs SJGCURRJVMS The current number of JVMs in the JVM pool.
Peak pooled (class cache) JVMs SJGPEAKCACHE The peak number of JVMs in the JVM pool that used the shared class cache.
Peak number of JVMs SJGPEAKJVMS The peak number of JVMs in the JVM pool.
JVM requests - class cache SJGREQSCACHE The total number of Java programs which requested a JVM that uses the shared class cache.
Number of JVM requests with JVM initialised SJGREQSINIT The number of JVM program requests where the JVM was initialized.
Number of JVM requests with JVM mismatch SJGREQSMISMA The number of JVM program requests that required a reusable (continuous) JVM, but for which there was no JVM already initialized with the same JVM profile.
Number of JVM requests with JVM reset SJGREQSRESET Number of requests to run a program in a resettable JVM. This field is not applicable for CICS TS 3.2 and later regions.
Number of JVM requests with JVM reuse SJGREQSREUSE The number of requests to run a program in a continuous JVM.
Number of JVM requests with JVM terminated SJGREQSTERMI The number of JVMs that have been terminated.
Total number of JVM program requests SJGREQSTOTAL The total number of requests to run a Java program in a JVM.
Status of Java virtual machine (JVM) pool STATUS The status of the JVM pool:
  • 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.
Number of pre-initialized Java virtual machines TOTAL 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.


eyua313.html | Timestamp icon Last updated: Sunday, 4 June 2017