TOC PREV NEXT INDEX DOC LIST MASTER INDEX




View > Options

When you select the View > Options command from any debugger window, the Debugger Options dialog box is displayed by default. Additional option categories are also available. These are accessed by selecting one of the following tabs.

Category
Types of Options
Source Display
Display of and operations on source code.
Object Display
Display of variables
Stack Display
Set language to be used
Signals
Signal handling
Logging
Debugger log file

If you change the corresponding option in a dialog box, the debugger option will also be updated. These options are part of the debugger state and can be saved using the Debugger State > Save command. Note that the option name matches the name used in the debugger-state files (.dbrc files).

Additional information on debugger options and customizing the debugger can be found in Using the Apex Debugger.

Additional Topics

To see related information, click on a topic:

Source Display

The Debugger Options dialog box is displayed by default when the View > Options command is selected. It contains options relating to the display of source code, definition of search paths, and operations on the source code.

The following options are available from this screen

Option
Description
Source File Lookup Path
Establish the directory search path the debugger uses to find source files.
Add
Name of library to be added to the search path. The library will be added at the top of the list.
Case Sensitive Searches
Make searches case sensitive [Default: off]
Show Line Numbers
Display line numbers in the Source pane. [Default: on].
Show Break Spots
In the Source Pane, display a small square next to each line at which breakpoints can be set. [Default: off]
Tab Size
Set the tab stop for listing source. [Default: 8]

Object Display

The Object Display Options screen is displayed by selecting the Object Display tab on the Debugger Options dialog box.These options control the display of objects and the format of entries on a number of the debugger windows.

Option
Description
Auto Expand Pointers
If selected, sets the default to selected for the Auto Expand Pointers option in the Show Data dialog box so pointer objects are dereferenced. [Default off]
Show_Location
If selected, sets the default to selected for the Show Locations option in the Show Data dialog box. [Default: off].
Type Display
Associate a type with a set of commands that are executed whenever the debugger is asked to display an object of that type.[Default: on].
Display_Levels
Sets the default number of Levels to display in the Show Data dialog box. [Default: 4].
Element_Count
Sets the number of elements to display for an array. This can always be overridden for a given Show command by specifying an explicit slice of the array. [Default:10].
Output Base
Sets the default number base for displaying commands to 8, 10, or 16. [Default:10].

Stack Display

The Stack Display Options screen is displayed by selecting the Stack Display tab on the Debugger Options dialog box.These options control the display of the call stack.

The following options are available from this screen:

Option
Description
Show Parameters
If selected, displays all subprogram parameters in call stack output. [Default: on].
Stack Depth
Sets the number of call levels to display in the stack window. [Default: 10].

Signals

The Signals Options screen is displayed by selecting the Signal tab on the Debugger Options dialog box.The debugger provides a variety of methods for dealing with signals. The Signal Options screen contains a listing of each signal and the action the debugger will take when that signal is encountered.

The following actions may be assigned to each signal:

Action
Description
Break
When the signal occurs, it is announced and the program stops as if it reached a breakpoint
Block
The debugger does not announce the signal but continues the program execution without reasserting the signal.
Ignore
On /proc systems, the signal is passed to the program without debugger notification. For ptrace systems, the signal stops the process, the debugger does not announce the signal and the program execution is continued with the signal passed to it. This option is useful when debugging programs with exception handlers for hardware exceptions.

The action of any signal can be changed by highlighting the signal line and then selecting one of the Change Action bars (Break, Block, Ignore) below the signal list.

The behavior of each signal is controlled separately, so as to ignore some and propagate others to the debugged program.

The behavior of two signals, ALRM and CONT, cannot be changed.

Exercise care in changing certain signal behaviors, since setting signal INT to Break would prevent interruption of the program by Control-C.

Logging

The Log Options screen is displayed by selecting the Logging tab on the Debugger Options dialog box. The Log Options screen allows you to start logging to a file. To enable logging of commands and output, select the Enable Logging entry. If you wish the logging output to be written to a file, enter the debugger pathname of the file. If no file name is entered, logging is restarted to the log file most recently specified. To enable the logging of only the debugger commands entered, select the Enable Command Logging button and enter the name of the file to hold the command output.


Rational Software Corporation 
http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2001, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX DOC LIST MASTER INDEX TECHNOTES APEX TIPS