This section describes the direct commands the debugger provides for navigating through the debugging areas, scrolling screen displays, obtaining various information on objects and variables, and specifying profiles. For a summary of all commands available with the debugger, refer to Command Summary and Syntax.
The command BREAK is the default command
which is automatically set when creating a new debug entry. It displays the
Debug Break window described in
Debug Break
Window in the section Concepts of the
Debugger.
When the command BREAK is deleted upon
modification of the corresponding debug entry, no Debug
Break window appears. However, other specified commands are executed
and the event count is increased.
The command FLIP switches between the
display of the two PF-key lines (PF1 to PF12 and
PF13 to PF24).
The command LAST displays the command
last entered. The last three commands are stored and can be recalled.
The command OBJCHAIN can only be used
when a Natural object has been interrupted.
This command displays the objects on the current level and all superior levels, as well as the current GDA (global data area), if applicable, and provides information on the interruption.
When you enter the command ON or
OFF in the debugger, test mode is switched on or off
respectively. See also TEST
ON/OFF.
The command PROFILE displays the
User Profile screen where you can modify the profile of
the debugger.
The User Profile screen provides the following options:
| Option | Explanation |
|---|---|
| Reset debug environment automatically on exit | Specifies an automatic reset of your current debug
environment once you exit the debugger. The default is N
(No).
|
| File for loading/saving debug environments |
Specifies to/from which system file debug environments
are to be saved/loaded: FUSER (default), FNAT or
SPAD (scratch-pad file).
|
| Confirm EXIT/CANCEL before execution | Specifies a confirmation of an
EXIT or CANCEL command
before execution. The default is N (No).
|
| Stack unknown commands | Specifies that any unknown debug command which is
entered (for example, the name of a called program) is to be stacked. If so,
once you enter an unknown debug command, you immediately exit the debugger and
the command is executed. If this option has not been specified, an unknown
debug command leads to a corresponding error message. The default is
Y (Yes).
|
| Output device | Specifies a printer for the functions
(see
Print Objects)
and (see
Print
Statements).
The default value is |
| Maximum debug buffer size in KB | Specifies the maximum size (in kilobytes) of the debug
buffer. The debug buffer is automatically enlarged as required, but only up to
the specified maximum. Enter 0 to indicate no limit or enter a
value from 4 - 16384 (must be a multiple of 4). If the limit would be exceeded,
no further debug entries can be defined and no additional call or statement
execution statistics entries are generated.
|
Only applies to the List object source function (see List Object Source).
This command searches for a string of characters within an object source:
SCAN searches for the value specified
which may be delimited by blanks or any characters that are neither letters nor
numeric characters.
SCAN ABS results in an absolute scan
of the source code for the specified value regardless of what other characters
may surround the value.
See also the syntax diagrams in Command Summary and Syntax.
When you enter the command SCREEN upon
interruption of a Natural object, the current screen output of the interrupted
Natural object is displayed. ENTER takes you back to debug mode.
The command SET OBJECT changes the name
of the default object as
described in the relevant section in Start the Debugger. See
also the syntax of SET in the section
Command Summary and Syntax.
When you enter the command STACK, the
contents of the entry at the top of the Natural stack is displayed. Up to 15
individual top entry elements can be displayed. Elements longer than 55
characters are truncated and marked with an asterisk (*).
Note:
An error message is displayed if any single element is longer
than 249 characters.
When you enter this command, the current values of a limited set of system variables are displayed.
The command TEST ON or TEST
OFF switches test mode on or off respectively. In the debugger,
you only need to enter ON or OFF as described
above.
Note:
The TEST command can be disallowed by
Natural Security as described in
Command
Restrictions in the section Library
Maintenance in the Natural Security
documentation.