BREAK        Set a breakpoint location

This command is used to set “breakpoints” in script files for debugging purposes.

When debugging, place the BREAK command at strategic places in the flow of execution of a script file to be debugged and script execution will be suspended when BREAK is encountered. When in debug mode, make sure that the Enable Breakpoints in the Scripts menu is enabled.

After encountering BREAK, the Robo-FTP script processor suspends the script and Robo-FTP enters the break state and control is returned to the console window. Here you can view variable values, for example, by typing DISPLAY commands into the console command line, activate the FTP client applet to view the current state of the FTP site, reassign variable values by typing SET or SETNUM, and then resume script execution from the point of interruption.

Script execution may be resumed by typing the RESUME command into the console command line or by clicking the Skip To Next Command (Ctrl + N) toolbar button.

When your script has been thoroughly debugged, either edit your script and remove all the BREAK commands or clear the Enable Breakpoints control in the Scripts menu and BREAK commands will be ignored.

Related Command(s): GO, RESUME, STOP

See also: Interactive Debugging, Basic Logging