CEMT INQUIRE JVMSERVER

Retrieve information about the status of a JVM server runtime environment.

In the CICS Explorer, the JVM servers operations view provides a functional equivalent to this command.

The resource signature

You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.

Input

Press the Clear key to clear the screen and then enter CEMT INQUIRE JVMSERVER to obtain information about a JVM server.

CEMT INQUIRE JVMSERVER

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE JVMSERVER ALL( value)ENABLEDDISABLEDJVMPROFILE( filename)PROFILEDIR( directory)LERUNOPTS( program)THREADCOUNT( number)THREADLIMIT( number)CURRENTHEAP( number)INITHEAP( number)MAXHEAP( number)GCPOLICY( value)OCCUPANCY( number)PID( number)INSTALLTIME( date time)INSTALLUSRID( value)CREATESPICSDAPIGRPLISTDEFINESOURCE( value)DEFINETIME( date time)CHANGETIME( date time)CHANGEUSRID( value)CREATESPICSDAPICSDBATCHDREPAPICHANGEAGREL( value)

Displayed fields

CHANGEAGENT(value)
Displays a value that identifies the agent that made the last change to the resource definition. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:
CREATESPI
The resource definition was last changed by an EXEC CICS CREATE command.
CSDAPI
The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
CSDBATCH
The resource definition was last changed by a DFHCSDUP job.
DREPAPI
The resource definition was last changed by a CICSPlex SM BAS API command.
CHANGEAGREL(value)
Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.
CHANGETIME(date time)
Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
CHANGEUSRID(value)
Displays the 8-character user ID that ran the change agent.
CURRENTHEAP(number)
Displays the current heap size in bytes that is allocated to the JVM server.
DEFINESOURCE(value)
Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.
DEFINETIME(date time)
Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
ENABLESTATUS(value)
Displays the overall status of the JVM server runtime environment. The possible values are as follows:
ENABLED
The JVM server is enabled and can perform processing.
DISABLED
The JVM server is disabled and new requests cannot be processed in the runtime environment.
Note: CEMT will display BEING ENABLED, BEING DISABLED, or BEING DISCARDED in the top right corner if the JVMSERVER is transitioning between states.
GCPOLICY(value)
Displays the garbage collection policy that is being used by the JVM server.
INITHEAP(number)
Displays the initial heap size in bytes that is allocated to the JVM server.
INSTALLAGENT(value)
Displays a value that identifies the agent that installed the resource. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:
BUNDLE
The resource was installed by a bundle deployment.
CREATESPI
The resource was installed by an EXEC CICS CREATE command.
CSDAPI
The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
GRPLIST
The resource was installed by GRPLIST INSTALL.
INSTALLTIME(date time)
Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
INSTALLUSRID(value)
Displays the 8-character user ID that installed the resource.
JVMPROFILE(filename)
Displays the file name of the JVM profile that defines the properties of the JVM server.
LERUNOPTS(program)
Displays the name of the program that defines the runtime options for the Language Environment® enclave.
MAXHEAP(number)
Displays the maximum heap size in bytes that is allowed in the JVM server.
OCCUPANCY(number)
Displays the heap size in bytes after the last garbage collection ran in the JVM server.
PID(number)
Displays the process ID (PID) of the JVM.
PROFILEDIR(directory)
Displays the directory on z/OS® UNIX that contains the JVM profile for the JVM server. For a JVM server that is defined in a local CICS® region, which uses a JVM profile stored in the local CICS region, this is the directory specified by the JVMPROFILEDIR system initialization parameter for the CICS region. For a JVM server that is defined in a CICS bundle, which uses a JVM profile packaged in the CICS bundle, this is the CICS bundle subdirectory where the JVM profile is stored.
THREADCOUNT(number)
Displays the number of threads that are currently running inside the JVM server.
THREADLIMIT(number)
Displays the maximum number of threads that can be used by the JVM server. Each thread runs under a T8 TCB.