Measure Reference Manual

• For best performance, use the ZMS entity-template-version literal from the MEASDDLS
file for the current RVU. Using an earlier template version or requesting legacy style records
increases performance cost.
• To use this interface, you must first start a measurement containing the entities to be accessed.
Measure needs that measurement and the corresponding measnum to identify counter records
that have changed.
• MEAS_READACTIVE_MANY_ returns multiple active counter records configured in a processor
by iterating over the list of counter IDs (CIDs) for the specified entity type. If a CID has been
released during the iteration or between calls, it may not be possible to follow the link to the
next CID for the entity, resulting in an error 3402 (ERRM^CANNOTACCESS). After error
3402 occurs, the name of the entity corresponding to the CID that has been released is no
longer available. The recommended response to an error 3402 is to reset the
MEAS_READACTIVE_MANY_ context and try the call again.
MEASREADCONF
Returns the measurement configuration from a data file. Before reading from a measurement data
file, you must obtain read access to the file using the MEASOPEN procedure.
In Measure G09 and later PVUs, MEASREADCONF has a parameter for retrieving settings that
reports the configuration of the journal segment functions.
error := MEASREADCONF ( dfnum ! i
,[ contab ] ! o
,[ bufsize ] ! i
,[ bytesret ] ! o
,[ starttime ] ! o
,[ stoptime ] ! o
,[ interval ] ! o
,[ entities ] ! o
,[ ctrspace ] ! o
,[ version ] ! i
,[ max^ent ] ! i
,[ settings ] ); ! o
contab, bufsize, bytesret
These parameters are a group. That is, one cannot be passed without the other two, or error
3201 (ERR^MISSINGPARAM) is returned.
error
INT
is the error code indicating the outcome of the operation. Possible error codes include:
DescriptionError Code
Successful completion.0
dfnum is omitted, or at least one of contab, bufsize, or bytesret
was not passed. These parameters are a group; one cannot be passed
without the other two.
err^missingparam3201
bufsize is greater than 32,000 bytes, or max^ent is passed as zero
or a negative number.
err^badparams3203
The counter records returned exceeded the buffer size.err^buftoosmall3204
dfnum
input
INT:value
is the data file access number. Use the dfnum value returned by the MEASOPEN procedure.
432 Measure Callable Procedures