PAUSE

Pauses macro execution, optionally while displaying a status message. The status message can be a string or numerical value. The macro continues once the user presses the "OK" button on the status dialog.

Syntax:

PAUSE
PAUSE "Ready to continue..."
PAUSE TIME, time
PAUSE THREADS
 

Discussion:

This feature may be used for debugging, presenting results, or pausing the execution of the macro. If the keyword after the PAUSE command is TIME, then the macro execution will "sleep" for at least the number of milliseconds given by the value provided. For example, to pause the macro for 100 milliseconds, the syntax is

PAUSE TIME, 100
 

The macro execution will continue after the specified time interval has passed. No status message is displayed in this case. Note that the system timer has a resolution of about 10 milliseconds, so the actual delay introduced by PAUSE TIME will be between the requested time and the requested time plus (approximately) 10 milliseconds. The maximum allowed timer interval is 1,000,000 milliseconds (about 16.7 minutes).

If the keyword after the PAUSE command is THREADS, the macro execution will pause until all open windows complete whatever computation they are currently executing. This is a very useful feature when calling UPDATE ALL or LOADLENS using session files.

Next:

• PIXEL