Use the Application Preferences window to customize debugger appearance and function to
your needs.
Debugger settings are gathered into related groupings. To see and gain access to all
possible areas of customization, expand the display tree shown in the left part of the
Application Preferences window.
Customization groupings and controls in these groupings are described below. Control
group and subgroup names appear in italics, and control names appear in bold.
|
General |
General preferences appear in this group. Controls and control groups in
this group are:
Pane Behavior |
Determines how panes are displayed in the debugger. Controls in this
subgroup are:
Show title bars |
If checked, each pane in the debugger is identified by a title bar at the
top of the pane. |
Highlight selected pane |
If checked, the currently selected pane is identified by highlighting
emphasis applied to its borders. |
Pane History Cache Size |
Enter an integer value to increase or decrease the size of the pane
history cache. |
|
Show logo at startup |
If checked, the IBM Distributed Debugger logo appears while the debugger
is loading and initializing. |
|
|
General->
Appearance |
Use the controls in this group to change the look and feel of the
debugger user interface. Controls are:
Family |
This selection list contains a number of debugger user interface looks.
You can select a debugger look from this list that corresponds to other programming
applications already installed on your system. |
Platform |
Select a GUI style from the selection list to have the debugger adopt the
window control and ornamentation style of the chosen GUI. |
|
|
General->
Toolbars |
Use the controls in this group to configure debugger toolbar access,
appearance, and contents.
Pane |
Control settings in the rest of the window apply to the pane chosen from
this selection list. |
Toolbar Settings |
Settings in this group determine how the toolbar appears in the debugger
windows. Controls are:
Position |
Select a location for the toolbar from the choices presented in this
selection list. |
Behavior |
Settings in this selection list control toolbar visibility and access for
the pane(s) specified in the Pane control. You can select any one of:
- Hide
- Toolbar is hidden at all times.
- Show on pane focus
- Toolbar becomes visible and active only when the specified (usually Source)
pane is selected.
- Enable on pane focus
- Toolbar is always visible, but becomes active only when the specified (usually Source)
pane is selected.
- Show
- Toolbar is visible and active at all times.
|
Appearance |
Select any one of the following radio buttons to control the detail level
shown for individual toolbar items:
- Pictures
- Text
- Pictures and Text
|
|
Toolbar Contents |
Use the controls in this group to add items to or remove items from the
toolbar.
Available Actions |
Only toolbar items applicable to the pane chosen in the Pane
control appear in this selection list. Selecting an item from this list that does not
already exist in the toolbar enables the Add push-button and, if an item
is also selected in the Current Actions selection list, the Insert
push-button. |
Current Actions |
This selection list shows all items currently in the toolbar, in their
order of placement. The top-most item in the Current Actions selection
list corresponds to the left-most or top-most item in the toolbar itself. Selecting an
item in this list enables the Remove push-button. |
Add |
Appends the selected item in the Available Actions
selection list to the end of the Current Actions selection list. |
Insert |
Inserts the item currently selected in the Available Actions
selection list to a position immediately above the item currently selected in the Current
Actions selection list. |
Remove |
Removes the currently selected item from the Current Actions
selection list. |
You can also use these controls to rearrange the order in which items appear on the
toolbar. To do so, first remove the item from the Current Actions
selection list, then add or insert that item back into the Current Actions
list at its new location. |
|
|
General->
Help |
Defines browser options and location used by the debugger help system.
Controls in this group are:
Help Browser |
Select a browser preference from the choices provided in this selection
list. The debugger help
system will use your Windows default browser to display help regardless of the setting
here.
|
Browser Location |
Enter the directory path location where the browser program selected in
the Help Browser control can be found. |
Open help in a separate browser window |
If checked, a separate browser window opens for each help item requested.
If not checked, the same browser window displays each help item as it is requested. |
|
|
Debug |
Defines options that apply to programs that do not have debugger program
profiles. Program profiles default to on. Programs that have been debugged before are not
affected by changes made here. This group contains the following subgroups and controls:
Debugger Defaults |
Use this subgroup to define default behavior for the debugger. Controls
are:
Perform Heap Check on Stop |
Heap check
does not apply to Java programs. Heap
check does not apply to programs running on the AS/400.
Heap check does not apply to programs
running on OS/390.
Select this option to check the integrity of the heap when program execution stops.
Program execution can be stopped by using breakpoints or stepping through your code. No
heap check is performed when the program runs to completion. |
Allow Tool Tip Evaluation |
Select this option to enable hover help. Hover help provides you with a
quick way to view the contents of variables in the Source pane. When you
point at a variable, a pop-up appears displaying the contents of that variable. |
|
Source font |
Use this subgroup to define the font type and size used to display
program code in the Source pane. Controls are:
Font type |
This selection list contains a list of fonts that can be used in the Source
pane. |
Font size |
Select a font size by using the up and down arrows on this control, or
type an integer value directly into this field. Larger integer values correspond to larger
fonts. |
|
Mouse button 2 behavior |
Defines actions available when you right-click the mouse. Only one of the
following options can be selected at any time:
Popup Menus and step in white space |
If this option is chosen, right-clicking the mouse raises a pop-up menu,
if available, for the item under the mouse pointer. Right-clicking over white space or
over an item for which no pop-up menu is available performs a step over command. |
|
|
|
Debug->Profiles (program/file) |
This group manages the content and save locations for program profiles
created by the debugger. You can also use controls in this group to delete program
profiles that are no longer needed.
Delete profiles |
Directory |
This field accepts a path location in which program profiles can be found
or saved. To store program profiles in a new location, enter a new directory path in this
field. You can also click on Browse to open a file selection window which
you can use to find existing profiles or select a new profile save location. The Browse window lists files residing on the local
workstation only or files that are accessible through a mapped network drive. |
Select profiles to delete |
The control lists program profiles found in the path specified in the Path
control. Select any number of profiles from this list, then click the Delete
button to delete the selected profiles. |
Delete |
Clicking on this deletes the program profiles selected in the Select profiles
to delete list. |
|
|
|
Debug->program->
Exception Filter
Preferences Settings |
This group does
not apply when debugging on the AS/400. This group appears once for each program loaded
into the debugger, where program is the name of a program loaded in the debugger.
Place a check mark beside the types of execeptions or the exception level you want the
debugger to recognize.
You can also use the following controls to define exception types recognized by the
debugger:
|
|
Debug->program->
Default Array/Struct/Class
start/max |
 This group appears once for each
