Measure Reference Manual

MEASREAD_DIFF_
This procedure is an enhanced version of MEASREAD that reads a window of one or more counter
records from a measurement data file.
Before reading from a measurement data file, you must obtain read access to the file using the
MEASOPEN procedure. The data file can be associated with a currently active measurement, or
it can contain data from an inactive measurement.
Unlike MEASREAD, the caller specifies both start time and stop time. The records returned provide
the statistics collected within the specified window.
To get all records for the specified time window might require repeated calls. Only complete
records are returned in a given call. The number returned in a given call depends on the size of
loc (the destination buffer).
In Measure G09 and later PVUs, the parameter if^item has a field template if^item^g09^def that
is available for the longer (128 byte) SQL/MX run unit names. The new template coexists with the
pre-G09 if^item^def template, thereby preserving compatibility with existing applications and
older data files.
error := MEASREAD_DIFF_ ( dfnum ! i
,entitydesc ! i
,loc ! o
,bufsize ! i
,bytesret ! o
,firstcall ! i,o
,from^time ! i
,to^time ! i
,[ timetol ] ! i
,[ version ] ! i
,[ all^recs ] ! i
,[ zero^reports ] ! i
,[ totals ] ! i
,[ loadid ] ! i
,[ if^item ] ! i
,[ totals^num ] ! o
,[ templateversion ] ); ! i
NOTE: The maximum number of USERDEF records in the MEASREAD_DIFF_ reply buffer is 222.
If this maximum is exceeded, the error 3204 (ERR^BUFTOOSMALL) is displayed.
dfnum
input
INT:value
is the data file access number. Use the dfnum value returned by the MEASOPEN procedure.
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, MEASREAD_DIFF_ returns
all counter records that fit the template.
(Measure H01 and later PVUs) For ANSI SQL objects or partitions, entitydesc can be a
DISCOPEN, DISKFILE, FILE, or SQLSTMT entity descriptor. The SQLSTMT ANSI entity descriptor
is used when an ANSI SQL name is to be specified for the retrieval of SQLSTMT counter records.
MEASREAD_DIFF_ 419