Measure Reference Manual

are then examined. If they do not match, error 3402 (ERRM^CANNOTACCESS) or error 3404
(ERRM^NOTMEASURING) is returned.
templateversion
input
FIXED:value
(Measure G11 and later PVUs) is the appropriate template version literal from MEASDDLS for
the entity type requested in entitydesc if you want ZMS style external records. If omitted or
passed as 0F, legacy style records are returned.
If passed as -1F, the templateversion for the current release will be used, starting with the
H06.15/J06.04 RVUs. Note that returned external records, in this case, may not match the
counter record definitions with which the application was compiled.
Usage Note
In Measure H01 and later PVUs, MEASREADACTIVE and MEAS_READACTIVE_ accept DISKFILE,
FILE, or SQLSTMT entity descriptors for ANSI SQL objects or partitions.
MEAS_READACTIVE_MANY_
Retrieves multiple active counter records configured in a processor, without incurring overhead for
messages. This procedure is available in H-series and J-series RVUs.
The MEAS_READACTIVE_MANY_ procedure cannot read PROCESSH, SQLSTMT, or USERDEF
counters. To access PROCESSH counter values, use the MEASREAD_DIFF_ procedure to read from
the currently active measurement data file. To access SQLSTMT or USERDEF counters, use the
MEAS_READACTIVE_ procedure.
error := MEAS_READACTIVE_MANY_ ( measnum ! i
,mode ! i
,entitydesc ! i
,buffer ! o
,bufsize ! i
,recs ! o
,context ! i,o
,[ templateversion ] ); ! i
measnum
input
INT:value
is the measurement number. Use the measnum value returned by the MEASCONFIGURE
procedure or find the measnum value using MEASMONSTATUS.
mode
input
INT:value
is one of the values READACTIVE_MANY_LIST (0), READACTIVE_MANY_EXACT (1), or
READACTIVE_MANY_CHANGED (2). The semantics of these values depends on the value of
the context parameter.
entitydesc
input
INT .EXT:ref:*
is the entity type and entity specification of the desired counter records. Specify entitydesc
as one of the descriptors listed in the contab description of the MEASCONFIGURE procedure.
If you specify entitydesc as a template for multiple specifications,
MEAS_READACTIVE_MANY_ returns all counter records that fit the template.
MEAS_READACTIVE_MANY_ 429