Liberty: Modify commands on z/OS

On the z/OS® platform, you can modify Liberty by using MVS™ operator commands that are supported by a Liberty server process or that are supported by the Angel process.

MODIFY commands that are supported by a Liberty server process

Display information about interrupted requests

You can display summary or detailed information about all interrupted requests, interrupted requests that are timed out, and interrupted requests that are older than a specified number of seconds. Or, you can display detailed information about a particular request.

To display information about interrupted requests, use the following command:

MODIFY [jobname.]identifier,display,interrupts,<parameters>
Valid parameters are:
  • details - Use to display information about interrupted requests.

    The following command displays detailed information about interrupted requests:
    f BBOS001,display,interrupts,details
  • age=<value> - Use to display information about requests that are older than the value specified.

    The following command displays summary information about the requests that are older than 30 seconds:
    f BBOS001,display,interrupts,age=30
    The following command displays detailed information about the requests that are older than 20 seconds:
    f BBOS001,display,interrupts,age=20,details
  • timedout - Use to display information about the requests that are currently considered to be hung.

    The following command displays summary information about the requests that are currently considered to be hung:
    f BBOS001,display,interrupts,timedout
    The following command displays detailed information about the requests that are currently considered to be hung.
    f BBOS001,display,interrupts,timedout,details
  • request=<value> - Use to display detailed information about the specified request.

    The following command displays detailed information about request ABcdE1+fgH_JJ.
     f BBOS001,display,interrupts,request='ABcdE1+fgH_JJ'

If you do not specify any parameters, summary information about all interrupted requests is displayed.

Trace enablement

The following example shows the MODIFY command to enable tracing for the specified Liberty server:

MODIFY [jobname.]identifier,LOGGING='<trace_specification>'

Substitute the value trace_specification for a valid trace specification. For more information, see Liberty: Logging and Trace.

Transaction dumps
The following example shows the MODIFY command to request a transaction dump from the specified Liberty server:
MODIFY [jobname.]identifier,tdump
SVC dumps
To start an SVC dump, the server must be authorized with read access to the BBG.AUTHMOD.BBGZSAFM.ZOSDUMP resource profile in the SERVER class. The following example shows sample RACF® commands for authorizing the server, where <userid> is the user ID assigned to the server:
RDEF SERVER BBG.AUTHMOD.BBGZSAFM.ZOSDUMP UACC(NONE)
PERMIT BBG.AUTHMOD.BBGZSAFM.ZOSDUMP CLASS(SERVER) ACCESS(READ) ID(username)
SETR RACLIST(SERVER) GENERIC(SERVER) REFR
The following example shows the MODIFY command to request an SVC dump from the specified Liberty server:
MODIFY [jobname.]identifier,svcdump
Java™ heap dumps
The following example shows the MODIFY command to request a Java virtual machine (JVM) heap dump from the specified Liberty server:
MODIFY [jobname.]identifier,HEAPDUMP
Java core dumps
The following example shows the MODIFY command to request a JVM core dump from the specified Liberty server:
MODIFY [jobname.]identifier,JAVACORE
Server dumps
The following example shows the MODIFY command to request a server dump from the specified Liberty server:
MODIFY [jobname.]identifier,DUMP[,INCLUDE=<JAVA_DUMP_1>,<JAVA_DUMP_2>,...]
The INCLUDE parameter is optional. If the INCLUDE parameter is specified, any Java dumps that are listed on the INCLUDE parameter are requested and included in the server dump package. The following Java dump types are valid:
  • THREAD for a Java core dump
  • HEAP for a Java heap dump

MODIFY commands that are supported by the Angel process

Code version
The following example shows the MODIFY command to display the version of Angel code that is loaded:
MODIFY [jobname.]identifier,VERSION
Enable or disable tracing
The following example shows the MODIFY command to enable or disable tracing for the Angel code:
MODIFY [jobname.]identifier,TRACE=[Y|N]

Select Y to enable tracing, or select N to disable tracing.

Display servers
The following example shows the MODIFY command to display a list of servers that are currently connected to the Angel code:
MODIFY [jobname.]identifier,DISPLAY,SERVERS

Icon that indicates the type of topic Reference topic

File name: rwlp_admin_modifydump_zos.html