You can control the presentation of data from the Set Data Presentation dialog box. To open this dialog box, click the Set Data Presentation button in the toolbar or choose View -> Set Data Presentation.
The Set Data Presentation dialog box has a tabbed pane with the following tabs:
Metrics
Sort
Source/Disassembly
Formats
Timeline
Search Path
Pathmaps
Tabs
The dialog box has a Save button with which you can store the current settings, including any custom-defined memory objects.
Since the defaults for the Analyzer, the er_print utility and the er_src utility are set by a common .er.rc file, output from the er_print utility and er_src utility is affected as a result of saving changes in the Set Data Preferences dialog box.
The Metrics tab shows all of the available metrics. Each metric has check boxes in one or more of the columns labeled Time, Value and %, depending on the type of metric. Alternatively, instead of setting individual metrics, you can set all metrics at once by selecting or deselecting the check boxes in the bottom row of the dialog box and then clicking on the Apply to all metrics button.
The Sort tab shows the order of the metrics presented, and the choice of metric to sort by.
The Source/Disassembly tab presents a list of check boxes that you can use to select the information presented, as follows:
The compiler commentary that is shown in the source listing and the disassembly listing
The threshold for highlighting important lines in the source listing and the disassembly listing
The interleaving of source code in the disassembly listing
The metrics on the source lines in the disassembly listing
The display of instructions in hexadecimal in the disassembly listing
The Formats tab presents a choice for the long form, short form, or mangled form of C++ function names and Java method names. If you select the Append SO name to Function name checkbox, the name of the shared object in which the function or method is located is appended to the function name or method name.
The Formats tab also presents a choice for View Mode of User, Expert, or Machine. The View Mode setting controls the processing of Java experiments and OpenMP experiments.
For Java experiments:
User mode shows Java call stacks for Java threads, and does not show housekeeping threads.
Expert mode shows Java call stacks for Java threads when the user’s Java code is being executed, and native call stacks when JVM code is being executed or when the JVM software does not report a Java call stack. It shows native call stacks for housekeeping threads.
Machine mode shows native call stacks for all threads.
For OpenMP experiments:
User mode and expert mode show master-thread call stacks and slave-thread call stacks reconciled, and add special functions, with the names of form <OMP-*>, when the OpenMP runtime is performing certain operations.
Machine mode shows native call stacks for all threads and outline functions generated by the compiler.
For all other experiments, all three modes show the same data.
The Timeline tab presents choices for the types of event-specific data that are shown, the display of event-specific data for threads, LWP, or CPUs; the alignment of the call stack representation at the root or at the leaf; and the number of levels of the call stack that are displayed.
The Search Path tab allows you to manage a list of directories to be used for searching for source and object files. The special name $expts refers to the experiments loaded; all other names should be paths in the file system.
The Pathmaps tab enables you to map the leading part of a file path from one location to another. You specify a set of prefix pairs: the original prefix and a new prefix. The path is then mapped from the original prefix to the new prefix for a given path. Multiple pathmaps may be specified, and each will be tried in turn to find a file.
You can use the Tabs tab of the Set Data Presentation dialog box to select the tabs to be displayed in the Analyzer window.
The Tabs tab lists the applicable tabs for the current experiment. The standard tabs are listed in the left column. The Index tabs are listed in the center column, and the defined Memory tabs are listed in the right column.
In the left column, click the checkboxes to select or deselect standard tabs for display.
In the center column, click the check boxes to select or deselect Index tabs for display. The predefined Index tabs are Threads, Cpus, Samples, and Seconds. To add a tab for another index object, click the Add Custom Index Tab button to open the Add Index Object dialog. In the Object name text box, type the name of the new object. In the Formula text box, type an index expression to be used to map the recorded physical address or virtual address to the object index. For information on the rules for index expressions, see indxobj_define indxobj_type index_exp
In the right column, click the check boxes to select or deselect Memory Object tabs for display. To add a custom object, click the Add Custom Object button to open the Add Memory Object dialog box. In the Object name text box, type the name of the new custom memory object. In the Formula text box, type an index expression to be used to map the recorded physical address or virtual address to the object index. For information on the rules for index expressions, see mobj_define mobj_type index_exp
When you have added a custom index object or memory object, a checkbox for that object is added to the the Tabs tab and is selected by default.