AllowCompletionOptionsOnError

               ×V2.1Ø

Valid for: SetStartup & SetRuntime

Syntax -

       SetStartup AllowCompletionOptionsOnError {"Yes" | "No"}

Description:

This option enables or disables the completion options (AutoClose, AutoDisconnect, WaitAgain) upon error.  Normally, if a script completes with an error, the script remains open and connected and no more files are processed.  However, the AllowCompletionOptionsOnError allows this behavior to be configured.  If AllowCompletionOptionsOnError is set to its default value of "No," then EMUE will remain open and connected if it encounters an error.  If AllowCompletionOptionsOnError is set to "Yes," then the script will finish according to the completion option settings. This sets the Allow Completion Options On Error checkbox on the Automation tab of the EMUE Tools - Current Settings - Options Settings window.

Note: This setting will not affect errors that occur before the script begins processing.   If EMUE is unable to load the file or if it is unable to parse the SetStartup commands then the script will remain open as if AllowCompletionOptionsOnError was set to "No."

Note: If the debugger is enabled (EnableDebugger) and EMUE encounters an error, the script will stop and will not allow the completion options even if AllowCompletionOptionsOnError is set to "Yes."

Sample 1:

       The following example instructs EMUE to behave according to the AutoClose, AutoDisconnect, and WaitAgain settings even if there is an error from the start of the script.

SetStartup AllowCompletionOptionsOnError "Yes"

Sample 2:

The following example instructs EMUE to behave according to the AutoClose, AutoDisconnect, and WaitAgain settings even if there is an error during runtime once the command has been processed.

SetRuntime AllowCompletionOptionsOnError "Yes"

See Also:

SetRuntime