Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

_LAST^EVENTS
A-68
109759—Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
DSNM Library Services
_LAST^EVENTS
_LAST^EVENTS is set each time a command thread is dispatched to contain the
event(s) that caused the dispatch. Each bit represents a different event.
Considerations
•
_LAST^EVENTS is an INT global variable that can be tested and altered;
_REAL^LAST^EVENTS, which is also set to the current event(s) at each dispatch,
can only be tested.
•
The following events are generated by the frame:
•
Only one frame event at a time occurs with one dispatch per event, so only one bit of
_LAST^EVENTS is ever on for a frame event.
•
The thread may generate multiple, simultaneous events with _SIGNAL^EVENT.
All events signaled by the thread before _RC^WAIT appear together in
_LAST^EVENTS at the next thread dispatch. In this case, no frame events can
appear.
Examples
The following example tests if the _EV^CANCEL bit is on in _LAST^EVENTS:
IF _ON (_LAST^EVENTS, _EV^CANCEL)
THEN ... ;
In this example, the contents of _LAST^EVENTS are altered to reflect _EV^IODONE
instead of _EV^TIMEOUT:
_TURNOFF (_LAST^EVENTS, _EV^TMEOUT);
_TURNON (_LAST^EVENTS, _EV^IODONE);
See the _SIGNAL^TIMEOUT description for another example of _LAST^EVENTS.
_LAST^EVENTS
_EV^CANCEL When the frame receives a command cancellation request.
_EV^CONTINUE When the thread returns with an _RC^WAIT and there is no
outstanding I/O or timeout.
_EV^IODONE When an I/O initiated by a _SEND^CI request completes.
_EV^STARTUP On the frame’s initial dispatch of the thread.
_EV^TIMEOUT When a timeout interval set by a call to _SET^TIMEOUT
elapses.