Measure Reference Manual

data space), entitydesc must identify exactly one entity. If necessary, use the appropriate
operating system information procedures to obtain the names and numbers that let you uniquely
identify the entity.
You need not specify all the fields in an entity descriptor if a subset of the fields is sufficient to
identify the data to retrieve. For example, if you identify a process by its CPU and PIN, you
need not also specify the process name or program file name. Conversely, a call to retrieve
data might need to specify more fields than were used to configure the measurement. For
example, an entitydesc in your measurement configuration might specify a wildcard. If you
wanted to retrieve data for only a subset of the objects measured, the entitydesc in your
MEASREADACTIVE call would probably specify more fields.
NOTE: Wildcards are not permitted in entity descriptors passed to the MEASREACTIVE
callable procedure. If you want to use wildcards, call the MEAS_READACTIVE_MANY_
procedure instead.
(Measure H01 and later PVUs) For ANSI SQL objects or partitions, entitydesc can be a
DISKFILE, FILE, or SQLSTMT entity descriptor. Specify the Guardian name of the file, not the
ANSI SQL name.
loc
output
INT .EXT:ref:*
is the destination buffer for the counter records. Counter records are written to the buffer in
DDL record format. For the DDL record definitions for each entity type, see Chapter 3: Entities
and Counters (page 136).
bufsize
input
INT:value
is the size in bytes of the destination buffer, loc.
bytesret
output
INT:ref:1
is the number of bytes returned to the destination buffer, loc. If bytesret is larger than
bufsize, error 3204 (ERR^BUFTOOSMALL) is returned.
entity^index
input, output
FIXED:ref:1
is applicable to Measure G08 and later PVU MEASREADACTIVE requests for DISKFILE records.
On input, entity^index is either -1 or a value returned by a previous call to
MEASREADACTIVE for the record described by entity^desc.
On output, entity^index contains an internal value that enables Measure to directly fetch
the record described by entity^desc on subsequent calls to MEASREADACTIVE. If -1 is
specified, Measure searches all DISKFILE records in a processor until a match is found. If
entity^index is not -1, Measure assumes it to be the index of the DISKFILE record that is
described by entity^desc. The value of entity^index and the contents of entity^desc
are then examined. If these do not match, error 3402 (ERRM^CANNOTACESS) or error 3404
(ERRM^NOTMEASURING) is returned.
templateversion
input
FIXED:value
426 Measure Callable Procedures