EnableDebugger

Top  Previous  Next

S

A

W

WS

ü

ü

Valid for: SetStartup & SetRuntime

 

Syntax -

       EnableDebugger {"Yes" | "No"}

 

Description:

This option is used to determine if the processing of the script is paused and the debugger is activated when an error is encountered or other criteria is met to activate the debugger.  If this option is valued with a “Yes”, EMUE will pause the processing of the script and activate the debugger when an error is detected.  If an error is detected in the script and this option is valued to ”No,” EMUE will end the processing of the script with an error.  To provide reliable execution and notification, this option should be included in every script.  Value this option to “Yes” for testing and manual execution.  Value this option with a “No” for unattended processing or when processing in a production environment, as this option also optimizes processing by not preparing and maintaining certain information used by the debugger.  This option sets the Enable Script Debugger checkbox on the Debugging & Logging Activity tab of the EMUE Tools - Current Settings - Options Settings window.

 

Note: If the script is to run unattended and an email is to be sent when an error is detected, this option should be valued with a “No”.

Note: This option affects the way error messages that occur while EMUE is processing a script, display.  The following define the affects of this option:

1.If the EnableDebugger is ON, a modal pop-up message box will be displayed and a message will be displayed in the currently active window.
2.If the EnableDebugger is OFF and error emails are properly configured, an error email will be generated and a message will be displayed in the current activity window.
3.If EnableDebugger is OFF and error emails are not properly configured, no pop-up message will be generated, but the error message will display in the current activity window.
4.If the EnableDebugger is OFF, breakpoints and DEBUG statements will be ignored

Note:  If AllowCompletionOptionsOnError is valued to "Yes" and EnableDebugger is OFF, then the script may close, disconnect, or process another file depending on the how the completion options are set.

Note: Users can also toggle this on and off manually through the toggle button on the tool bar. It is initially set based on your SetStartUp EnableDebugger value.

EnableDebugger

 

Sample:

       The following statement values the EnableDebugger option so the processing of the script will be paused and the debugger will be activated if a script error occurs.

SetStartup EnableDebugger "Yes"

 

See Also:

SuccessEmail

ErrorEmail

EmailFrom

SetRuntime

PromptToActivateDebuggerOnExit