Using Breakpoints to Debug BPEL Processes
See Also
Breakpoints are used to instruct the BPEL Debugger to stop execution at the specified place of a BPEL process. When a BPEL process instance reaches a breakpoint, it becomes suspended and you can step into the code, change the current process instance in the BPEL Process Instances window, track the execution of the process instance in the BPEL Process Execution window and in the Design view, examine the values of variables in the BPEL Variables window, and view the values of XPath expressions in the Watches window.
You can also use fault breakpoints to check the values of variables before a fault is thrown. For more information, see Using Fault Breakpoints in the BPEL Debugger.
To view and organize the breakpoints currently set in the IDE, open the Breakpoints window by choosing Windows > Debugging > BPEL > Breakpoints (Alt-Shift-5). For each breakpoint, you can see the name of the file and the line where this breakpoint is located.
To set a breakpoint in a BPEL process:
- In the IDE, open the BPEL file in either the Source or Design view.
- Do one of the following:
- In the Source view, click the left margin of the line where you want to place a breakpoint.
- In the Design view, right-click an element where you want to place a breakpoint and choose Toggle Breakpoint.
In the Design view, breakpoints are displayed as small red squares on top of specific elements. In the Source view, breakpoints are shown as red squares on the left margins of code lines.
- Alternatively, you can set and remove breakpoints in the BPEL Logical view of the Navigator window by choosing Toggle Breakpoint from the pop-up menu.
To debug a process instance that has reached a breakpoint:
- Once the execution of your code is suspended, choose the following commands from the Run menu or on the toolbar:
- Continue (Ctrl-F5). Causes the current process instance to run until
it encounters the next breakpoint or until the instance completes. The state of the instance changes to Running.
- Step Into (F7). Steps to the next BPEL activity. As you step, the current line indicator advances, the current position is highlighted on the diagram, and the contents of
the BPEL Debugger windows change accordingly. The step is
supported only at the granularity of an "activity" in BPEL language terms, not at a finer
granularity.
- Run to Cursor (F4). Runs the BPEL process to the position selected in the Navigator window (BPEL Logical View), on the diagram (in the Design view) or to the cursor location in the Source view. When the location of the cursor is reached, the process instance becomes suspended.
To remove a breakpoint from the BPEL process, do one of the following:
- In the Source view, click the left margin of the line that contains the breakpoint.
- In the Breakpoints window, right-click the breakpoint you want to remove and choose Delete. Choosing Delete All from the pop-up menu removes all breakpoints currently set in the IDE.
- In the Design view, right-click the element that has a red breakpoint mark and choose Toggle Breakpoint.
To disable a breakpoint:
- In the Breakpoints window, clear the Enabled checkbox for the breakpoint you want to disable.
This disables the breakpoint but does not remove it completely.
- See Also
- Setting a Java Breakpoint
- Stepping Through Your Program
- Starting and Finishing a BPEL Debugging Session
- Using Watches to Debug BPEL Processes
- Using Fault Breakpoints in the BPEL Debugger
Legal Notices