Page navigation
The Diagnostic Tool Framework for Java (DTFJ) is a Java application programming interface (API) used to support the building of Java diagnostics tools.
IBM DTFJ overview
DTFJ works with data from a system dump that has been processed by the jextract tool. The jextract tool produces metadata from the dump, which allows the internal structure of the JVM to be analyzed. You must run jextract on the system that produced the dump. (For more information on jextract see the Diagnosis documentation.)
The DTFJ API helps diagnostics tools access the following information:
- Memory locations stored in the dump
- Relationships between memory locations and Java internals
- Java threads running within the JVM
- Native threads held in the dump
- Java classes and their classloaders that were present
- Java objects that were present in the heap
- Java monitors and the objects and threads they are associated with
- Details of the machine on which the dump was produced
- Details of the Java version that was being used
- The command line that launched the JVM
Installation instructions
For Eclipse 3.4:
- Download the IBM DTFJ plugin which is packaged as an archived update site dtfj-updatesite.zip.
- From the Eclipse menu select Help > Software Updates
- In the dialogue that appears, select Available Software and click Add Site ...
- Select Archive...
- In the dialogue box, select the dtfj-updatesite.zip file from the file dialogue and click Open.
- Ensure IBM DTFJ zip file is selected. Click Install.
- Click Next, read and accept the license agreements.
- Click Finish.
For earlier versions of Eclipse:
- Download the IBM DTFJ plugin which is packaged as an archived update site dtfj-updatesite.zip.
- From the Eclipse menu select Help > Software Updates > Find and Install...
- In the dialogue that appears, select Search for new features to install and click Next.
- Select New Archived Site...
- In the dialogue box, select the dtfj-updatesite.zip file from the file dialogue and click Open.
- At the 'Edit local site' dialogue, in the 'Name' field enter IBM DTFJ updates and click OK.
- Ensure IBM DTFJ updates is selected as a site included in the search. Click Finish.
- Select all of the 'IBM DTFJ' features to install. Click Next.
- Read the license agreements and if you agree to them click Next.
- Click Finish.
- Click on Install all to initiate installation.
Contact information
For comments specific to this download please send mail directly to us.
Additional resources
- More information on DTFJ can be found in the Diagnosis documentation
- IBM developer kits


