Setting Data Presentation Options

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.

Metrics Tab

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.

Sort Tab

The Sort tab shows the order of the metrics presented, and the choice of metric to sort by.

Source/Disassembly Tab

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.

Formats Tab

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 machine call stacks when JVM code is being executed or when the JVM software does not report a Java call stack. It shows machine call stacks for housekeeping threads.

• Machine mode shows machine 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 machine call stacks for all threads.

For all other experiments, all three modes show the same data.

Timeline Tab

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.

Search Path Tab

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.

Pathmaps Tab

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.

Tabs Tab

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.