HP-UX Programmer's Guide for Java 2

Table Of Contents
To enable this functionality, use the command-line option -XX:+HeapDump or set the
environment variable _JAVA_HEAPDUMP=1 before starting the Java™ application. (for
example, export _JAVA_HEAPDUMP=1)
This output is similar to -Xrunhprof:heap=dump. The difference is that the thread
info (THREAD START) and trace info (TRACE) will not printed to the output file.
With the option enabled, each time you send the process a SIGQUIT signal the JVM
produces a dump of the Java™ heap (a Java™ heap snapshot), in hprof format. The
name of the file will have the following format:
java_<pid>_<date>_<time>_heapDump.hprof.txt
By creating a series of these snapshots you can see how the number and size of objects
varies over time.
NOTE: A full GC is executed prior to the Heap snapshot.
-XX:+HeapDumpOnly and _JAVA_HEAPDUMP_ONLY
Beginning with SDK 1.4.2.11, the option -XX:+HeapDumpOnly can be used to enable
HP Heap Dumps using SIGVTALARM signal (signal 20). To enable this feature without
altering the java command line, the environment variable _JAVA_HEAPDUMP_ONLY
can be set in the user's environment prior to executing the java application java.
If _JAVA_HEAPDUMP_ONLY is set, or -XX:+HeapDumpOnly command-line option is
used, then the HP HeapDump functionality will be triggered by sending signal
SIGVTALRM (20) to the process, and the printing of thread and trace information to
stdout is suppressed.
The HeapDump is written to a file with the following filename format:
java_<pid>_<date>_<time>_heapDump.hprof.txt
The default output format is ASCII. The output format can be changed to hprof binary
format by setting the _JAVA_BINARY_HEAPDUMP environment variable, which is used
to specify that heap dumps be emitted in binary format only. By default the
-XX:+HeapDump and -XX:+HeapDumpOnly options will emit heap dump information
in ascii format.
-XX:+HeapDumpOnCtrlBreak
The command-line option -XX:+HeapDumpOnCtrlBreak enables the ability to take
snapshots of the java heap when a SIGQUIT is sent to the java process, without using
the jvmti-based -Xrunhprof:heap=dump.
This feature is similar to the -XX:+HeapDump option, except the output format is binary
hprof format, and is placed into a filename with the following naming convention:
The HeapDump is written to a file with the following filename format:
java_<pid>_heapDump.hprof.<millitime>
22 HotSpot Technology Tools and Commands