HP Caliper Advisor Rule Writer Guide

name such as my_app. One or more executables can be
specified with this option, separated by commas (,).
The default is executable:all.
-o
Specifies the name of the report file produced by the Advisor.
The report file is in text format. The Advisor will either create
a new file (create) or append to an existing file (append).
The default file is stdout and the default action is create.
Can also be specified as --output-file outputfile.
--rule-files
Specifies the name or names of existing rule files to use for
the analysis. One or more rule files can be given, separated
by commas (,). A rule file can be a customized rule file in
your own personal rules directory or a standard HP Caliper
rule file in the HP Caliper directory. A rule file can be either
a simple filename or a relative or absolute path name.
For a simple filename, directories are searched in this order:
(1) the current directory, (2) the personal rules directory ~/
caliper_advisor, and (3) the rules subdirectory in the
HP Caliper home directory.
For a relative or absolute path name, no searching is done.
database_list is a set of one or more HP Caliper databases to analyze. If the
databases are specified by name (with or without a path), they are looked for at those
locations. If they are specified only by name, they are looked for in these locations, in
this order: (1) current directory, then (2) databases directory. If no databases are specified
by name, all the databases in the databases directory are analyzed.
For information about what the options mean, see “How to Read an Advisor Report”
(p. 23).
As with the HP Caliper command-line options, each of the Advisor’s command-line
options has a variable counterpart in the .caliperinit file that can set an option
value. The variable name is the same as the option, with hyphens (-) replaced with
underscores (_). Later uses of the same command-line option or .caliperinit file
variable overrides earlier uses.
How to Read an Advisor Report
Each Advisor run analyzes one or more application objects. (Currently, only executable
objects can be analyzed.) A separate report is output for each object analyzed. The
reports are in alphabetic name order.
See “HP Caliper Advisor Report, with Annotations” (p. 21) for an example report.
How to Read an Advisor Report 23