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:

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

Table 1. Views in the supplied JVM server (JVMSERV) view set
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

Table 2. Actions available for JVMSERV views
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

Table 3. Fields in JVMSERV views
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.
  • CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CSDBATCH - The resource was last changed by a DFHCSDUP job.
  • DREPAPI - The resource was last changed by a CICSPlex SM BAS API command.
  • DREPBATCH - The resource was last changed by a CICSPlex SM utility.
  • CREATESPI - The resource was last changed by an EXEC CICS CREATE command.
  • NOTAPPLIC - This is not applicable for this resource.
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:
  • DISABLED
    • Disable the JVMSERVER resource. CICS finishes processing any requests and then stops the JVM and the Language Environment enclave.
  • ENABLED
    • Enable the JVMSERVER resource. CICS creates a Language Environment enclave and starts a JVM.
  • DISABLING
    • The JVMSERVER resource is disabling.
  • ENABLING
    • The JVMSERVER resource is enabling.
  • DISCARDING
    • The JVMSERVER resource is discarding.
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.
  • CSDAPI - The resource was installed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CREATESPI - The resource was installed by an EXEC CICS CREATE command.
  • GRPLIST - The resource was installed by GRPLIST INSTALL.
  • BUNDLE - The resource was installed by a bundle deployment.
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.


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