HP Caliper 5.3 User Guide (5900-1558, February 2011)

--threads................................................................................................................................74
--traps-reported.......................................................................................................................74
--user-regions (HP-UX only) .................................................................................................74
--version.................................................................................................................................75
6 Using the HP Caliper Advisor.....................................................................76
What Is the HP Caliper Advisor?..............................................................................................76
Example of an HP Caliper Advisor Report..................................................................................76
Steps in Using the Advisor.......................................................................................................77
Command Line to Invoke the Advisor.........................................................................................78
Getting Started with the Advisor: Examples................................................................................80
Simplest Example...............................................................................................................80
More Typical Examples.......................................................................................................80
Explanation of Report Output..............................................................................................81
How to Read an Advisor Report................................................................................................82
Suggestions for Using the HP Caliper Advisor.............................................................................83
How the HP Caliper Advisor Works..........................................................................................84
7 Using the HP Caliper Advisor in the GUI.....................................................85
Basic Steps in Using the HP Caliper Advisor in the GUI...............................................................85
Making Performance Measurement Runs....................................................................................85
Selecting Performance Data to Analyze [Optional] .....................................................................86
Generating Advice.................................................................................................................88
Reviewing and Acting on the Advice.........................................................................................89
8 Configuring HP Caliper ............................................................................91
Specifying Option Values with a .caliperinit Initialization File........................................................91
Example of a .caliperinit File...............................................................................................91
Setting Constants in the .caliperinit File.................................................................................92
Configuring Data Collection.....................................................................................................93
Specifying Which CPU Events to Measure.............................................................................93
Shortening CPU Event Names.........................................................................................93
Specifying Which Load Modules to Collect Data For..............................................................94
Default Settings for Load Module Data Collection..............................................................95
How to Specify Load Module Names...............................................................................95
Controlling Granularity of Data Collection and Reports...........................................................96
Specifying Processes to Measure..........................................................................................96
Process Tree Report.......................................................................................................96
Syntax for -p Option......................................................................................................97
Using -p some ..............................................................................................................98
Examples of the -p Option .............................................................................................99
Using HP Caliper in Your Build Process...............................................................................100
Using HP Caliper in Testing and Quality Assurance.........................................................100
Using HP Caliper to Generate Test Suite Reports.............................................................100
Attaching to a Running Process to Perform Measurements......................................................100
How to Display Reference Information About CPU Counters or HP Caliper Report Types.................101
Options for the caliper info Command................................................................................101
-c or --cpu-counter........................................................................................................102
-d or --details..............................................................................................................102
-o or --output-file..........................................................................................................102
-r or --report................................................................................................................102
-s or --search...............................................................................................................102
Examples of the caliper info Command...............................................................................102
6 Contents