Measure Reference Manual

MEASCOUNTERBUMP
Modifies the counter identified by offset provided that:
• The counter is part of a currently active measurement. If the counter is not currently being
measured, MEASCOUNTERBUMP returns ERR^UDCNOTPRESENT.
• The counter type is compatible with bumptype. You specify the counter type when you add
the counter to the measurement configuration.
For more information about user-defined counters, see MEASCOUNTERBUMPINIT (page 388).
error := MEASCOUNTERBUMP ( offset ! i
,bumptype ! i
,[ addvalue ] ! i
,[ index ] ! i
,[ doubleadd ] ! i
,[ quadadd ] ); ! i
offset
input
INT:value
is the offset of the counter value within the internal counter record. Use the offset value
returned by the MEASCOUNTERBUMPINIT procedure.
bumptype
input
INT:value
is a literal value, which indicates the counter bump action. bumptype must be compatible
with counter type.
Counter typeActionValue
AccumulatingIncrement counterINC
AccumulatingAdd addvalue to counterADD
Busy or TCELLBUSYSet counter to busySETBUSY
Busy or TCELLBUSYSet counter to not busyRESETBUSY
Queue or TCELLQUEUEIncrease (queue) counterINCQUEUE
Queue or TCELLQUEUEDecrease (queue) counterDECQUEUE
Queue Busy (QBUSY or TCELLQBUSY)Increase (queue busy) counterINCQBUSY
Queue Busy (QBUSY or TCELLQBUSY)Decrease (queue busy) counterDECQBUSY
addvalue
input
INT:value
is the value (positive or negative) to add to the counter. Applicable only if you specified
bumptype as ADD and the counter type is ACCUM or FACCUM. It cannot be specified if the
doubleadd parameter is also specified.
index
input
INT:value
is an index into an array of counters. The maximum index value is 127. By default, a counter
name is associated with a single counter value (index value 0). You can also associate a
counter name with an array of counter values.
MEASCOUNTERBUMP 387