IBM User Guide for Java V7 on Windows > Troubleshooting and support > Using diagnostic tools > The Diagnostics Collector

Using the Diagnostics Collector

You can start the Diagnostics Collector after a dump has occurred to collect the relevant files.

The Diagnostics Collector is off by default and is enabled by a JVM command-line option:

-Xdiagnosticscollector[:settings=<filename>]

Specify a Diagnostics Collector settings file is optional. By default, the settings file jre/lib/dc.properties is used. See Diagnostics Collector settings for details of the settings available.

If you run a Java™ program from the command line with the Diagnostics Collector enabled, it produces some console output. The Diagnostics Collector runs asynchronously, in a separate process to the one that runs your Java program. The effect is that output appears after the command-line prompt returns from running your program. If this happens, it does not mean that the Diagnostics Collector has hung. Press

enter to get the command-line prompt back.

If the Diagnostics Collector was not enabled when your dump occurred, you can manually run the Diagnostics Collector afterward. Use the following command:

java com.ibm.java.diagnostics.collector.DiagnosticsCollector [OPTIONS]

where[OPTIONS] are:

-stamp <YYYYMMDD.hhmmss.pid>

The Diagnostics Collector collects the relevant files for the dumps with the specified stamp. The following directories are searched:

• The path provided by the last dump parameter, if set.
• The parent directory provided by the last dump parameter, if set.
• The current working directory.
• The location set in the environment variables IBM_JAVACOREDIR, IBM_HEAPDUMPDIR, IBM_COREDIR, _CEE_DMPTARG, JAVA_DUMP_TDUMP_PATTERN, and TMPDIR.
• The temporary directory, which is C:\Temp .

-date <YYYYMMDD>

This option finds the newest dump with the specified date in the current directory. If an appropriate dump is found, the Diagnostics Collector looks for the files to collect in the directories listed for the -stamp option.

-lastdump <path>

Where <path> is the full path for the last dump. This location is the first directory that the Diagnostics Collector searches for relevant dump files.

If no options are set, the Diagnostics Collector attempts to find the newest dump in the current directory. If a dump is found, the Diagnostics Collector searches for the files to collect in the directories listed for the -stamp option.

Parent: The Diagnostics Collector

Error 404 - Not Found

The document you are looking for may have been removed or re-named. Please contact the web site owner for further assistance.