pmlist Command

Purpose

Lists information about supported processors.

Syntax

pmlist [ -h ]

pmlist -l [ -o t | c | x ]

pmlist { -s | -e ShortName | -c Counter [ ,event ] | -g Group | -S Set | -D DerivedMetricID | -m MetricGroup | -V Variable } [ -p ProcessorType ] [ -s ] [ -d ] [ -o t | c | x ] [ -f Filter ]

Description

The pmlist command performs the following functions:

List the supported processors.
List the information summary for a specified processor.
List the event table for a specified processor.
List any existing event groups for a specified processor.
List any existing event sets for a specified processor.
List the event set and formula for a specified derived metric.
List the variables in the derived metric files.

Flags

Item	Description
-c -1	Lists all events for all counters.
-c Counter	Lists all events for the specified Counter.
-c Counter,Event	Lists the specified Event for the specified Counter.
-d	Displays event detailed description.
-D -1	Displays all the derived metrics supported.
-D DerivedMetricID	Displays the specified DerivedMetricID.
-e ShortName	Lists the description of the specified ShortName for all Counters.
-f v,u,c	Specifies the event filter as a comma-separated list of filters. The valid filters are: v (verified) , u (unverified) , and c (caveat). These filters represent the testing status of an event. The default filter is v,u,c.
-g -1	Lists all event groups.
-g Group	Lists the specified event Group.
-h	displays help information for the pmlist command.
-l	Lists all supported processor types.
-m -1	Lists all derived metrics by metric group.
-m MetricGroup	Displays all the derived metrics that pertain to the specified MetricGroup.
-o t \| c \| x	Specifies the output format for the pmlist command. The valid output formats are specified as one of: t (text format), c (CSV format) and x (XML format). The default output format is text.
-p ProcessorType	Specifies the processor type.
-s	Displays the processor information summary.
-S -1	Displays all the event sets supported.
-S Set	Displays the specified event Set.
-V -1	Displays all the variables that are used to calculate derived metrics.
-V Variable	Displays the specified variable.

Examples

To display the list of all supported processors, type:
```
pmlist -l
```
To display a summary information for the current processor, type:
```
pmlist -s
```
To display a summary information for the current processor in CSV format, type:
```
pmlist -s -o c
```
To display group number 62 for the current processor (if the current processor supports event groups), type:
```
pmlist  -g 62
```
To display detailed information for event 3 of counter 1 of POWER4 processor, type:
```
pmlist -p POWER4 -c 1,3 -d
```
To display set number 2 for the current processor (if the current processor supports event sets), type:
```
pmlist -S 2
```