INQUIRE JVMSERVER

Description

Browsing

You can browse through all the JVMSERVER resources that are installed in the region, using the browse options (START, NEXT, and END) on INQUIRE JVMSERVER commands.

See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

The resource signature

You can use this command to retrieve 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 BUNDLE, 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.

Options

CHANGEAGENT(cvda)

Returns a CVDA value that identifies the agent that made the last change to the resource definition. 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(data-area)

Returns a 4-digit number of the CICS release that was running when the resource definition was last changed.

CHANGETIME(data-area)

Returns an ABSTIME value that represents the time stamp when the resource definition was last changed. For more information about the format of the ABSTIME value, see FORMATTIME.

CHANGEUSRID(data-area)

Returns the 8-character user ID that ran the change agent.

CURRENTHEAP(data-area)

Returns a doubleword binary value indicating the current size of the heap in bytes that is allocated to the JVM server.

DEFINESOURCE(data-area)

Returns the 8-character source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT value. For more information, see Summary of the resource signature field values.

DEFINETIME(data-area)

Returns an ABSTIME value that represents the time stamp when the resource definition was created.

ENABLESTATUS(cvda)

Returns a CVDA value indicating the overall status of the JVM server. The CVDA values are as follows:

ENABLED

The JVM server has started and is enabled for use.

ENABLING

The JVM server is starting.

DISABLED

The JVM server is stopped and any new requests cannot be processed.

DISABLING

The JVM server is stopping. Threads can still be running if they were started before the JVM server was stopped.

DISCARDING

The JVMSERVER resource is being discarded.

GCPOLICY(data-area)

Returns a 32-character value indicating the garbage collection policy that is being used by the JVM server.

INITHEAP(data-area)

Returns a doubleword binary value that indicates the initial size of the heap in bytes that is allocated to the JVM server. This value is set by the -Xms option in the JVM profile.

INSTALLAGENT(cvda)

Returns a CVDA value that identifies the agent that installed the resource. 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(data-area)

Returns an ABSTIME value that represents the time stamp when the resource was installed.

INSTALLUSRID(data-area)

Returns the 8-character user ID that installed the resource.

JVMPROFILE(data-area)

Returns the 1-8 character profile name of the JVM server.

JVMSERVER(data-value)

Specifies the name of the JVMSERVER resource about which you are inquiring. The name can be up to 8 characters in length.

LERUNOPTS(data-area)

Returns the 1-8 character name of the program that defines the runtime options for the Language Environment enclave.

MAXHEAP(data-area)

Returns a doubleword binary value that indicates the maximum size of the heap in bytes that is allocated to the JVM server. This value is set by the -Xmx option in the JVM profile.

OCCUPANCY(data-area)

Returns a doubleword binary value that indicates the size of the heap in bytes after the last garbage collection ran in the JVM server.

PID(data-area)

Returns a fullword value that indicates the process ID (PID) of the JVM.

PROFILEDIR(data-area)

Returns a 240-character data value of 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, the value is the directory specified by the JVMPROFILEDIR system initialization parameter 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, the value is the CICS bundle subdirectory where the JVM profile is stored.

THREADCOUNT(data-area)

Returns a fullword binary value giving the number of threads that are currently running inside the JVM server.

THREADLIMIT(data-area)

Returns a fullword binary value giving the number of threads that are allowed in the Language Environment enclave for the JVM server. Each thread runs under a T8 TCB.

Conditions

END

RESP2 values:

2

There are no more resource definitions of this type.

ILLOGIC

RESP2 values:

1

You have issued a START command when a browse of this resource type is already in progress, or you have issued a NEXT or an END command when a browse of this resource type is not in progress.

NOTAUTH

RESP2 values:

100

The user associated with the issuing task is not authorized to use this command.

101

The user associated with the issuing task is not authorized to access this particular resource in the way required by this command.

NOTFND

RESP2 values:

3

The JVMSERVER resource cannot be found.