Version 6.3.8 for Windows
 —  Debugger  —

Setting Breakpoints and Watchpoints

This document covers the following topics:


About Breakpoints and Watchpoints

Two types of entries can be defined in a program for debugging purposes:

Each breakpoint or watchpoint is displayed in the corresponding tab of the break- and watchpoints window. For each breakpoint, the number of the line is shown in which the breakpoint has been defined. For each watchpoint, a name is assigned that corresponds to the name of the variable to which it belongs and the break condition is shown.

Using the check box in the first column of a tab, a breakpoint or watchpoint can be activated or deactivated at any time during a debugging session. See Deactivating Breakpoints and Watchpoints Temporarily.

Every breakpoint or watchpoint has a hit count which increases every time the debug entry is passed. The number of executions of a debug entry, however, can be restricted in the following ways:

When a breakpoint or watchpoint is hit inside another object but the currently active one, a new editor window is opened displaying the source of this new object.

Top of page

Adding and Removing a Breakpoint

You can add a breakpoint for the current cursor position to the Breakpoints tab of the break- and watchpoints window. Or, if a breakpoint already exists for this cursor position, you can remove it from the Breakpoints tab.

A dialog box does not appear in this case. If you want to modify the breakpoint (for example, to define the maximum number of breaks), see Modifying a Breakpoint.

See also Deleting Breakpoints and Watchpoints.

Note:
In the local environment and in a remote environment (SPoD), it is also possible to set and remove breakpoints as described below when the debugger is not active. Each breakpoint which has been defined in the editor will then be verified when the debugger is started. When the breakpoint is not allowed at the defined position, it will then be moved to the next line in which it is possible to define a breakpoint. See also Debugger Window in the documentation Using Natural Studio.

Start of instruction setTo toggle a breakpoint

  1. Select the line on which you want to set or remove a breakpoint.

  2. Invoke the context menu in the editor and choose Toggle Breakpoint.

    Or:
    Press F9.

    Or:
    When the Debug toolbar is shown, choose the following toolbar button:

    Toolbar button

    Or:
    In the left margin of the editor window (where the symbols for the breakpoints are usually shown), click a position next to the required line.

    When a breakpoint is set, a symbol is now shown in the left margin of the editor window. See Symbols Used in the Editor Window. An entry for the breakpoint is also shown on the Breakpoints tab of the break- and watchpoints window.

    When a breakpoint has been removed, the corresponding symbol is no longer shown. The entry for the breakpoint is removed from the Breakpoints tab of the break- and watchpoints window.

Top of page

Modifying a Breakpoint

You can modify each breakpoint which is currently shown in the break- and watchpoints window.

Start of instruction setTo modify a breakpoint

  1. Select the required breakpoint, invoke the context menu and choose Modify.

    The following dialog box appears:

    Modify breakpoint

  2. Set the required options:

    Hits before Break

    The number of skips before execution of the breakpoint if it is not to be executed until the program has run a certain number of times. The default is 0.

    Number of Breaks

    The maximum number of executions of the breakpoint. After this number has been reached, the breakpoint is ignored. The default is 0.

    Reset Hit Count

    When you choose this command button, the current hit count is reset to 0.

  3. Choose the OK button.

Top of page

Adding a Watchpoint

Watchpoints are shown on the Watchpoints tab of the break- and watchpoints window.

You can add watchpoints in different ways:

Adding a Watchpoint from the Editor Window

You can add the variable at the current cursor position in the editor window to the Watchpoints tab of the break- and watchpoints window. A dialog is not shown in this case.

Start of instruction setTo define a variable as a watchpoint

  1. Select the variable in the editor by placing the cursor at any position within the variable name.

  2. Invoke the context menu and choose Add to Watchpoints.

    Or:
    Press CTRL+SHIFT+W.

    Or:
    Select the variable in the editor. Use the mouse to drag the selected variable to the Watchpoints tab and drop it there.

Adding a Watchpoint from the Variables Window

You can add a variable from the variables window to the Watchpoints tab of the break- and watchpoints window. A dialog is not shown in this case.

Start of instruction setTo define a variable as a watchpoint

  1. Select the desired variable in the variables window.

  2. Invoke the context menu and choose Add to Watchpoints.

    Or:
    Press CTRL+SHIFT+W.

Adding a Watchpoint Using a Dialog Box

You can use a dialog box to add a watchpoint to the Watchpoints tab of the break- and watchpoints window.

