Setting frequency of event checking (sys.AutoEventCheck)¶
sys.AutoEventCheck,,u1 |
Frequency of checks for incoming events |
Controls the frequency at which a Sculptor program checks for events, such as incoming DDE requests from a client program. Client messages are queued by the operating system and sent to a DDE server when the server makes a check.
The value of sys.AutoEventCheck determines how often Sculptor checks for messages while executing non-interactive commands. Any value from 0-255 may be assigned. Assigning 0 to sys.AutoEventCheck turns event checking off. A non-zero value represents the number of statements executed between checks. The default value for sys.AutoEventCheck is 50. Setting a very low value may impair performance.
If a Sculptor program is awaiting input in an interactive command such as dialog or prompt, it loops to check for messages, and the value of sys.AutoEventCheck is not relevant.
The checkevents command causes an immediate check for messages every time it is executed.
Note
If a DDE client message is found, Sculptor calls the server program’s DDE event function, suspending program execution until the function returns. The function should not change variables or access files in any way that may affect the interrupted program logic. If this is unavoidable, then sys.AutoEventCheck should be set to zero and the related checkevents command used to check for incoming messages at a safe point in the program logic.
EXAMPLE
sys.AutoEventCheck = 100 /* Check after every 100 statements */
RELATED TOPICS |