JVM server - JVMSERV
The JVM servers (JVMSERV) views display information about JVM servers in the CICS address space. The JVM requires a Language Environment enclave and a pool of T8 TCBs. Each task uses a T8 TCB to run as a pthread in the JVM. The runtime environment is represented in CICS by a resource called JVMSERVER. The JVMSERVER resource defines the runtime options for the JVM, including the location of the JVM profile and the maximum number of threads that the JVM supports.
Supplied views
To access from the main menu, click:
| View | Notes |
|---|---|
| JVM server EYUSTARTJVMSERV.DETAILED |
Detailed information about the selected JVM server. |
| JVM server EYUSTARTJVMSERV.DETAILED1 |
Detailed information about the JVM server resource signature. |
| JVM server EYUSTARTJVMSERV.DISABLE |
Disables a JVMSERVER. A JVMSERVER must be disabled before it can be discarded. |
| JVM server EYUSTARTJVMSERV.DISCARD |
Removes this JVMSERVER. A JVMSERVER definition must be disabled before it can be discarded. |
| JVM server EYUSTARTJVMSERV.ENABLE |
The JVMSERVER definition can be accessed by applications. |
| JVM server EYUSTARTJVMSERV.SET |
Set attributes according to values specified in input fields |
| JVM server EYUSTARTJVMSERV.TABULAR |
Tabular information about JVM servers. |
Actions
| Action | Description |
|---|---|
| DISABLE | Disables a JVMSERVER. A JVMSERVER must be disabled before it can be discarded. |
| DISCARD | Removes this JVMSERVER. A JVMSERVER definition must be disabled before it can be discarded. |
| ENABLE | The JVMSERVER definition can be accessed by applications. |
| SET | Set attributes according to values specified in input fields |
Fields
| Field | Attribute name | Description |
|---|---|---|
| BAS resource definition version | BASDEFINEVER | The BAS version number of this definition. |
| Last modification agent | CHANGEAGENT | The change agent identifier that made the last modification.
|
| Last modification agent release | CHANGEAGREL | The CICS release level of the agent that made the last modification to the resource definition. |
| Last modification time | CHANGETIME | The local date and time when the definition was last changed. |
| Last modification user ID | CHANGEUSRID | The user ID that made the last modification to the resource definition. |
| Current Heap size | CURRENTHEAP | The current size of the JVM heap |
| Source of the resource definition | DEFINESOURCE | The source of the definition, depending on which agent made the last change. |
| Creation time | DEFINETIME | The local date and time when the resource definition record was created on DFHCSD or EYUDREP. |
| Enable status | ENABLESTATUS | Indicates whether the JVMSERVER is enabled or not. Values are:
|
| The garbage collection policy | GCPOLICY | The garbage collection policy (algorithm) in use by this JVM |
| Initial Heap size | INITHEAP | The initial size of the JVM heap (Xms) |
| Installation agent | INSTALLAGENT | The install agent identifier that made the installation.
|
| Installation time | INSTALLTIME | The local date and time when the definition was installed. |
| Installation user ID | INSTALLUSRID | The user ID that installed the resource definition. |
| JVM profile name | JVMPROFILE | Specifies the 1- 8 character name of the JVM profile for the JVM server. The JVM profile is a file in the z/OS UNIX directory that is specified by the system initialization parameter JVMPROFILEDIR. |
| LE runtime options program | LERUNOPTS | Specifies the 1 - 8 character name of the program that defines the runtime options for the Language Environment. |
| Maximum Heap size | MAXHEAP | The maximum size of the JVM heap (Xmx) |
| JVM server name | NAME | Specifies the name of this JVMSERVER. The name can be up to eight characters in length. |
| Heap occupancy | OCCUPANCY | The heap occupancy (size of heap after last Garbage Collection) |
| Peak Heap size | PEAKHEAP | The peak heap size used by the JVM in the JVMSERVER |
| JVM process id | PID | The process id of the JVM running in the JVMSERVER |
| 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. |
| JVM creation time (GMT) | SRVCRTTMEGMT | The time at which the current JVM within the JVMSERVER was created (GMT) |
| JVM creation time (Local time) | SRVCRTTMELCL | The time at which the current JVM within the JVMSERVER was created (Local time) |
| Number of major garbage collection events | SRVGCMJRCNT | The number of times major garbage collection has run in the JVM |
| Total CPU used by major garbage collection | SRVGCMJRCPU | The total CPU spent in major garbage collection |
| Heap freed by major garbage collection | SRVGCMJRFRD | The amount of heap freed by major garbage collection |
| Number of minor garbage collection events | SRVGCMNRCNT | The number of times minor garbage collection has run in the JVM |
| Total CPU used by minor garbage collection | SRVGCMNRCPU | The total CPU spent in minor garbage collection |
| Heap freed by minor garbage collection | SRVGCMNRFRD | The amount of heap freed by minor garbage collection |
| JVM server system thread use count | SRVSYSTHCNT | The number of times the JVM server has used a system thread |
| Number of system thread waits | SRVSYSTHDWT | The number of tasks that waited for the system thread |
| Number of tasks waiting for a system thread | SRVSYSTHNWT | Current number of tasks waiting for a system thread |
| Peak number of waiting system threads | SRVSYSTHPWT | The peak number of tasks waiting for a system thread |
| Total system thread waiting time | SRVSYSTHWTT | Total time that tasks waited for a system thread |
| Current number of threads | SRVTHRCURR | Number of current JVM server threads |
| Peak number of threads | SRVTHRHWM | Peak number of JVM server threads |
| Number of thread waits | SRVTHRWAITS | The number of thread waits |
| Current number of waiting threads | SRVTHRWCURR | The number of current waiting threads |
| Peak number of waiting threads | SRVTHRWHWM | The peak number of waiting threads |
| Total thread waiting time | SRVTHRWTIME | Total thread waiting time |
| JVM server task count | SRVUSECOUNT | Total number of tasks that have been attached to run in this JVM server |
| Maximum number of threads | THREADLIMIT | Set the maximum number of threads that are allowed by CICS when calling the JVM. Each thread is attached using a T8 TCB. The valid range is 1-256 threads. |