Setting a line breakpoint

A line breakpoint is set on an executable line of a program in the editor.

When a breakpoint is enabled, the thread that the transformation is running on will suspend before that line of code is executed. The debugger selects the thread that has been stopped by the breakpoint and automatically displays the stack frames for that thread. The line where the breakpoint was set is highlighted in the editor.

In the Breakpoints view, 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 the set breakpoint (when the breakpoint is disabled, this indicator is not filled).

You can add a line breakpoint to source that you have opened in the editor prior to debugging or to source that is open in the editor during a debug session. To add a line breakpoint in the editor, complete these steps:

  1. If you are setting a breakpoint prior to debugging, open the file where you want to add the breakpoint. If you are setting a breakpoint during a debug session, the source file will be opened in the editor automatically.
  2. In the XSL file or XML file, perform one of the following tasks:
    1. Right-click the marker bar (the vertical bar to the left of the main text area) directly to the left of the line where you want to add the breakpoint and select Toggle Breakpoints from the pop-up menu.
    2. Double-click the marker bar directly to the left of the line where you want to add the breakpoint.
    Note: In XSL files, the debugger only recognizes breakpoints that are set in template rules.
  3. A new line breakpoint marker is displayed in both the Breakpoints view and on the marker bar (directly to the left of the line where you added the breakpoint).
Note:
  • In the editor, you cannot set a line breakpoint on a line that already has a breakpoint set on it. When you right-click a line that already has a breakpoint set on it, choosing the Toggle Breakpoints action will remove the breakpoint. Similarly, double-clicking the line will cause removal of the breakpoint.
  • If you try to set a breakpoint on an invalid location in an XSL file, a warning dialog will inform you that the breakpoint cannot be added. The following locations are considered invalid breakpoint locations:
    • blank lines
    • comment lines
    • lines that contain <xsl:stylesheet> and </xsl:stylesheet>
    • the <xsl:output> line
Related concepts
Breakpoints
Related tasks
Using breakpoints
Enabling and disabling breakpoints
Removing breakpoints

Feedback