Measure Reference Manual

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. If bufsize is greater than 32,000, error
3203 (ERR^BADPARAMS) is returned.
bytesret
output
INT .EXT:ref:1
is the number of bytes returned to the destination buffer, loc.
firstcall
input, output
FIXED .EXT:ref:1
is a context value. The first time you pass entitydesc to MEASREAD_DIFF_, specify
firstcall as 0. MEASREAD_DIFF_ modifies and returns firstcall. As long as
MEASREAD_DIFF_ returns a nonzero value in firstcall, more counter records are available.
Call MEASREAD_DIFF_ again with the same entitydesc value and the returned firstcall
value.
from^time
input
FIXED:value
is the start time of the measurement window. Specify from^time as a Julian date based on
local civil time in four-word-by-one-microsecond format as provided by the system procedure
JULIANTIMESTAMP. (For a description of the JULIANTIMESTAMP, see the Guardian Procedure
Calls Reference Manual.) A value of -1 signifies the beginning of the measurement.
to^time
input
FIXED:value
is the stop time of the measurement window. Specify to^time as a Julian date based on local
civil time in four-word-by-one-microsecond format as provided by the system procedure
JULIANTIMESTAMP. (For a description of the JULIANTIMESTAMP, see the Guardian Procedure
Calls Reference Manual.) A value of -1 signifies the end of the measurement.
timetol
input
FIXED:value
is a tolerance value to be applied to the time window bounded by from^time and to^time,
effectively decreasing from^time by timetol and increasing to^time by the same amount.
A value of -1 widens the time window to include the latest record earlier than from^time and
the earliest record later than to^time.
version
input
420 Measure Callable Procedures