
	Version 4.2.6 for Mainframes (Update)	SEARCH INDEX CONTENTS \| PDF PAGE PDF BOOKS \| HOME UP PREV NEXT

— 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
Syntax Diagrams

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 to the beginning of a list.
`+`		Scrolls one page down in a list.
++		Scrolls to the end of a list.
`BOTTOM`		Scrolls to the end of a list.
`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.
`ESCAPE`	`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.
`STEP`	`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.

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
DEACTIVATE
DELETE
DISPLAY
LIST
LOAD
MODIFY
PRINT
RESET
SAVE
SET

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`

SEARCH INDEX CONTENTS | PDF PAGE PDF BOOKS | HOME UP PREV NEXT