Button for 1977 Button for 1984 Button for 1990 Button for 1995 Button for MDC Button for notes Button for examples
Left Hand Pointer

MWAPI - Event Commands - ESTART

1995 Version of ANSI (Equivalent to Current ISO Version) of Standard

Right Hand Pointer

8.4 Event Commands
8.4.1 ESTART

ESTA [ RT ] postcond

[ SP ]
SP timeout


The M[UMPS] command ESTART activates event processing. Event processing remains activated until the termination of execution of the ESTART command, except that event processing is implicitly deactivated at the initiation of call back processing for each event. At the conclusion of call back processing for each event, event processing is implicitly reactivated and all einfoattribute nodes in ^$EVENT become undefined.

During call back processing for an event E, event processing can be explicitly activated by executing a nested ESTART command. This causes call back processing for event E to be suspended, and causes the values of all einfoattribute nodes in ^$EVENT to be stacked and to become undefined. When execution of this nested ESTART command is terminated, the values of the einfoattribute nodes that it stacked are restored to ^$EVENT.

When a nested ESTART command is executed, the value of the FOCUS dattribute for the display on which the window associated with event E appears must identify a window W which has a MODAL wattribute value equal to "APPLICATION". If it does not identify such a window, an error occurs with $ECODE containing ",M?10,". If it does identify such a window, the nested ESTART command activates event processing for (a) any enabled events for window W and (b) any enabled timer events for all other windows; processing of all other enabled events is deferred.

The execution of an ESTART command is terminated if (a) an ESTOP command is executed during call back processing for that ESTART command or (b) if timeout is present, the timeout expires. If the timeout period expires during callback processing for an event, the ESTART command is terminated at the conclusion of processing for that event.

When execution of an ESTART command is terminated, execution continues with the command following that ESTART command.

If timeout is present, $TEST indicates the condition that caused event processing to terminate. If event processing was terminated with an ESTOP command, the value of $TEST is 1. If event processing was not terminated with an ESTOP command, the value of $TEST is 0. If timeout is not present, execution of ESTART does not change $TEST.

Button for 1977 Button for 1984 Button for 1990 Button for 1995 Button for MDC Button for notes Button for examples

Copyright © Standard Documents; 1977-2018 MUMPS Development Committee;
Copyright © Examples: 1995-2018 Ed de Moel;
Copyright © Annotations: 2003-2008 Jacquard Systems Research
Copyright © Annotations: 2008-2018 Ed de Moel.

This page most recently updated on 30-Nov-2011, 20:10:44 .

For comments, contact Ed de Moel (demoel@jacquardsystems.com)