JVM class cache - CLCACHE
The JVM class cache (CLCACHE) views display information about shared class caches for pooled JVMs in the CICS address space.
Supplied views
To access from the main menu, click:
| View | Notes |
|---|---|
| JVM class cache EYUSTARTCLCACHE.DETAILED |
Detailed information about a selected class cache. |
| JVM class cache EYUSTARTCLCACHE.FORCEPURGE |
Stop and delete the selected shared class cache. All tasks using pooled JVMs dependent on the shared class cache are terminated by the FORCEPURGE mechanism, and the pooled JVMs are terminated. No more JVMs can use the shared class cache, and it is deleted when all the pooled JVMs that were dependent on it have been terminated. |
| JVM class cache EYUSTARTCLCACHE.PHASEOUT |
Stop and delete the selected shared class cache. All pooled JVMs using the shared class cache are marked for deletion. The JVMs are actually deleted when they finish running their current Java programs. No more JVMs can use the shared class cache, and it is deleted when all the pooled JVMs that were dependent on it have been terminated. |
| JVM class cache EYUSTARTCLCACHE.PURGE |
Stop and delete the selected shared class cache. All tasks using pooled JVMs dependent on the shared class cache are terminated by the PURGE mechanism, and the pooled JVMs are terminated. No more JVMs can use the shared class cache, and it is deleted when all the pooled JVMs that were dependent on it have been terminated. |
| JVM class cache EYUSTARTCLCACHE.RELOAD |
Reload the selected shared class cache. Perform this operation to create a new class cache when the status of the shared class cach is STARTED (the option works only if the shared class cache has been started). If newer versions of Java classes are available to be loaded, the new class cache uses them. However, pooled JVMs, both those that are already allocated to tasks and those that are allocated to tasks after you issue the command, continue to use the existing shared class cache and the old versions of the Java classes until the new shared class cache is ready. When the new shared class cache is ready, subsequent requests for pooled JVMs are given a pooled JVM that uses the new cache. These new pooled JVMs are started as they are requested by applications, and they replace the pooled JVMs that are using the old shared class cache. The pooled JVMs that are using the old shared class cache are allowed to finish running their current Java programs, and then they are terminated. The old shared class cache is deleted when all the pooled JVMs that are dependent on it have been terminated. |
| JVM class cache EYUSTARTCLCACHE.START |
Start the selected shared class cache. Perform this operation to create a new class cache when the status of the shared class cache is STOPPED. |
| JVM class cache EYUSTARTCLCACHE.TABULAR |
Tabular information about shared class caches in the CICS address space. |
Actions
| Action | Description |
|---|---|
| FORCEPURGE | Stop and delete the selected shared class cache. All tasks using pooled JVMs dependent on the shared class cache are terminated by the FORCEPURGE mechanism, and the pooled JVMs are terminated. No more JVMs can use the shared class cache, and it is deleted when all the pooled JVMs that were dependent on it have been terminated. |
| PHASEOUT | Stop and delete the selected shared class cache. All pooled JVMs using the shared class cache are marked for deletion. The JVMs are actually deleted when they finish running their current Java programs. No more JVMs can use the shared class cache, and it is deleted when all the pooled JVMs that were dependent on it have been terminated. |
| PURGE | Stop and delete the selected shared class cache. All tasks using pooled JVMs dependent on the shared class cache are terminated by the PURGE mechanism, and the pooled JVMs are terminated. No more JVMs can use the shared class cache, and it is deleted when all the pooled JVMs that were dependent on it have been terminated. |
| RELOAD | Reload the selected shared class cache. Perform this operation to create a new class cache when the status of the shared class cach is STARTED (the option works only if the shared class cache has been started). If newer versions of Java classes are available to be loaded, the new class cache uses them. However, pooled JVMs, both those that are already allocated to tasks and those that are allocated to tasks after you issue the command, continue to use the existing shared class cache and the old versions of the Java classes until the new shared class cache is ready. When the new shared class cache is ready, subsequent requests for pooled JVMs are given a pooled JVM that uses the new cache. These new pooled JVMs are started as they are requested by applications, and they replace the pooled JVMs that are using the old shared class cache. The pooled JVMs that are using the old shared class cache are allowed to finish running their current Java programs, and then they are terminated. The old shared class cache is deleted when all the pooled JVMs that are dependent on it have been terminated. |
| SET | Set the status of autostart for the shared class cache. |
| START | Start the selected shared class cache. Perform this operation to create a new class cache when the status of the shared class cache is STOPPED. |
Fields
| Field | Attribute name | Description |
|---|---|---|
| Autostart status | AUTOSTARTST | The status of autostart for the shared class cache. The values are:
|
| Amount in bytes of free space within the cache | CACHEFREE | The amount of free space in the shared class cache, in bytes. |
| Size of the class cache in bytes | CACHESIZE | If the status of the shared class cache is Starting or Started, this is the size of the current shared class cache. If the status of the shared class cache is the shared class cache is Reloading, this is the size of the new shared class cache that is being loaded. |
| JVM requests - class cache | JVMREQSCACHE | The total number of Java programs which requested a JVM that uses the shared class cache. |
| Number of class caches waiting for JVMs to terminate | OLDCACHES | The number of old shared class caches that are still present in the region because they are waiting for pooled JVMs that are dependent on them to be phased out. If the status of the current shared class cache is Stopped, and pooled JVMs are still dependent on it, then that shared class cache is included in the number of old shared class caches. |
| Peak pooled (class cache) JVMs | PEAKCACHEJVM | The peak number of JVMs in the JVM pool that used the shared class cache. |
| Number of JVMs being phased-out | PHASINGOUT | The number of pooled JVMs that are dependent on an old shared class cache, and are being phased out. If the status of the current shared class cache is Stopped, then any pooled JVMs that are still dependent on it are included in the number of pooled JVMs being phased out. |
| Profile used to start or used to reload the cache | PROFILE | Applies only to releases earlier than CICS Transaction Server for z/OS Version 4 Release 1. PROFILE is obsolete in later releases. If the status of the shared class cache is Stopped, this displays the eight-character name of the JVM profile that will be used for a master JVM to start the shared class cache. If the status of the shared class cache is Started, Starting or Reloading, this displays the eight-character name of the JVM profile that was used for the last valid request to start or reload the shared class cache. This name is displayed even if the shared class cache fails to start or reload. The displayed JVM profile is used next time you issue the command to start or reload the shared class cache, unless you specify a different JVM profile using the Profile option. |
| JVM reuse status | REUSEST | For CICS TS 3.2 and later regions, the master JVM that initializes the shared class cache is always a continuous
(reusable) JVM. This option indicates the reuse status of the master JVM as follows:
|
| The time that the class cache was started | STARTTIME | The date and time when the current shared class cache was started. This time is expressed as local time. |
| Class cache status | STATUS | The status of the current shared class cache. The values are:
|
| Number of JVMs dependent on the class cache | TOTALJVMS | The number of pooled JVMs in the CICS region that are dependent on a shared class cache. This includes both the pooled JVMs that are dependent on the current shared class cache, and any pooled JVMs that are dependent on an old shared class cache and are being phased out. |