Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide
_SET^TIMEOUT
A-112
109759—Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
DSNM Library Services
_SET^TIMEOUT
_SET^TIMEOUT allows the command thread to delay for a time interval by arranging
for a future timeout event.
time-interval input
INT(32):value
specifies the timeout period, in .01-second units. This value must be greater than 0.
tag input
INT(32):value
is an identifier associated with the timer, which is placed into command context.
After the interval is set, the thread must return to the frame with _RC^WAIT. The thread
is dispatched with _EV^TIMEOUT when the interval elapses. If supplied, the tag is
placed into command context and can be accessed with _LAST^TIMEOUT^TAG.
Usually, a timeout tag is the address of a list member holding information about the
purpose of the timeout.
Example
The following example dispatches the current thread procedure with _EV^TIMEOUT
after a 1.00 second delay:
LITERAL asec = 100D;
CALL _SET^TIMEOUT (asec); !Wait one second
RETURN _RC^WAIT; !Wait for _EV^TIMEOUT
See the _LAST^TIMEOUT^TAG description for another _SET^TIMEOUT example.
CALL _SET^TIMEOUT ( time-interval
,[ tag ] );