Specify a selection of function-list metrics. The string metric_spec can either be the keyword default, which restores the default metric selection, or a list of metric keywords, separated by colons. The following example illustrates a metric list.
% metrics i.user:i%user:e.user:e%user |
This command instructs the er_print utility to display the following metrics:
Inclusive user CPU time in seconds
Inclusive user CPU time percentage
Exclusive user CPU time in seconds
Exclusive user CPU time percentage
By default, the metric setting used is based on the dmetrics command, processed from .er.rc files, as described in Commands That Set Defaults. If a metrics command explicitly sets metric_spec to default, the default settings are restored as appropriate to the data recorded.
When metrics are reset, the default sort metric is set in the new list.
If metric_spec is omitted, the current metrics setting is displayed.
In addition to setting the metrics for the function list, the metrics command sets metrics for caller-callees and metrics for data-derived output to the same settings. See cmetrics metric_spec and data_metrics metric_spec for further information.
When the metrics command is processed, a message is printed showing the current metric selection. For the preceding example the message is as follows.
current: i.user:i%user:e.user:e%user:name |
For information on the syntax of metric lists, see Metric Lists. To see a listing of the available metrics, use the metric_list command.
If a metrics command has an error in it, it is ignored with a warning, and the previous settings remain in effect.