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:
| 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
| 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
| 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:
|
| 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. |