HP Caliper Advisor Rule Writer Guide

Table B-24 Metrics Available for Return by Run Information Accessor Functions (continued)
Description of What Is ReturnedReturn TypeMetric
The measured process ID number (PID).
HP Caliper report section: Target Application Process ID.
integerPID
The type of the PMU on the measured system. The value will
be one of the following: ITANIUM2_PMU or
MONTECITO_PMU.
stringPMU_TYPE
The total real time of the measured process. The value is in
seconds.
HP Caliper report section: Target Execution Time Real time.
floatREAL_TIME
The description of how the measured process was started. The
value will be one of the following:
start (HP Caliper started the measured process)
attach (HP Caliper attached to an already running process)
auto (HP Caliper was automatically started when the measured
program was run – available only on HP-UX)
fork (process was forked from its parent)
exec (process was created by exec())
vfork+exec (process was created by vfork() followed by
exec())
HP Caliper report section: Target Application Process ID.
stringSTART_DESCRIPTION
The date and time that the measurement run was started. The
value is in “Unix time” (the number of seconds since 1/1/1970
00:00:00 GMT).
HP Caliper report section: Target Application Start time.
integerSTART_TIME
The total system time of the measured process. The value is in
seconds.
HP Caliper report section: Target Execution Time System time.
floatSYSTEM_TIME
The termination status of the measured process. The value will
be 0 if the process ended normally.
HP Caliper report section: Target Application Termination Status.
integerTERMINATION_STATUS
The size of text pages, in bytes, used by the measured executable.
A negative value means “largest page size available”; a value
<= 4096 means “default page size”; otherwise, the page size in
bytes.
HP Caliper report section: Target Application Main module text
page size.
integerTEXT_PAGE_SIZE
The number of pthread threads in the measured process. This
value will be 0 unless the --threads all option was used on
the measurement run.
integerTHREAD_COUNT
98 Function Reference Information