Measure Reference Manual

5 Entity Descriptors
This chapter describes the Measure entity descriptors.
Like the entity specifications used in the command interface, entity descriptors describe an entity
or set of entities used in the programmatic interface. You use entity descriptors to define the entities
to measure and to specify the counter records to maintain for each entity.
Entity descriptors are part of the configuration table (contab) array that you pass to the
MEASCONFIGURE procedure before starting a measurement. 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 identifier. 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.
Table 6 lists the entity descriptor sections that can be used in the contab array of the
MEASCONFIGURE procedure. For each entity descriptor section, the table includes: the name of
the associated structure(s) in the MEASDECS file, the literal, and the numeric identifier. Entity
descriptor sections must appear in the array in the order shown in Table 6.
Detailed definitions of the entity descriptors follow Table 6. Note that these definitions are listed
alphabetically within this chapter with the following exceptions:
• More general descriptors for an entity descriptor section precede descriptors that are more
specific. (For example, DEVICE^DESC precedes DEVICE^CLIM^DESC.)
• OSS descriptors precede ANSI descriptors. (For example, FILE^OPEN^OSS^DESC and
FILE^OPEN^OSS^DESC^D10 precede FILE^OPEN^ANSI^DESC.)
• CODE^SPACE^DESC, CODE^SPACE^OSS^DESC, and COUNTER^DESC are listed following
the first entity descriptors with which they can be used (thus, CODE^SPACE^DESC follows
PROCESSH^DESC, CODE^SPACE^OSS^DESC follows PROCESSH^OSS^DESC, and
COUNTER^DESC follows USERDEF^DESC.
For more general information on specifying entity descriptors, see Measure Procedures Overview
(page 375), and MEASCONFIGURE (page 383).
451