Debug view

This 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 Commands

Command

Name

Description

Resume button

Resume

This command resumes a suspended thread.

Suspend button

Suspend

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

Terminate button

Terminate

This command terminates the selected debug target.

Terminate & Remove command in context menu
Context menu only

Terminate & Remove

This command terminates the selected debug target and removes it from the view.

Terminate All command in context menu
Context menu only

Terminate All

This command terminates all active launches in the view.

Disconnect button

Disconnect

This command disconnects the debugger from the selected debug target when debugging remotely.

Remove All Terminated Launches button

Remove All Terminated Launches

This command clears all terminated debug targets from the view display.

Step with Filters button

Use Step Filters This command toggles step filters on/off. When on, all step functions apply step filters.

Step Into button

Step Into

This command steps into the highlighted statement.

Step Over button

Step Over

This command 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.

Run to Return button

Run to Return

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

Show Qualified Names button

Show Qualified Names

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

Copy Stack command in context menu
Context menu only

Copy Stack

This command copies the selected stack of suspended threads as well as the state of the running threads to the clipboard.

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.

Relaunch command in context menu
Context menu only

Relaunch

This command re-launches the selected debug target.

Context menu only

Properties

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

 

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
Run and debug actions
Views and editors

Legal notices