Java diagnostic command (jcmd
) tool
Use the jcmd
tool to run diagnostic commands on a specified VM.
Note: Running diagnostic commands can significantly affect the performance of the target VM.
The command syntax is as follows:
jcmd [<options>] [<vmid> <arguments>]
Where:
-
The available
<options>
are:-J
: supplies arguments to the Java VM that is running thejcmd
command. You can use multiple-J
options, for example:jcmd -J-Xmx10m -J-Dcom.ibm.tools.attach.enable=yes
-h
: prints thejcmd
help
-
<vmid>
is the Attach API virtual machine identifier for the Java™ VM process. This ID is often, but not always, the same as the operating system process ID. One example where the ID might be different is if you specified the system property-Dcom.ibm.tools.attach.id
when you started the process. You can use thejps
command to find the VMID. -
The available
arguments
are:help
: shows the diagnostic commands that are available for this VM. This list of commands can vary between VMs.help <command>
: shows help information for the specified diagnostic command<command> [<command_arguments>]
: runs the specified diagnostic command, with optional command arguments
Examples:
jcmd 31452 Thread.print
jcmd 31452 help Dump.heap
jcmd 31452 Dump.heap myHeapDump
Restrictions: This tool is not supported and is subject to change or removal in future releases. Although similar in usage and output to the HotSpot tool of the same name, this tool is a different implementation that is specific to Eclipse OpenJ9™. For information about the differences between these two implementations, see Switching to OpenJ9.
The tool uses the Attach API, and has the following limitations:
- Displays information only for local processes that are owned by the current user, due to security considerations.
- Displays information for OpenJ9 Java processes only
- Does not show information for processes whose Attach API is disabled. Note: The Attach API is disabled by default on z/OS.
For more information about the Attach API, including how to enable and secure it, see Java Attach API.