BREAK

The DEBUG BREAK command is used to set breakpoints. A breakpoint is a special marker associated with a line of code that will cause execution to halt and a special interactive mode to be entered where variables can be examined, from which execution can be allowed to continue.

 DEBUG BREAK function-name linenumber
 DEBUG BREAK "file-name" linenumber
 DEBUG BREAK ONERROR

Example:

Set a break-point in function Test() at line 5:

 DEBUG BREAK test 5

Set a break-point in file TEST.EAS at line 5:

 DEBUG BREAK "TEST.EAS" 5

The function in which the break is being set should already be loaded, using for example the LOAD command.

Each breakpoint that is set is assigned a numeric identifier. This identifier is used in subsequent commands to CLEAR, DISABLE, or ENABLE the breakpoint.

The BREAK ONERROR form of the command will cause debug mode to be entered automatically when an error occurs.

Breakpoints are removed with the CLEAR command.