Measure Reference Manual

measnum
input
INT:value
is the measurement number. Use the measnum value returned by the MEASCONFIGURE
procedure or find the measnum value using MEASMONSTATUS.
entitydesc
input
INT:ref:*
is the entity type and entity specification of the desired active counter record. Specify
entitydesc as one of the descriptors listed in the contab description of the
MEASCONFIGURE procedure. Because MEAS_READACTIVE_ uses entitydesc to directly
access the entity control block (which in turn is used to access the counter record in system
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.
NOTE: Wildcards are not permitted in entity descriptors passed to the MEAS_REACTIVE_
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
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(32):value
is the size in bytes of the destination buffer, loc.
bytesret
output
INT(32):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 active measurement requests for DISKFILE records.
On input, entity^index is either -1 or a value returned by a previous call to
MEAS_READACTIVE_ for the record described by entity^desc.
On output, entity^index contains an internal value which enables Measure to directly fetch
the record described by entity^desc on subsequent calls to MEAS_READACTIVE_. 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 which is
described by entity^desc. The value of entity^index and the contents of entity^desc
428 Measure Callable Procedures