program being debugged, where program is the name of a program loaded in the
Distributed Debugger.For program elements that contain subelements (for example,
arrays), you can define how the subelements are displayed in the Monitors pane or the
Locals pane.
Use the following controls to define how the debugger displays subelements:
Maximum number of elements |
Enter the maximum number of subelements you want displayed when you
expand an element. |
Starting element |
Enter the number of the subelement where you want display to start when
an element is expanded. |
Debugger Defaults |
If checked, the maximum number of elements and starting element number
currently selected become the new default numbers for the debugger. This new default takes
effect when you next load a program into the debugger. |
Default |
Changes the maximum number of elements and the starting element number to
the numbers defined to be the default for the debugger. |
|
|
Debug->program->
Default Monitor
Representations |
This group appears once for each program loaded into the debugger, where program
is the name of a program loaded in the debugger. 
For each variable type in the table, you can select a representation from a list of valid
representations.
For each set of
languages and variable type in the table, you can select a representation from a list of
valid representations. The list of valid representations appears when you click on the
representation associated with a variable type.
Once set, any variables or expression appearing in the Monitors pane or the Locals pane
will be initially displayed in the representations you selected.
You can also use the following controls to define default monitor representations for
the debugger:
Debugger Defaults |
If checked, the representations currently selected become the new default
set of representations recognized by the debugger. This new default takes effect when you
next load a program into the debugger. |
Default |
Changes the list of representations to the set of representations defined
to be the default for the debugger. |
|
|
Application Preferences Push-buttons |
OK |
Applies your selected preferences to the debugger, then closes the
Application Preferences window. |
Cancel |
Cancels all preference selections and closes the Application Preferences
window. |
Help |
Displays this panel. |
|