Measure Reference Manual

INT:ref:1
is the number of bytes returned to the destination buffer, loc.
firstcall
input, output
FIXED:ref:1
is a context value. The first time you pass entitydesc to MEASREAD, specify firstcall
as 0. MEASREAD modifies and returns firstcall. As long as MEASREAD returns a nonzero
value in firstcall, more counter records are available. Call MEASREAD again with the
same entitydesc value and the firstcall value that was returned to you.
nomtime
input
FIXED:value
is a nominal time. If you omit nomtime (or specify it as -1), MEASREAD returns all the counter
records written to the file. If you specify nomtime and omit timetol (or specify it as -1),
MEASREAD returns the counter records written from the start of the measurement to the earliest
record later than nomtime. If you specify both nomtime and timetol, MEASREAD returns
the counter records written from the start of the measurement to nomtime plus timetol time.
The nomtime default is -1.
timetol
input
FIXED:value
is a tolerance value. For more information, see nomtime. The timetol default is -1.
version
input
INT:value
is the Measure product version when the data file was created. The value consists of two parts:
bits 0:7 contain an alphabetic character (for example, D), and bits 8:15 contain a numeric
value (for example, 30). Together they express the product version (for example, D30).
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.
418 Measure Callable Procedures