FlashBASIC Debugger commands

The # command displays the item-ID of the error message that caused the most recent abort into the BASIC/FlashBASIC debugger.

The $ command displays the current program name and current line number, and verifies the object code. The object code is verified by performing a checksum verification. This is used to determine if the object code has been corrupted since the last time it was compiled. The $ and ? commands are identical.

The $! command displays the current call stack with parameter names and values being shown. If the symbol table is not present, the internal names are shown.

The / command references and optionally alters the contents of variables within the run-time code being executed.

The ? command displays the current program name and line number.

The ?! command is used in the BASIC/FlashBASIC debugger to display the current call stack with current parameter values being shown.

The > command executes any TCL command typed concatenated after the > and returns to the BASIC debugger.

The b command establishes a breakpoint condition in the breakpoint table that causes the program to enter the BASIC/FlashBASIC debugger when the condition defined in the breakpoint expression is met.

The c command toggles on or off the display of the current source line when stepping through the program with CTRL+J. When this function is on, the line displays after it has been executed.

The CTRL+J command has the same effect as the BASIC/FlashBASIC debugger g command, except that CTRL+J only requires one character. If the BASIC/FlashBASIC debugger c option is enabled, CTRL+J also displays the BASIC instruction after it is executed.

The CTRL+N command is similar to the BASIC/FlashBASIC debugger g command except that if single-stepping is active, the CTRL+N command will step over any subroutine calls.

The d command displays the contents of the breakpoint and trace table.

The de command invokes the system debugger from the BASIC/FlashBASIC debugger. Issuing a g command from the system debugger returns control to the BASIC/FlashBASIC debugger. The de command is identical to the debug command at TCL.

The debug command temporarily exits the BASIC/FlashBASIC debugger and invokes the system debugger. Issuing a g command from the system debugger returns control to the BASIC/FlashBASIC debugger.

The down command is used in the BASIC/FlashBASIC debugger to move down the call stack.

The e command indicates the number of instructions to execute prior to returning to the BASIC/FlashBASIC debugger.

The edit command invokes the Update processor for editing the current program from within the BASIC/FlashBASIC debugger. It automatically positions the cursor at the current execution line number.

The end command terminates the run-time portion of a BASIC or FlashBASIC program, exits the debugger, and returns control to TCL.

The g command resumes execution of a program after it has been interrupted by the execution of a BASIC/FlashBASIC debug statement or by pressing ESC or BREAK.

The k (kill) command kills a breakpoint previously set with the b command, and removes the entry from the breakpoint table. The k command, followed by pressing ENTER, removes all breakpoint entries from the table.

The l command lists the current source line, or a specified range of lines, from the corresponding source program being executed. The l* form displays the entire program. The l command, followed by pressing ENTER, displays the current program source line.

The lp command toggles the line printer bit status, either directing debugger output to the terminal screen or to the Spooler. This is the equivalent to issuing a printer on statement within the program.

The m command toggles modal trapping on and off.

The n command ignores any debugger breakpoint conditions for a specific number of occurrences.

The off command stops processing at all levels on the current port and returns control to the initial logon prompt.

The p command toggles disabling output display; debugger output is still displayed.

The pc command closes the current spooler entry and releases the print job to the Spooler.

The r command pops the top return stack address of the local subroutine from the stack, causing the next return command to return to the address revealed by the pop.

The return command returns from the current subroutine in the BASIC/FlashBASIC debugger. All code from the current debug point to the end of the routine is executed normally.

The s command displays the contents of the subroutine stack.

The t command places a given variable into the trace table, causing the debugger to display the specified data element along with the contents of the break and trace tables on each break.

The u command removes from the trace table a given variable, or all variables, previously specified with the t command.

The up command is used in the BASIC/FlashBASIC debugger to move up the call stack.

The v command verifies the current BASIC object code by performing a checksum verification. This determines if the object code has been corrupted since the last time it was compiled.

The [ command sets the left output zone limits of debugger display.

The \ command is used by the BASIC/FlashBASIC debugger to display the current value of a variable or integer expression.

The ] command sets the right output zone limits of debugger display.