Start of instruction setTo add a watchpoint

  1. From the Debug menu, choose Add Watchpoint.

    Or:
    In the Watchpoints tab of break- and watchpoints window, invoke the context menu and choose Add. Make sure that no other entry is selected. Otherwise, the context menu does not show this command.

    The Add Watchpoint dialog box appears. The title bar indicates the names of the current program and library as well as the database ID and file number of the current FUSER.

    graphics/debug-addwatchpoint.png

  2. Set the required options:

    Variable

    The variable that is to be watched in the debugged program.

    Operator/Value

    To define a condition for the watchpoint, select an appropriate watchpoint operator and specify a value for this operator. If you do not specify a condition, the default setting ("changes") applies.

    The watchpoint operators are:

    Operator Activation of the Watchpoint
    changes Each time the variable is changed. Default.
    EQ (=) Only when the current value of the variable is equal to the specified value.
    NE (!=) Only when the current value of the variable is not equal to the specified value.
    GT (>) Only when the current value of the variable is greater than the specified value.
    LT (<) Only when the current value of the variable is less than the specified value.
    GE (>=) Only when the current value of the variable is greater than or equal to the specified value.
    LE (<=) Only when the current value of the variable is less than or equal to the specified value.
    Skips before Break

    The number of skips before execution of the watchpoint if it is not to be executed until the program has run a certain number of times. The default is 0.

    Number of Breaks

    The maximum number of executions of the watchpoint. After this number has been reached, the watchpoint is ignored. The default is 0.

  3. Choose the OK button.

    The name of the selected variable is now shown on the Watchpoints tab of the break- and watchpoints window.

Top of page

Modifying a Watchpoint

You can modify each watchpoint which is shown in the break- and watchpoints window.

Start of instruction setTo modify a watchpoint

  1. Select the required watchpoint, invoke the context menu and choose Modify.

    The Modify Watchpoint dialog box appears.

    Modify watchpoint

    This dialog box provides the same options as the Add Watchpoint dialog box. See Adding a Watchpoint Using a Dialog Box for a description of the options which can be specified in this dialog box.

    In addition, this dialog box provides the Reset Hit Count button. When you choose this command button, the current hit count is reset to 0.

  2. Make all required changes and choose the OK button.

Top of page

Deactivating Breakpoints and Watchpoints Temporarily

Each defined breakpoint or watchpoint can be deactivated temporarily.

Start of instruction setTo deactivate a breakpoint or watchpoint

  1. Select the required tab in the break- and watchpoints window.

  2. For the desired entry, select the first column of the tab to remove the check mark.

    Or:
    Invoke the context menu and choose Activate/Deactivate.

    When you have deactivated a breakpoint, the symbol which is shown in the left margin of the editor window changes. See Symbols Used in the Editor Window.

Start of instruction setTo activate a deactivated breakpoint or watchpoint

  1. Select the required tab in the break- and watchpoints window.

  2. For the desired entry, select the first column of the tab so that a check mark is shown again.

    Or:
    Invoke the context menu and choose Activate/Deactivate.

    When you have activated a breakpoint, the symbol which is shown in the left margin of the editor window changes. See Symbols Used in the Editor Window.

Start of instruction setTo deactivate or activate all breakpoints or watchpoints

  1. Select the required tab in the break- and watchpoints window.

  2. Make sure that no entry is selected (otherwise, the context menu does not show the required command), invoke the context menu and choose either Deactivate All or Activate All.

    When you have deactivated or activated all breakpoints, the symbols which are shown in the left margin of the editor window change. See Symbols Used in the Editor Window.

Top of page

Showing the Source Code for a Defined Breakpoint or Watchpoint

For each defined breakpoint or watchpoint which is shown in the break- and watchpoints window (no matter whether it is active or not), you can go to the source in which this breakpoint or watchpoint has been defined.

Start of instruction setTo go to the source in which a breakpoint or watchpoint has been defined

  1. Select the required tab in the break- and watchpoints window.

  2. Select the required entry, invoke the context menu and choose Go To Source Code.

    Or:
    Double-click the required entry.

    For a breakpoint, the trace position is shown next to the source code line in which the breakpoint has been defined.

    For a watchpoint, the entire source code in which the watchpoint has been defined is shown.

Top of page

Deleting Breakpoints and Watchpoints

You can either delete selected breakpoints or watchpoints or you can delete all breakpoints or watchpoints.

See also Adding and Removing a Breakpoint.

Start of instruction setTo delete a breakpoint or watchpoint

  1. Select the required tab in the break- and watchpoints window.

  2. Select the required entry.

  3. Invoke the context menu and choose Delete.

    Or:
    Press DEL.

Start of instruction setTo delete all breakpoints or watchpoints

  1. Select the required tab in the break- and watchpoints window.

  2. Make sure that no entry is selected (otherwise, the context menu does not show the required command), invoke the context menu and choose Delete All.

Top of page

Symbols Used in the Editor Window

The following symbols may appear in the left margin of the editor window.

Symbol

This line contains an active breakpoint.

Symbol

This line contains a deactivated breakpoint.

Symbol

This line contains an active breakpoint. It also contains the trace position.

Symbol

This line contains a deactivated breakpoint. It also contains the trace position.

Symbol

This line contains a breakpoint which has not yet been validated (that is, the debugger has not yet reached the marked line). The state can either be shown as active (red background) or inactive (white background).

Symbol

This line contains an invalid breakpoint (for example, when the breakpoint has been set on a line after the END statement). The state can either be shown as active (red background) or inactive (white background).

Top of page