Dump agent environment variables

The -Xdump option on the command line is the preferred method for producing dumps for cases where the default settings are not enough. You can also produce dumps using the JAVA_DUMP_OPTS environment variable.

If you set agents for a condition using the JAVA_DUMP_OPTS environment variable, default dump agents for that condition are disabled; however, any -Xdump options specified on the command line will be used.

The JAVA_DUMP_OPTS environment variable is used as follows:
JAVA_DUMP_OPTS="ON<condition>(<agent>[<count>],<agent>[<count>]),ON<condition>(<agent>[<count>],...),...)"
where:
JAVA_DUMP_OPTS is parsed by taking the leftmost occurrence of each condition, so duplicates are ignored. The following setting will produce a system dump for the first error condition only:
ONERROR(SYSDUMP[1]),ONERROR(JAVADUMP)
Also, the ONANYSIGNAL condition is parsed before all others, so
ONINTERRUPT(NONE),ONANYSIGNAL(SYSDUMP)
has the same effect as
ONANYSIGNAL(SYSDUMP),ONINTERRUPT(NONE)

If the JAVA_DUMP_TOOL environment variable is set, that variable is assumed to specify a valid executable name and is parsed for replaceable fields, such as %pid. If %pid is detected in the string, the string is replaced with the JVM's own process ID. The tool specified by JAVA_DUMP_TOOL is run after any system dump or Heapdump has been taken, before anything else.

From Java 6 SR 2, the dump settings are applied in the following order, with the settings later in the list taking precedence:
  1. Default JVM dump behavior.
  2. -Xdump command-line options that specify -Xdump:<type>:defaults, see defaults option.
  3. DISABLE_JAVADUMP, IBM_HEAPDUMP, and IBM_HEAP_DUMP environment variables.
  4. IBM_JAVADUMP_OUTOFMEMORY and IBM_HEAPDUMP_OUTOFMEMORY environment variables.
  5. JAVA_DUMP_OPTS environment variable.
  6. Remaining -Xdump command-line options.

Prior to Java 6 SR 2, the DISABLE_JAVADUMP, IBM_HEAPDUMP, and IBM_HEAP_DUMP environment variables took precedence over the JAVA_DUMP_OPTS environment variable.

From Java 6 SR 2, setting JAVA_DUMP_OPTS only affects those conditions you specify. Actions on other conditions are left unchanged. Prior to Java 6 SR 2, setting JAVA_DUMP_OPTS overrides settings for all the conditions.



© Copyright IBM Corporation 2005, 2010. All Rights Reserved.
© Copyright Sun Microsystems, Inc. 1997, 2007, 901 San Antonio Rd., Palo Alto, CA 94303 USA. All rights reserved.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
This information center is powered by Eclipse technology. (http://www.eclipse.org/)