FlashBASIC Debugger Commands

When the BASIC/FlashBASIC debugger is entered, it indicates the source code line number to be executed next and prompts for commands with an asterisk.

The following FlashBASIC debugger commands are presented:

# Command

Displays the item-ID of the error message that caused the most recent abort into the BASIC/FlashBASIC debugger.

$ Command

Displays the current program name and current line number, and verifies the object code.

$! Command

Displays the current call stack with parameter names and values being shown.

/ Command

References and optionally alters the contents of variables within the run-time code being executed.

? Command

Displays the current program name and line number.

?! Command

Displays the current call stack with current parameter values being shown.

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.

c Command

Toggles on or off the display of the current source line when stepping through the program with CTRL+J.

CTRL+J Command

Has the same effect as the BASIC/FlashBASIC debugger g command, except that CTRL+J only requires one character.

CTRL+N Command

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.

d Command

Displays the contents of the breakpoint and trace table.

de Command

Invokes the system debugger from the BASIC/FlashBASIC debugger.

debug Command

Temporarily exits the BASIC/FlashBASIC debugger and invokes the system debugger.

down Command

Used to move down the call stack.

e Command

Indicates the number of instructions to execute prior to returning to the BASIC/FlashBASIC debugger.

edit Command

Invokes the Update Processor for editing the current program from within the BASIC/FlashBASIC debugger.

end Command

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

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.

k Command

Kills a breakpoint previously set with the b command, and removes the entry from the breakpoint table.

l Command

Lists the current source line, or a specified range of lines, from the corresponding source program being executed.

lp Command

Toggles the line printer bit status, either directing debugger output to the terminal screen or to the Spooler.

n Command

Ignores any debugger breakpoint conditions for a specific number of occurrences.

off Command

Stops processing at all levels on the current port and returns control to the initial logon prompt.

p Command

Toggles disabling output display; debugger output is still displayed.

pc Command

Closes the current spooler entry and releases the print job to the Spooler.

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.

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.

s Command

Displays the contents of the subroutine stack.

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.

u Command

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

up Command

Used to move up the call stack.

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.

[ Command

Sets the left output zone limits of debugger display.

\ Command

Displays the current value of a variable or integer expression.

] Command

Sets the right output zone limits of debugger display.