The Diagnostics Collector gathers documentation and diagnostic data associated with Java™ Virtual Machine (JVM) problems. At JVM start up it runs a Diagnostic Configuration Check.
The JVM automatically starts the Diagnostics Collector after detecting a runtime problem and producing diagnostic data. The Diagnostics Collector gathers diagnostic data files produced by the JVM and stores them in a single zip file.
If a system dump is produced, the Diagnostics Collector runs jextract on the dump and collects the jextract output. There is an option to disable this behaviour if jextract is not required. All actions are logged in a text file, which is also copied into the output zip file.
The Diagnostics Collector gathers system dumps, Javadumps, heap dumps, verbose GC log (if present) and JVM trace files that match the timestamp for the Java problem that caused the collector to start. The Diagnostics Collector copies the diagnostic files it finds into a single output zip file. The output file is named using the type of problem that occurred, the timestamp of the problem event and the process ID of the Java application, for example:
At JVM start up, the Diagnostics Collector runs a Diagnostic Configuration Check. It checks for any settings that disable Java diagnostics. If any are found, a warning is printed on stderr and in the JavaDiagnosticsCollector.log file. Fix the settings identified by any warning messages before restarting your Java application. Fixing warnings makes it more likely that the right data is available for IBM Support to diagnose a Java problem.
The UserGuide.txt file in the download package gives more detailed information.
IBM SDK for Java version 5.0 or version 6.0
These instructions apply to Java 6 up to and including SR5, and to Java 5 up to and including SR10. If you are using a newer Java version, refer to the Diagnostic Guide (http://www.ibm.com/developerworks/java/jdk/diagnosis/) for instructions on how to enable the Diagnostics Collector.
To enable the Diagnostics Collector for Java 6 up to and including SR5, or Java 5 up to and including SR10:
- Choose an install directory that is accessible to the user id that your Java application runs with.
- Create the install directory if necessary.
- Copy the download package to the install directory.a
- Unzip the download package:
- Ensure the user id that your Java application runs with has read permission for the installed files.
- Edit the options file:
Replace the string <INSTALL_DIR> in the options file with the path to the directory where you installed the package.
- In your Java application runtime configuration, add the following java command line option to enable the Java Diagnostics Collector:
Again, replace <INSTALL DIR> with the path to the directory where you unzipped the package.
If you already use a -Xoptionsfile setting, add the contents of java_dc_options.txt to your existing java options file.
|Download||RELEASE DATE||LANGUAGE||SIZE(Bytes)||Download Options|
|DC Download v1.0||28/09/2009||English||109619||FTP|
Send email to email@example.com for Technical Support and Queries.
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.