Measure Reference Manual

function, and MEASOPEN returns a new error code if the SQL/MX journal segment is under
construction.
• In Measure H02 and later PVUs, the MEASOPEN callable procedure allows the caller to select
the measurement data file size, suppress counter data records in the measurement data file,
or both.
MEASREAD
Reads one or more counter records from a measurement data file. The maximum number of records
returned in a single call depends on the size of the destination buffer, loc. (Only complete records
are returned.) The data file can be associated with a currently active measurement, or it can contain
data from an inactive measurement. Before reading from a measurement data file, you must obtain
read access to the file using the MEASOPEN procedure.
In Measure H01 and later PVUs, MEASREAD accepts DISCOPEN, DISKFILE, FILE and SQLSTMT
entity descriptors for ANSI SQL objects or partitions.
error := MEASREAD ( dfnum ! i
,entitydesc ! i
,loc ! o
,bufsize ! i
,bytesret ! o
,firstcall ! i,o
,[ nomtime ] ! i
,[ timetol ] ! i
,[ version ] ! i
,[ templateversion ] ); ! i
dfnum
input
INT:value
is the data file access number. Use the dfnum value returned by the MEASOPEN procedure.
entitydesc
input
INT: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 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.
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
MEASREAD 417