Express (Distributed operating systems), v8.0 > Reference > Command-line utilities > Commands for the IBM Monitoring and Diagnostic Tools for Java - Dump Analyzer
Commands in the interactive mode Jython shell
This section describes the command for the interactive Jython shell that is part of the Dump Analyzer toolThe shell supports the full Jython syntax, similar to the WAS wsadmin command. See the WAS documentation for tutorials on Jython, etc.
In addition, the shell comes pre-loaded with one pre-defined Jython object to provide direct access to key functions of the dump analysis tool. This object is accessed by the names DumpAnalyzer or dbda for short. It exports the following operations:
IAnalyzerContext getContext(): Returns a handle to the current AnalyzerContext object for the dump being analyzed; all the methods from the IAnalyzerContext interface (see below) can be invoked on this object to load and execute analyzers (for example loadAnalyzer())
IAnalysisReport getReport(): Returns a handle to a global report object to which commands contained in scripts using this shell can write their output. The contents of this report will be returned as the output for the overall shell invocation
String expandAnalyzerName(String analyzerName): Expand the short name for an analyzer into its fully qualified package+class name, suitable for use in calls to methods in IAnalyzerContext. This method allows most analyzers to be specified by just their class name (without package)
IAnalyzerbase runAnalyzer(String analyzerName): Invoke the specified analyzer and print its output in the shell. Also returns a reference to the analyzer used.
IAnalyzerBase lookupObjectByAddress(long address, String wrapperName): Find the object or class associated with a given address in the dump and print its contents or definition, using the specified wrapper. Also returns a reference to the analyzer (wrapper) used. Two shortcut names for this command (examine, x) are also provided, as this is by far the most commonly-used command in the interactive shell.
IAnalyzerBase examine(long address, String wrapperName): Shortcut for lookupObjectAddress()
IAnalyzerBase x(long address, String wrapperName): Shortcut for lookupObjectAddress()
IAnalyzerBase examine(long address): Shortcut for lookupObjectByAddress(), using a default ObjectWrapper
IAnalyzerBase x(long address): Shortcut for lookupObjectByAddress(), using a default ObjectWrapper
Collection listObjectInstances(String className): List all the instances of the given class and print the first 10 instances. Also returns a Collection of ObjectWrapper references representing all the instances found (usable as a list in Jython)
Collection listObjectInstancesWithSubClasses(String className): List all the instances of the given class or any of its subclasses and print the first 10 instances. Also returns a collection of ObjectWrapper references representing all the instances found (usable as a list in Jython) This method can also be used with an interface name, in which case the instances classes that implement that interface are returned.
Collection listClassDefinitions(String className): List and print all the definitions of the given class
void help(): Print this help text