Measure Reference Manual

PROCESSH
The PROCESSH entity provides information about the relative execution time of one or more code
ranges within a program.
You can measure code ranges by specifying procedure names and address ranges or by specifying
a code-space category (user code, user library, system code, or system library).
If you use a wildcard in a file name that applies to multiple disk files (such as $SYSTEM.WORK.*),
you must specify a code-space category rather than a procedure name and address range.
You do not need to explicitly add the PROCESS entity for the PROCESSH entity. When you add
the PROCESSH entity to a measurement, the corresponding PROCESS entity is automatically added
for the measured process. You can use the PROCESS entity to get more information about the
measured process with two exceptions: the ALLTIME and ALLINTR measurements. Although Measure
creates a PROCESS record for each of these measurements, these PROCESS records are just
placeholders because these two measurements do not involve measuring any specific processes.
NOTE: In H-series and J-series RVUs, the ALLINTR option for PROCESSH sampling is disabled.
On systems running H-series and J-series RVUs, all interrupt handlers are individual and separate
Interrupt/ Auxiliary Processes and so can be sampled and measured individually.
In Measure G09 and later PVUs, the PROCESSH entity supports the use of OSS file pathnames in
place of Guardian file names. The G09 PROCESSH displays OSS file pathnames in PROCESSH
reports and provides direct mapping between external structured records and the new OSSNAMES
structured record output.
Entity specification for G09 PVU PROCESSH entities differs from the syntax for D-series and pre-G09
PVU entities. The DDL records also differ.
PageTopic
313Entity specification syntax for PROCESSH entities
316DDL records for PROCESSH entities
318DDL field definitions for PROCESSH entities
322Usage notes for PROCESSH entities
322Examples of PROCESSH measurements
Entity Specification Syntax for PROCESSH Entities
To describe a PROCESSH entity:
PROCESSH entity-spec
PROCESSH
collects information about code ranges within one or more processes.
entity-spec
is one of:
{ process-spec ( code-file-spec ) [, ( code-file-spec ) ] ... }
{ process-spec [, process-spec ] ... }
{ ALLTIME | ALLINTR cpu ( code-file-spec ) [, ( code-file-spec ) ] ... }
where:
process-spec
is the process specification. Specify process as one of the following:
{ * }
{ pid }
{ $process-name [ ( pid ) ] }
PROCESSH 313