![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Using the Debugger WindowThe Debugger Window displays the activities associated with the debugging session. The Debugger Window contains four possible sub-windows: Source Pane, Log Pane, Command Pane and Status Pane. By default, the Log and Command Line Pane windows are displayed. The Source Pane and Status Pane are not displayed by default.
Additional information on the interfaces to the the debugger can be found in Using the Apex Debugger.
![]()
Debugger Mode Configuration
The Apex debugger can be configured to behave in one of two modes for the display of source code: either through one of the editors or through its own source pane in the debugger window. You can configure the default source display method that's used when the debugger starts up. You can also toggle between them during a debugging session.
Using an Apex editor to display source allows you to retain the full capabilities of the editor while you're debugging. For example, you can perform Summit/CM, compilation, or editing operations during a debugging session.This display mode is called editor mode. It is the default.
The debugger's source display is optimized for debugging. It doesn't provide facilities for editing, compilation, or source control, for example. It does provide extra features specifically designed for debugging. For example, it contains source indicators that show where breakpoints are set. This mode is called Show Source.
There are several ways to configure the debugger mode:
- Set the X resource Rational.Debugger.log*debugSource: to True. This will cause the debugger to operate in Show Source mode by default.
- Once you are in the debugger, you can easily switch modes using the View > Show Source command which toggles between the two modes. To save the show source mode as your default, use the Tools > Session > Save Window Properties command after selecting this display mode.
- Select the Visit Editor button on the Toolbar to display the editor window.
To toggle the display of the Source pane, the Status Pane, and Command Line pane from within the debugger, use the View menu selections View > Show Source, View > Show Status Pane, and View > Show Command Pane.
The Log Window
The Debugger Command/Log window displays the activities associated with the debugging session. The following information is included:
- Current debugger version number
- Execution state
- Breakpoint-creation information
- Breakpoint-activation/deactivation information
- Breakpoint-removal information
- Exception-catch/propagate requests
- Requested object values
- Debugging error messages
Command Pane
The Debugger Command Pane is used to enter debugger commands through the command line interface. A listing of all the commands that can be entered through the Command Pane can be found in Using the Apex Debugger..
Source Pane
The Source Pane is used to display program source text. Use of this window allows you to do all your debugger operations within the Debugger window, without using the editor.
This program source can either be in regular source mode or in disassembly mode. Source mode is the default. In disassembly mode, the source window contains disassembled machine instructions, interspersed with source code, if available. Toggle between source and disassembly mode by positioning your cursor in the source window and entering I (capital I).
A number of commands are available directly from the Source pane. All these command require that the cursor be positioned in that window. For example, typing b causes a breakpoint to be set at the current cursor location and a red stop sign appears to the left of the line number. Typing d deletes the breakpoint. Execution can be continued, the call stack can be displayed and traversed, and a variety of stepping commands are available directly from the Source window.
Status Pane
The Status Pane displays the status of the program being debugged. The following information is displayed in the Status Pane:
state stop_frame task_id_number file_name
Additional Topics
Rational Software Corporation http://www.rational.com support@rational.com techpubs@rational.com Copyright © 1993-2001, Rational Software Corporation. All rights reserved. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |