HP Caliper User's Guide

Displays per thread data with percentages calculated for samples collected for each
thread or for the process. The default value is process. It is helpful if an application
has distinct groups of threads that perform different tasks entirely, so displaying their
IP statistics as a percentage of individual threads is more relevant.
--prim-cutoff
--prim-cutoff percent_cutoff[,cum_percent_cutoff[,min_count]]
Specifies cutoff values that limit the blocking primitives reported in the Primitives
section of the cstack report.
HP Caliper stops reporting information when it reaches a percent cutoff, cumulative
percent cutoff, or minimum number of primitives. You have these choices:
• You can limit the report only to primitives that exceed a specified percentage of
the total for the blocking samples. Once HP Caliper encounters this percentage
cutoff, it stops reporting primitives.
• You can limit the report by having HP Caliper stop reporting call paths once the
cumulative percent of the primitives so far listed exceeds the cumulative percentage
cutoff value.
• You can specify an integer for the minimum number of primitives to be displayed.
This option has these parameters:
percent_cutoff
The percentage of the total for the blocked samples that
a given primitive must exceed to appear in a report. This
is shown as percent cutoff on reports.
Default value is 1.0.
cum_percent_cutoff
The value of the cumulative percentage at which HP
Caliper stops reporting results. This is shown as
cumulative percent cutoff on reports.
Default value is 100.
min_count
Sets the minimum number of primitives to be displayed.
Default value is 10.
This cutoff also controls the number of holder and waiter thread entries reported for
thread synchronization primitives (HP-UX only).
For more information, see Chapter 11 (page 171)
--process
See “-p or --process” (p. 68).
90 HP Caliper Options