Commands That Control Filtering of Experiment Data

You can specify filtering of experiment data in two ways:

• By specifying a filter expression, which is evaluated for each data record to determine whether or not the record should be included

• By selecting experiments, samples, threads, CPUs, and LWPs for filtering

Specifying a Filter Expression

You can specify a filter expression with the filters command.

filters filter_exp

filter_exp is an expression that evaluates as true for any data record that should be included, and false for records that should not be included. The grammar of the expression is described in Expression Grammar.

Listing Keywords for a Filter Expression

You can see a list of operands or keywords that you can use in a filter expression on your experiment.

describe

Print the list of keywords that can be used to build a filter expression. Some keywords and the grammar of a filter expression is described in Expression Grammar.

In the Performance Analyzer, you can see the same information by selecting View ⇒ Manage Filters and clicking the Show Keywords button in the Custom tab.

Selecting Samples, Threads, LWPs, and CPUs for Filtering

Selection Lists

The syntax of a selection is shown in the following example. This syntax is used in the command descriptions.

[experiment-list:]selection-list[+[
experiment-list:]selection-list … ]

Each selection list can be preceded by an experiment list, separated from it by a colon and no spaces. You can make multiple selections by joining selection lists with a + sign.

The experiment list and the selection list have the same syntax, which is either the keyword all or a list of numbers or ranges of numbers (n-m) separated by commas but no spaces, as shown in this example.

2,4,9-11,23-32,38,40

The experiment numbers can be determined by using the experiment_list command.

Some examples of selections are as follows.

1:1-4+2:5,6
all:1,3-6

In the first example, objects 1 through 4 are selected from experiment 1 and objects 5 and 6 are selected from experiment 2. In the second example, objects 1 and 3 through 6 are selected from all experiments. The objects may be LWPs, threads, or samples.

Selection Commands

The commands to select LWPs, samples, CPUs, and threads are not independent. If the experiment list for a command is different from that for the previous command, the experiment list from the latest command is applied to all three selection targets, LWPs, samples, and threads, in the following way.

• Existing selections for experiments not in the latest experiment list are turned off.

• Existing selections for experiments in the latest experiment list are kept.

• Selections are set to all for targets for which no selection has been made.

sample_select sample_spec

Select the samples for which you want to display information. The list of samples you selected is displayed when the command finishes.

lwp_select lwp_spec

Select the LWPs about which you want to display information. The list of LWPs you selected is displayed when the command finishes.

thread_select thread_spec

Select the threads about which you want to display information. The list of threads you selected is displayed when the command finishes.

cpu_select cpu_spec

Select the CPUs about which you want to display information. The list of CPUs you selected is displayed when the command finishes.