Java process status (
jps tool to query running Java™ processes. The tool shows information for every Java process that is owned by the current user ID on the current host. The command syntax is as follows:
where the available
<options> are as follows:
-J: supplies arguments to the Java VM that is running the
jpscommand. You can use multiple
-Joptions, for example:
jps -J-Xmx10m -J-Dcom.ibm.tools.attach.enable=yes
-l: prints the application package name
-q: prints only the virtual machine identifiers
-m: prints the application arguments
-v: prints the Java VM arguments, including those that are produced automatically
The output has the following format:
<VMID> [[<class_name>|<jar_name>|"Unknown"] [<application_args>][<vm_args>]]
VMID is the Attach API virtual machine identifier for the Java 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.
$ jps -l 5462 org.foo.bar.MyApplication 14332 openj9.tools.attach.diagnostics.Jps $ jps -q 5462 14332
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 OpenJ9.
The tool uses the Attach API, and has the following limitations:
- Does not list Java processes on other hosts, to enhance security
- Does not list Java processes owned by other users
- Does not list non-OpenJ9 Java processes
- Does not list 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 Support for the Java Attach API.