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.
