file option

The file option is used by dump agents that write to a file.

It specifies where the diagnostics information should be written. For example:
java -Xgcpolicy:metronome -Xdump:heap:events=vmstop,file=my.dmp

You can use tokens to add context to dump file names. See Dump agent tokens for more information.

The location for the dump is selected from these options, in this order:

  1. The location specified on the command line.
  2. The location specified by the relevant environment variable.
    • IBM_JAVACOREDIR for Javadump.
    • IBM_HEAPDUMPDIR for Heapdump.
    • IBM_COREDIR for system dump, .
    • IBM_COREDIR for snap traces, .
  3. The current working directory of the JVM process.

If the directory does not exist, it will be created.

If the dump cannot be written to the selected location, the JVM will fall-back to the following locations, in this order:

  1. The location specified by the TMPDIR environment variable.
  2. The /tmp directory.


© 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/)