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

This command resumes a suspended thread.

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

This command terminates the selected debug target.


Context menu only

Terminate & Remove

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


Context menu only

Terminate All

This command terminates all active launches in the view.

Disconnect

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

Remove All Terminated Launches

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

Step Into

This command steps into the highlighted statement.

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

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

Show Qualified Names

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


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.

Context menu only

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 from the context menu.

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 only

Relaunch

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

Context menu only

Use Step Filters

This option can be toggled to apply step filters when performing Step Into.

 

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


Copyright IBM Corporation 2000, 2002. All Rights Reserved.