Skip to content

CAUTION: This site hosts draft documentation for the next release. For published content of the latest release, visit www.eclipse.org/openj9/docs

Java memory map (jmap) tool

Use the jmap tool to get memory information for a particular Java™ process, or list of processes. The tool shows statistics about classes on the heap, including the number of objects and their aggregate size. The command syntax is as follows:

jmap [<option>] [<vmid>]

<vmid> is the Attach API virtual machine identifier for the Java process. This ID is typically the same as the operating system process ID, unless you specified the -Dcom.ibm.tools.attach.id system property when you started the process.

VMID is shown in jps or other Attach API-based tools. Multiple VMIDs can be specified, separated by a space.

If you do not specify a VMID, the command reads input from stdin. You can therefore get information for all processes by piping the output of the jps command to jmap:

jps -q | jmap -histo

IDs of dead processes are silently ignored.

On its own, jmap prints help information. To obtain memory information, a -histo argument must be supplied, where the available <options> are as follows:

  • -histo: Prints statistics about classes on the heap, including the number of objects and their aggregate size
  • -histo:live: Prints statistics for live objects only
  • -J: supplies arguments to the Java VM that is running the jmap command. You can use multiple -J options, for example: jmap -J-Xms2m -J-Xmx10m

The output has the following format:

num   object count     total size    class name
-------------------------------------------------
  1           3354         107328    [C
  2            717          57360    java.lang.Class
  3           2427          38832    java.lang.String
  4             50          13200    [J
  5            717          11472    java.lang.J9VMInternals$ClassInitializationLock
  6            342           8208    java.lang.StringBuilder
  7            151           7248    jdk.internal.org.objectweb.asm.Item
  8            396           6336    [Ljava.lang.Object;

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™.

The following tool limitations apply:

  • Displays information only for local processes that are owned by the current user, due to security considerations. You can display information for remote processes by using ssh user@host jmap <options> <pid>.
  • Displaying data from core dumps is not supported; use jdmpview instead.
  • Other options , such as -F (force a dump of an unresponsive process) can be accomplished using kill -QUIT <pid>.

The tool uses the Attach API, and has the following limitations:

  • 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.