Measure Reference Manual

MEAS_ALLOCATE_TIMERCELLS_
Allocates the specified number of timer cells and returns an array of indexes to those timers. Use
this procedure if your application requires fine granularity timers to maintain counters outside of
Measure. Measure calls this procedure implicitly when you define a timer-cell counter for the
USERDEF entity.
error := MEAS_ALLOCATE_TIMERCELLS_ ( count ! i
,types ! i
,indexes); ! i,o
count
input
INT:value
is the number of timer cells to allocate. Allocate one timer cell for each counter to be maintained.
The maximum number of timer cells per process is 10,000.
types
input
INT .EXT:ref:count
is an array of counter types. The array size is given by count. The permissible counter types
are TCELLBUSY (6), TCELLQUEUE (7), and TCELLQBUSY (8). This array maps, item by item,
to the array of indexes.
indexes
input, output
INT .EXT:ref:count
is an array of indexes to the timer cells. The array size is given by count. On input, the array
is empty. On output, it contains the indexes to use in subsequent calls. This array maps, item
by item, to the array of types.
MEAS_BUMP_TIMERCELL_
Modifies the value of a counter by increasing, decreasing, setting, or resetting the timer cell value.
Use this procedure if your application requires fine granularity timers to maintain counters outside
of Measure. Measure calls this procedure implicitly when you define a timer-cell counter for the
USERDEF entity.
error := MEAS_BUMP_TIMERCELL_ ( index ! i
,op ! i
,[ count ] ); ! i
index
input
INT:value
is the index of the timer cell.
op
input
INT:value
indicates the operation to be performed on the timer cell. The possible values are:
• SETBUSY (3) to set a TCELLBUSY counter. Use this value when the resource measured by
the counter begins to be used.
• RESETBUSY (4) to reset a TCELLBUSY counter. Use this value when the resource measured
by the counter stops being used.
MEAS_ALLOCATE_TIMERCELLS_ 381