Measure User's Guide

Creating a Custom Measurement Application
Measure User’s Guide—520560-003
6-6
Preparing the Configuration Table
Preparing the Configuration Table
The configuration table defines which entities are in a measurement. You pass the
configuration table to MEASCONFIGURE before you start a measurement. After a
measurement is configured, you can read its configuration table by calling
MEASREADCONF or MEASINFO.
The configuration table consists of three parts:
•
A header record
•
The entity descriptor sections
•
A trailer record
The header and trailer records have fixed lengths. The entity descriptor sections can
vary in length, so the table as a whole is variable length.
Header Record
Use the template structure CONTAB^HDR to define the header record. The header
record consists of these elements:
Entity Descriptor Sections
The body of the configuration table is an array of entity descriptors. The entity
descriptors are grouped into sections according to entity type, with the sections
ordered by their numeric identifiers. All CPU descriptors (type number 1) appear first,
followed by all PROCESS descriptors (type number 2), then all PROCESSH
descriptors (type number 3), and so on. If an entity type is not being measured, do not
include a section for that type.
To use a single descriptor to define a set of entities to measure, use wild-card values in
fields. After you define a set of entities, you can exclude individual entities from the set
and ultimately from the measurement. To exclude an entity, add a specification for that
Element Description
Type The numeric identifier 50 or the string literal CONTAB^T (declared in the
MEASDECS file). This field identifies this record as the header record.
Len The length of the entire configuration table, in bytes.
Sections An array of offsets in bytes that point to each entity type’s descriptor section
within the table. The first word of the array is always zero. The following offsets
are ordered by entity type number and are indexed to the beginning of the
configuration table. If an entity type is not being measured, its offset is zero.
Maxents The first element in the sections array (that is, SECTIONS[0]). It identifies the
header format.
Note. If you have older custom programs that do not use the current header format, HP
recommends that you recompile those programs.