Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

_RESTORE^THREAD^AND^DISPATCH
A-106
109759Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
DSNM Library Services
_RESTORE^THREAD^AND^DISPATCH
_RESTORE^THREAD^AND^DISPATCH restores the thread procedure and state last
pushed and returns to the frame for immediate dispatch with the specified event.
event input
INT:value
is an INT expression that designates the event(s) with which the restored procedure
is to be dispatched. The default is _EV^CONTINUE.
When using _RESTORE^THREAD^AND^DISPATCH with all arguments omitted
(accepting the default event), you must use the following construction:
_RESTORE^THREAD^AND^DISPATCH ( );
_RESTORE^THREAD^AND^DISPATCH can fail only with error
ZDSN^ERR^NOTPUSHED. When a failure occurs, code immediately following the
function is executed.
Example
IF _ISNULL(@inobj := @cx.currentobj :=
_GET^LM(cx.current^in))
THEN
BEGIN
! Out of input objects; restore caller and continue.
! Note: Calling proc has set the state in which it
! desires to return before saving the thread
! state and dispatching this proc.
_RESTORE^THREAD^AND^DISPATCH (_EV^CONTINUE);
! If _RESTORE^THREAD^AND^DISPATCH fails,
! we fall through to here and ...
RETURN _RC^ABORT (ZDSN^ERR^NOTPUSHED);
END;
_RESTORE^THREAD^AND^DISPATCH ( [ event ] );