TOC PREV NEXT INDEX DOC LIST MASTER INDEX




Using the Debugger Window

The 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:

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:

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

To see related information, click on a topic:


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