$TTIMER – Test interval timer

Use $TTIMER to obtain the time remaining in the associated time interval that was previously set with $STIMER macro instruction. The value of the remaining time interval is returned in register 0 in seconds (rounded to the nearest second). The $TTIMER macro instruction can also be used to cancel the associated time interval.

Format description


>>-+--------+--$TTIMER--+-loc-adrx-+--,--CANCEL----------------><
   '-symbol-'           '-(--R1--)-'

loc

Specifies the address of the timer queue element. If register notation is used, the address must have been loaded into the designated register before the execution of this macro instruction.

If the timer queue element is not active or if the interval has expired before the $TTIMER macro instruction is executed, the value of the time interval returned is 0.

CANCEL

Specifies that the interval in effect should be canceled.

If this operand is omitted, processing continues with the unexpired portion of the interval still in effect.

If the timer queue element is not active or if the interval has expired before the $TTIMER macro instruction is executed, the CANCEL operand has no effect.

Format description

Environment