Version 4.2.6 for Mainframes (Update)
 —  Debugger  —

Command Summary and Syntax

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:


All Debug Commands

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 down 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

BP

Activates breakpoints as described in Breakpoint Maintenance.
SPY Activates breakpoints and watchpoints: see also Activate Spy in Spy Maintenance.
WATCHPOINT

or

WP

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

Q

or

D

Invokes the DBLOG utility (see the Utilities documentation) from within the debugger.

To specify a database environment, use one of the subcommands:

  • A = Adabas (this is the default)

  • Q = SQL

  • D = DL/I

Note:
During a debug interrupt, you can only specify one of the subcommands listed above.

DEACTIVATE

or

DA

(syntax below)

BREAKPOINT

or

BP

Deactivates breakpoints as described in Breakpoint Maintenance.
SPY Deactivates breakpoints and watchpoints: see also Deactivate Spy.
WATCHPOINT

or

WP

Deactivates watchpoints as described in Watchpoint Maintenance.
DELETE

(syntax below)

BREAKPOINT

or

BP

Deletes breakpoints as described in Breakpoint Maintenance.
SPY Deletes breakpoints and watchpoints: see also Delete Spy.
WATCHPOINT

or

WP

Deletes watchpoints as described in Watchpoint Maintenance.
ENVIRONMENT Deletes the specified debug environment: see also Delete Debug Environment.
DISPLAY

(syntax below)

BREAKPOINT

or

BP

Displays breakpoints as described in Breakpoint Maintenance.
SPY Displays breakpoints and watchpoints: see also Display Spy.
WATCHPOINT

or

WP

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 a 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

BP

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

WP

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 .
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

OFF

   Switches test mode on or off. See also Switching 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 List object source (see List Object Source).

Searches for a value in the source code of an object: see SCAN in Navigation and Information Commands and Syntax Diagrams below.

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

BP

Invokes the Set Breakpoint screen described in Breakpoint Maintenance.
CALL ON

or

CALL OFF

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

WP

Invokes the Set Watchpoint screen described in Watchpoint Maintenance.
XSTATISTICS ON

or

XSTATISTICS COUNT

or

XSTATISTICS OFF

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 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 Variables.
TEST ON

or

TEST OFF

   Switches test mode on or off. See also Switching Test Mode on and Off.
WM    Invokes the Watchpoint Maintenance menu described in Watchpoint Maintenance.

Top of page

Syntax Diagrams

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

ACTIVATE

SPY

name

number
BREAKPOINT [ object ] [ line ]
WATCHPOINT

[ object ]variable

DEACTIVATE

DEACTIVATE

SPY

name

number
BREAKPOINT [ object ] [ line ]
WATCHPOINT

[object]variable

DELETE

DELETE

SPY

name

number
BREAKPOINT [ object ] [ line ]
WATCHPOINT

[ object ] variable

XSTATISTICS

[ library ] object

ENVIRONMENT [ name ]

DISPLAY

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

LIST

LASTLINE

BREAK
object [ line ]

LOAD

LOAD ENVIRONMENT [ name ]

MODIFY

MODIFY

SPY

name

number
BREAKPOINT [ object ] [ line ]
WATCHPOINT

[ object ] variable

VARIABLE

variable [ = new value ]

HEXADECIMAL

PRINT

PRINT

CALL

library [ object ]

OBJECT
NOCALL
XSTATISTICS
STATEMENT
EXEC
NOEXEC

RESET

RESET ENVIRONMENT [ name ]

SAVE

SAVE ENVIRONMENT [ name ]  

SET

SET

OBJECT   object    

BREAKPOINT   object

line

label
WATCHPOINT

[ object] variable

CALL

OFF

 
ON
XSTATISTICS

OFF

library [ object ]

ON
COUNT

Top of page