Measure Reference Manual

contab, bufsize, bytesret
These parameters are a group. That is, one cannot be passed without the other two, or
error 3201 (ERR^MISSINGPARAM) is returned.
• If OSS or SQL/MX journal segment construction is requested for a measurement, the status is
always reported as under construction while the measurement is active. When the measurement
is stopped, the setting continues to be reported as under construction until updating of the file
is complete.
MEAS_RETRIEVE_TIMERCELLS_
Retrieves the values of the specified timer cells. Use this procedure if your application requires fine
granularity timers to maintain counters outside of Measure. Measure calls this procedure implicitly
when you request values of a timer-cell counter defined for the USERDEF entity.
Retrieving a timer-cell value does not reset the value.
error := MEAS_RETRIEVE_TIMERCELLS_ ( count ! i
,indexes ! i
,timers ); ! i,o
count
input
INT:value
is the number of timer cells to retrieve. Measure can retrieve multiple timer cell values during
a single rendezvous, so it makes sense to retrieve several timer cell values in a single call rather
than request each timer cell separately.
indexes
input
INT .EXT:ref:count
is an array containing the indexes of timer cells to retrieve.
timers
input, output
FIXED .EXT:ref:count
is an array of timer-cell values. On input, the array is empty. On output, it contains the values
of the timer cells, in the same order in which their indexes were specified in the previous
parameter. Timer-cell values are in microsecond units.
436 Measure Callable Procedures