There may be some circumstances in which it is useful to be able to run the analyzer outside the ISA environment; for instance if the analysis needs to be incorporated into some existing problem handling workflow.
First locate the jar files containing the analyzer and its dependencies. These can be found by reference to the
directory in which ISA installs tools plugins (installDir). On Windows™ this is found under
Documents and Settings/<user
ID>/IBM/ISAv4/applications/eclipse/plugins
. On Linux™ it is under the user home
directory and again in IBM/ISAv4/applications/eclipse/plugins
.
There are six .jar files as follows
If you have installed extensions to the Dump Analyzer tool (for example the WebSphere™ Application Server modules), you may need to add additional jar files provided by these extensions. Refer to the documentation for each extension for further information about the jar files that they provide.
These jar files can be copied to other platforms and executed there or can be executed on the platform where ISA is installed. If we assume that the current directory is (installDir)/plugins/com.ibm.java.diagnostics.dbda.isa_(version number) then the java invocation on Windows is
set CP="dumpAnalyzer.jar;coreAnalyzers.jar" set BCP="lib/j9/dtfj.jar;lib/j9/dtfj-interface.jar;lib/sov/dtfjsu.jar;lib/sov/dtfj.jar" java -cp $CP -Xbootclasspath/p:$BCP com.ibm.dtfj.analyzer.base.DumpAnalyzer (dumpName) (options) |
Where the dump name should be the name of either a dump which has been processed by jextract (typically *.dmp.zip or *.sdff) or a directory which contains dump files. If a directory is given then the analyzer will analyze all the dumps in the directory. The output will be directed to the primary output stream and can then be further redirected using normal operating system mechanisms.
Note that the above invocation ensures that the analyzer will use the latest versions of the DTFJ libraries.
The analyzer allows some options to control the analysis or output format. Typically the options are specified as -[option]:[parameter(s)]