Debug View

The Debug View allows you to manage the debugging or running of a program in the workbench. It displays the stack frame for the suspended threads for each target you are debugging. Each thread in your program appears as a node in the tree. It displays the process for each target you are running.

If the thread is suspended, its stack frames are shown as child elements.

Debug View

The Execution Control Commands allow you to debug your program, starting, stopping and stepping through the code.

Debug View Commands

Command

Name

Description

Availability

 

Automatic

Configures the debug view to switch layout between a tree and a breadcrumb viewer automatically when the view is resized.

View action
 

Auto-Expand Breadcrumb

Configures the Debug Breadcrumb Drop-down to automatically expand elements when opened.

View action
 

Breadcrumb

Configures the debug view layout to use a breadcrumb viewer.

View action
Copy Stack command in context menu

Copy Stack

Copies the selected stack of suspended threads as well as the state of the running threads to the clipboard.

Context menu
Disconnect button

Disconnect

Disconnects the debugger from the selected debug target when debugging remotely.

Context menu and view action
Copy Stack command in context menu

Drop to Frame

This command lets you drop back and reenter a specified stack frame. This feature is similar to "running backwards" and restarting your program part-way through.

To drop back and reenter a specified stack frame, select the stack frame that you want to "drop" to, and select Drop to Frame.

Some caveats apply to this feature:

  • You cannot drop past a native method on the stack.
  • Global data are unaffected and will retain their current values. For example, a static vector containing elements will not be cleared.
Note: This command is only enabled if the underlying VM supports this feature.
Context menu and view action
  Edit [configuration name]... Opens the launch configuration dialog on the associated launch configuration, allowing you to make changes. Context menu
  Edit Step Filters Opens the Step Filtering preference page to allowing editing of step filters Context menu
Edit Source Lookup Edit Source Lookup Opens the source lookup dialog, allowing you to make changes. Context menu
  Filter Package Adds the containing package for the type from the current suspended execution to the listing of step filters Context menu
  Filter Type Adds the type from the current suspended execution to the listing of step filters Context menu
  Find... Opens the debug view element searching dialog. Context menu
  Lookup Source Forces source lookup to take place Context menu
  Open Declared Type Opens the declared type for the selected stack frame in a new editor. Context menu
  Open Declared Type Hierarchy Opens the type hierarchy for the declared type of the selected stack frame. Context menu
 

Properties

This command displays the properties of the selected launch. It also allows you to view the full command line for a selected process.

Context menu
Relaunch command in context menu

Relaunch

This command relaunches the selected debug target.

Context menu
Remove All Terminated Launches button

Remove All Terminated Launches

Clears all terminated debug targets from the view display.

Context menu and view action
Resume button

Resume

Resumes a suspended thread.

Context menu, Run menu and view action
Show Monitors Show Monitors

This option can be toggled to display or hide monitors.

Note: this command will only display monitor information if the underlying VM supports it.

View action
Show Qualified Names button

Show Qualified Names

This option can be toggled to display or hide qualified names.

View action
Show System Threads Show System Threads This option can be toggled to display or hide system threads View action
Show Thread Groups Show Thread Groups This option can be toggled to display or hide thread groups View action
Step Into button

Step Into

Steps into the highlighted statement.

Context menu, Run menu and view action
Step Over button

Step Over

Steps over the highlighted statement. Execution will continue at the next line either in the same method or (if you are at the end of a method) it will continue in the method from which the current method was called.

The cursor jumps to the declaration of the method and selects this line.

Context menu, Run menu and view action
Run to Return button

Step Return

Steps out of the current method. This option stops execution after exiting the current method.

Context menu, Run menu and view action
Suspend button

Suspend

Suspends the selected thread of a target so that you can browse or modify code, inspect data, step, and so on.

Context menu, Run menu and view action
Terminate button

Terminate

Terminates the selected debug target.

Context menu, Run menu and view action
Terminate All command in context menu

Terminate/Disconnect All

Terminates all active launches in the view.

Context menu
Terminate and Relaunch Terminate and Relaunch Terminates the selected debug target and relaunches it. Context menu
Terminate & Remove command in context menu

Terminate and Remove

Terminates the selected debug target and removes it from the view.

Context menu
 

Tree

Configures the debug view layout to use a tree viewer.

View action
Step with Filters button Use Step Filters Toggles step filters on/off. When on, all step functions apply step filters. Context menu, Run menu and view action

Related concepts

Debugger
Java views
Local debugging
Remote debugging

Related tasks

Changing debugger launch options
Connecting to a remote VM with the Remote Java application launch configuration
Disconnecting from a VM
Launching a Java program
Preparing to debug
Resuming the execution of suspended threads
Running and debugging
Stepping through the execution of a program
Suspending threads

Related reference

Debug Preferences
Views and editors
Run Menu