HP NonStop G-Series - Manual (Page 92)

Formatting Reports and Plots
Measure User’s Guide — 520560-003
4- 32
Step 2: Load the Structured Files
Step 2: Load the Structured Files
For each LIST entity-type or LISTALL entity-type command, MEASFH
searches the current subvolume for a structured file named for the entity type (CPU,
PROCESS, DISC, and so on). If the file exists, MEASFH adds the records for the
specified entities to the file. If a structured file for a specified entity type does not exist
on the subvolume, MEASFH creates a file for it and adds its records to the newly
created file.
The fields within the records of the structured files contain uninterpreted counter
values. That is, busy counters are in microseconds busy, rates are in number of
occurrences, and so on. For a description of the record format and content for each
Measure entity type, see the Measure Reference Manual.
Load the structured files using the LIST entity-type or LISTALL entity-type
command. For example:
2+ ADD MEASUREMENT $PERF.DATA.JUN04
3+ SET REPORT FORMAT STRUCTURED
4+ LIST PROCESS SYSTEM-PROCESSES
5+ LIST PROCESS $*.*.BILLING
In this example, the ADD MEASUREMENT command makes measurement data file
$PERF.DATA.JUN04 accessible to MEASCOM. The SET REPORT command
indicates to write counters to a structured file. The first LIST command creates the
structured file PROCESS (if it does not already exist), then writes the counter values
for all system processes to the file. The second LIST command writes the counter
values for the PROCESS $*.*.BILLING entity in $PERF.DATA.JUN04 to the newly
created file PROCESS.
When MEASFH loads structured files, it does not check for duplicate records but lists
all records separately in the structured file. For example:
6+ LIST PROCESS SYSTEM-PROCESSES
7+ LIST PROCESS $*.*.*
These two commands cause all records for the system processes to appear twice in
the structured file. To avoid duplicate records:
REPORT ZERO-VALUES No effect. Counter values of zero are always written to the
structured file as zero.
LIST/LISTALL FROM, TO,
FOR clauses Determines which records are written to the structured file.
LIST/LISTALL BY clause Sorts entities before data is written. The order of entities in the
structured files does not matter.
LIST/LISTALL IF clause Determines which records are written to the structured file.
Table 4-3. Command Option Effects on Data Written to Structured
Files (page 2 of 2)
Command Option Effect