This section describes all debugger commands that directly execute debug functions or navigate in debugger screens.
For an explanation of more complex command structures with user-defined operands, see Syntax Diagrams below.
This section covers the following topics:
The debug commands listed in the table below can be entered in the command line of any debugger screen. An underlined portion of a debug command or subcommand represents its minimum abbreviation.
Command | Subcommand(s) | Explanation |
---|---|---|
- |
Scrolls one page up in a list. | |
-- |
Scrolls to the beginning of a list. | |
TOP |
||
+ |
Scrolls one page down in a list. | |
++ | Scrolls to the end of a list. | |
BOTTOM |
||
ACTIVATE
(syntax below) |
BREAKPOINT
or
|
Activates breakpoints as described in Breakpoint Maintenance. |
SPY |
Activates breakpoints and watchpoints: see also Activate Spy in Spy Maintenance. | |
WATCHPOINT
or
|
Activates watchpoints as described in Watchpoint Maintenance. | |
BM |
Invokes the Breakpoint Maintenance menu described in Breakpoint Maintenance. | |
BREAK |
Displays the Debug Break window:
see also BREAK
in Navigation and Information Commands.
|
|
CANCEL |
Cancels the current operation and/or exits screens without saving modifications. | |
DBLOG |
A
or
or
|
Invokes the DBLOG
utility (see the Utilities documentation) from
within the debugger.
To specify a database environment, use one of the subcommands:
Note: |
DEACTIVATE
or
(syntax below) |
BREAKPOINT
or
|
Deactivates breakpoints as described in Breakpoint Maintenance. |
SPY |
Deactivates breakpoints and watchpoints: see also Deactivate Spy. | |
WATCHPOINT
or
|
Deactivates watchpoints as described in Watchpoint Maintenance. | |
DELETE
(syntax below) |
BREAKPOINT
or
|
Deletes breakpoints as described in Breakpoint Maintenance. |
SPY |
Deletes breakpoints and watchpoints: see also Delete Spy. | |
WATCHPOINT
or
|
Deletes watchpoints as described in Watchpoint Maintenance. | |
ENVIRONMENT |
Deletes the specified debug environment: see also Delete Debug Environment. | |
DISPLAY
(syntax below) |
BREAKPOINT
or
|
Displays breakpoints as described in Breakpoint Maintenance. |
SPY |
Displays breakpoints and watchpoints: see also Display Spy. | |
WATCHPOINT
or
|
Displays watchpoints as described in Watchpoint Maintenance. | |
CALL |
Displays statistics on Natural objects invoked during the execution of an application: see also Display Called Objects. | |
EXEC |
Displays statistics on executed statement lines of invoked Natural objects: see also Display Executed Statement Lines. | |
HEXADECIMAL |
Displays the contents of variables in hexadecimal format. | |
NOCALL |
Displays statistics on Natural objects that have not been invoked during the execution of an application: see also Display Non-Called Objects | |
NOEXEC |
Displays statistics on non-executed statement lines of invoked Natural objects: see also Display Non-Executed Statement Lines. | |
OBJECT |
Displays statistics on the call frequency of objects: see also Display All Objects. | |
STATEMENT |
Display statistics on executed and non-executed statement lines of invoked Natural objects: see Display All Statement Lines . | |
VARIABLE |
Displays variables for interrupted Natural objects as described in Variable Maintenance. | |
XSTATISTICS |
Displays a statistical summary of execution statistics: see also Display Statement Execution Statistics. | |
EM |
Invokes the Debug Environment Maintenance menu described in Debug Environment Maintenance. | |
ESCAPE
|
BOTTOM |
Stops processing a loop and escapes to the first
statement after the loop: see ESCAPE
BOTTOM in Execution Control
Commands.
|
ROUTINE |
Stops processing an interrupted Natural object and
continues with another object, if available: see
ESCAPE ROUTINE in
Execution Control Commands.
|
|
EXIT |
Leaves the current screen: see EXIT in
Execution Control Commands.
|
|
FLIP |
Switches between the display of the two PF-key lines (PF1 to PF12 and PF13 to PF24). | |
GO |
Returns control to the execution of the interrupted
Natural object: see GO in Execution
Control Commands.
|
|
LAST |
Displays the command entered last. The last three commands are stored and can be recalled. | |
LEFT |
Shifts to the left side of a source code listing. | |
LIST
(syntax below) |
Displays the source code of an object. | |
BREAK |
Shows the object source with the current break. The relevant statement line is highlighted. | |
LASTLINE |
Shows the object source with the last line executed before the current break. | |
LOAD
(syntax below) |
ENVIRONMENT |
Loads the debug environment specified: see Load Debug Environment. |
MENU |
Invokes the Debug Main Menu. | |
MODIFY
(syntax below) |
BREAKPOINT
or
|
Modifies breakpoints as described in Breakpoint Maintenance. |
SPY |
Invokes the Modify Breakpoint or Modify Watchpoint screen: see also Modify Spy in Spy Maintenance. | |
WATCHPOINT
or
|
Modifies watchpoints as described in Watchpoint Maintenance. | |
HEXADECIMAL |
Modifies the contents of variables in hexadecimal format. | |
VARIABLE |
Invokes the Display Variable screen for modification as described in Modify Variable (using PF5). | |
NEXT |
Executes the next command specified for a breakpoint or watchpoint. | |
OBJCHAIN
|
Displays executed objects at various program levels: see
OBJCHAIN in
Navigation and Information Commands.
|
|
ON
or
|
Switches test mode on or off. See also Switch Test Mode On and Off. | |
PRINT
(syntax below) |
CALL |
Prints statistics on Natural objects invoked during the execution of an application: see also Display Called Objects. |
EXEC |
Prints statistics on executed statement lines of invoked Natural objects: see also Display Executed Statement Lines. | |
NOCALL |
Prints statistics on Natural objects that have not been invoked during the execution of an application: see also Display Non-Called Objects. | |
NOEXEC |
Prints statistics on non-executed statement lines of invoked Natural objects: see also Display Non-Executed Statement Lines. | |
OBJECT |
Prints statistics on the call frequency of objects: see also Display All Objects. | |
STATEMENT |
Prints statistics on executed and non-executed statement lines of invoked Natural objects: see also Display All Statement Lines. | |
XSTATISTICS |
Prints statistics on executed statement lines: see also Display Statement Execution Statistics. | |
PROFILE
|
Displays the User Profile screen where you can modify the profile of the debugger as described in Navigation and Information Commands. | |
RESET
(syntax below) |
ENVIRONMENT |
Resets the current debug environment: see Reset Debug Environment. |
RIGHT |
Shifts to the right side of a source code listing. | |
RUN |
Switches off test mode and continues program execution. | |
SAVE
(syntax below) |
ENVIRONMENT |
Resets the current environment and saves the debug specifications. See also Save Debug Environment. |
SCAN |
ABS |
Only applies when using the function
(see List Object Source).
Searches for a value in the source code of an object: see
|
SCREEN |
When entered upon interruption of an object, displays the current screen output of the interrupted Natural object. ENTER takes you back to debug mode. | |
SET
(syntax below) |
BREAKPOINT
or
|
Invokes the Set Breakpoint screen described in Breakpoint Maintenance. |
CALL ON
or
|
Activates or deactivates call statistics as described in Call Statistics Maintenance. | |
OBJECT |
Changes the default object specified for the debugger.
See also SET
OBJECT in Navigation and Information
Commands.
|
|
WATCHPOINT
or
|
Invokes the Set Watchpoint screen described in Watchpoint Maintenance. | |
XSTATISTICS ON
or
or
|
Activates (ON or COUNT )
deactivates (OFF ) the statement execution statistics as described
in Set
Statement Execution Statistics.
|
|
SM |
Invokes the Spy Maintenance menu described in Spy Maintenance. | |
STACK |
Displays the contents of the entry at the top of the
Natural stack: see STACK in
Navigation and Information Commands.
|
|
STEP
|
[n ]
|
Continues an interrupted Natural object
for the number (n) of executable statements
specified with the command. If you do not specify n,
one executable statement is skipped by default. See also
STEP in
Execution Control Commands.
|
SKIPSUBLEVEL
[n ]
|
Continues step-mode processing of Natural objects
without entering programs at sub-levels. You can specify a level number
(n). See also STEP
SKIPSUBLEVEL in Execution
Control Commands.
|
|
STOP |
Terminates both the debugger and any interrupted Natural
object; the NEXT prompt appears.
|
|
SYSVARS |
Displays the current values of a limited set of system variables (except the database-related system variables). See also Display System Variables. | |
TEST ON
or
|
Switches test mode on or off. See also Switch Test Mode On and Off. | |
WM |
Invokes the Watchpoint Maintenance menu described in Watchpoint Maintenance. |
The syntax diagrams listed below refer to more complex command sequences.
For detailed explanations of the symbols used within the syntax descriptions, see the section System Command Syntax in the System Commands documentation.
For better readability, synonymous keywords are omitted from the syntax diagrams below. An underlined portion of a keyword represents an acceptable abbreviation.
Valid synonyms are:
Keyword | Synonym |
---|---|
BREAKPOINT |
BP |
DEACTIVATE |
DA |
WATCHPOINT |
WP |
This section covers the following topics:
ACTIVATE |
SPY |
name | ||||||
number | ||||||||
BREAKPOINT |
[
object ] [ line
]
|
|||||||
WATCHPOINT |
[ object ]variable |
DEACTIVATE |
SPY |
name | ||||||
number | ||||||||
BREAKPOINT |
[ object ] [ line ] | |||||||
WATCHPOINT |
[object]variable |
DELETE |
SPY |
name | ||||||
number | ||||||||
BREAKPOINT |
[ object ] [ line ] | |||||||
WATCHPOINT |
[ object ] variable | |||||||
XSTATISTICS |
[ library ] object | |||||||
ENVIRONMENT |
[ name ] |
DISPLAY
|
SPY |
name | ||||||
number | ||||||||
BREAKPOINT |
[ object ] [ line ] | |||||||
WATCHPOINT |
[ object ] variable | |||||||
CALL |
library [ object ] | |||||||
OBJECT |
||||||||
NOCALL |
||||||||
XSTATISTICS |
||||||||
STATEMENT |
||||||||
EXEC |
||||||||
NOEXEC |
||||||||
VARIABLE |
variable-name [index-specification],... | |||||||
HEXADECIMAL |
LIST
|
LASTLINE
|
||
BREAK |
|||
object [ line ] |
LOAD
ENVIRONMENT [
name ]
|
MODIFY |
SPY |
name | ||||||
number | ||||||||
BREAKPOINT |
[
object ] [ line
]
|
|||||||
WATCHPOINT |
[ object ] variable | |||||||
VARIABLE |
variable [ = new value ] | |||||||
HEXADECIMAL
|
PRINT
|
CALL
|
library [ object ] | ||||
OBJECT
|
||||||
NOCALL
|
||||||
XSTATISTICS
|
||||||
STATEMENT
|
||||||
EXEC
|
||||||
NOEXEC
|
RESET ENVIRONMENT [
name ]
|
SAVE ENVIRONMENT [
name ]
|
SET |
OBJECT |
object | ||||||||
BREAKPOINT |
object | line | ||||||||
label | ||||||||||
WATCHPOINT |
[ object] variable | |||||||||
CALL |
OFF |
|||||||||
ON |
||||||||||
XSTATISTICS |
OFF |
library [ object ] | ||||||||
ON |
||||||||||
COUNT |