Using breakpoints

A breakpoint causes the execution of a thread to suspend at the location where the breakpoint is set.

A list of all breakpoints (for all debug sessions) is displayed in the Breakpoints view, unless you use the filter by debug target action. To filter out breakpoints that are not related to the current debug session, click the Breakpoints view Show Breakpoints Supported by Selected Target push button (). To link the Breakpoints view with the Debug view, click the Link with Debug view toggle (). When this toggle is selected, only those breakpoints that are associated with the selected debug target in the Debug view will be displayed in the Breakpoints view.

Note: Filtering by debug target does not filter out breakpoints for debug targets that are similar to that of the current debug session.

The breakpoint entries in the list indicate which file the breakpoint has been set in and provide you with a summary of the breakpoints' properties. With pop-up menu options, you can remove breakpoints, enable or disable breakpoints, and go to the location of the breakpoint in the editor source file. And, with push buttons in the Breakpoints view, you can remove breakpoints. In addition, you can right-click on a breakpoint in the Breakpoints view and select Properties - or right-click a breakpoint in the editor marker bar and select Breakpoint Properties from the pop-up menu. This will invoke the Breakpoint Properties dialog box, where you can view details of the breakpoint. In this dialog box, you can enable a condition for the breakpoint by selecting the Enable Condition check box and entering the condition in the field.

Breakpoints can be enabled and disabled using pop-up menus or check box in the Breakpoints view - or by check box in the Breakpoint Properties dialog box. When a breakpoint is enabled, it will cause a thread to suspend whenever it is hit. When a breakpoint is disabled, it will not cause threads to suspend. For further information about enabling and disabling breakpoints, see the related topic.

There are two indicators to the left of a set breakpoint. To the far left is a check box which indicates if the breakpoint is enabled (when enabled, the check box contains a check mark). To the near left, a filled indicator indicates a breakpoint that has been successfully installed by the debug engine.

While in the Breakpoints view, the source editor will open to the location of a breakpoint if you perform one of the following tasks:

Related concepts
Breakpoints
Related tasks
Controlling program execution and working with breakpoints
Running
Stepping through Jython script
Enabling and disabling breakpoints
Removing breakpoints

Feedback