--threads................................................................................................................................

75

--traps-reported.......................................................................................................................

75

--user-regions(HP-UX only) .................................................................................................

76

--version.................................................................................................................................

76

6 Using the HP Caliper Advisor.....................................................................

77

What Is the HP Caliper Advisor?..............................................................................................

77

Example of an HP Caliper Advisor Report..................................................................................

77

Steps in Using the Advisor.......................................................................................................

78

Command Line to Invoke the Advisor.........................................................................................

79

Getting Started with the Advisor: Examples................................................................................

81

Simplest Example...............................................................................................................

81

More Typical Examples.......................................................................................................

81

Explanation of Report Output..............................................................................................

82

How to Read an Advisor Report................................................................................................

83

Suggestions for Using the HP Caliper Advisor.............................................................................

84

How the HP Caliper Advisor Works..........................................................................................

85

7 Using the HP Caliper Advisor in the GUI.....................................................

86

Basic Steps in Using the HP Caliper Advisor in the GUI...............................................................

86

Making Performance Measurement Runs....................................................................................

86

Selecting Performance Data to Analyze [Optional] .....................................................................

87

Generating Advice.................................................................................................................

89

Reviewing and Acting on the Advice.........................................................................................

90

8 Configuring HP Caliper ............................................................................

92

Specifying Option Values with a .caliperinit Initialization File........................................................

92

Example of a .caliperinit File...............................................................................................

92

Setting Constants in the .caliperinit File.................................................................................

93

Configuring Data Collection.....................................................................................................

94

Specifying Which CPU Events to Measure.............................................................................

94

Shortening CPU Event Names.........................................................................................

94

Specifying Which Load Modules to Collect Data For..............................................................

95

Default Settings for Load Module Data Collection..............................................................

95

How to Specify Load Module Names...............................................................................

96

Controlling Granularity of Data Collection and Reports...........................................................

97

Specifying Processes to Measure..........................................................................................

97

Process Tree Report.......................................................................................................

97

Syntax for -p Option......................................................................................................

98

Using -p some ..............................................................................................................

99

Examples of the -p Option ...........................................................................................

100

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.............................................................

101

Attaching to a Running Process to Perform Measurements......................................................

101

How to Display Reference Information About CPU Counters or HP Caliper Report Types.................

102

Options for the caliper info Command................................................................................

102

-c or --cpu-counter........................................................................................................

102

-d or --details..............................................................................................................

103

-o or --output-file..........................................................................................................

103

-r or --report................................................................................................................

103

-s or --search...............................................................................................................

103

Examples of the caliper info Command...............................................................................

103

HP Caliper Environment Variables...........................................................................................

104

9 Controlling the Content of Reports.............................................................

105

Layout of an HP Caliper Text or CSV Report.............................................................................

105

6Contents