Working with breakpoints
Breakpoints are instructions that Collaboration Debugger
uses to pause the execution of a collaboration object. You set breakpoints
at node in the business process where you want to inspect the data
of a flow to observe its transformation and troubleshoot problems.
You can set breakpoints on the following types of nodes:
- Action node
- Subdiagram node
- Iterator node
- End success node
- End failure node
- Iterator node
- Break node
You can not set a breakpoint on a decision node.
For more information about the different types of nodes in a
collaboration template, see the WebSphere InterChange Server: Collaboration Development Guide.
The following sections describe how you can arrange breakpoints
in a collaboration you are debugging:
After you have arranged breakpoints in the collaboration object,
use the instructions in Performing debugging operations to
manage the processing of the flow.
Setting breakpoints
Do one of the following to set a breakpoint on a supported
node:
- Right-click the node and choose Set breakpoint(s) from
the context menu
- Select the node and click Set breakpoint(s) in
the toolbar of Collaboration Debugger
- Select the node and select Collaboration Debugger > Set breakpoint(s) from
the menu bar
- Double-click a node that does not have a breakpoint set on it
already
Displaying breakpoints
Do one of the following to select and give focus to a
node on which a breakpoint has been set:
- Right-click the breakpoint in the "Breakpoints" view
and choose Display from the context menu
- Double-click the breakpoint in the "Breakpoints" view
- Select the breakpoint in the "Breakpoints" view
and press Enter
- Select the breakpoint in the "Breakpoints" view
and click Display in the toolbar of the "Breakpoints" view
- Select the breakpoint in the "Breakpoints" view,
click the drop-down arrow in the upper-right-hand corner of the
title bar, and choose Display
- Select the breakpoint in the "Breakpoints" view
and click Display in the toolbar of Collaboration Debugger
- Select the breakpoint in the "Breakpoints" view
and select Collaboration Debugger > Display breakpoint(s) from
the menu bar
Removing breakpoints
Do one of the following to remove a breakpoint:
- Right-click the node on which the breakpoint is set in the "Collaboration
template" editor and choose Remove breakpoint(s) from
the context menu
- Right-click the breakpoint in the "Breakpoints" view
and choose Remove from the context menu
- Select the breakpoint in the "Breakpoints" view
and click Remove in the toolbar of the "Breakpoints" view
- Select the breakpoint in the "Breakpoints" view,
click the drop-down arrow in the upper-right-hand corner of the
title bar, and choose Remove
- Select the node on which the breakpoint is set in the "Collaboration
template" editor and click Remove breakpoint(s) in
the toolbar of Collaboration Debugger
- Select the node on which the breakpoint is set in the "Collaboration
template" editor and select Collaboration Debugger > Remove breakpoint(s) from
the menu bar
- Double-click a node that has a breakpoint set on it
Disabling breakpoints
Do one of the following to disable a breakpoint so that
execution no longer pauses at the specified node, but so that you
can re-activate it if necessary:
- Right-click the node on which the breakpoint is set in the "Collaboration
template" editor and choose Disable breakpoint(s) from
the context menu
- Right-click the breakpoint in the "Breakpoints" view
and choose Disable from the context menu
- Select the breakpoint in the "Breakpoints" view
and click Disable in the toolbar of the "Breakpoints" view
- Select the breakpoint in the "Breakpoints" view,
click the drop-down arrow in the upper-right-hand corner of the
title bar, and choose Disable
- Select the node on which the breakpoint is set in the "Collaboration
template" editor and click Disable breakpoint(s) in
the toolbar of Collaboration Debugger
- Select the node on which the breakpoint is set in the "Collaboration
template" editor and select Collaboration Debugger > Disable breakpoint(s) from
the menu bar
Enabling breakpoints
Do one of the following to enable a breakpoint that has
been disabled:
- Right-click the node on which the breakpoint is set in the "Collaboration
template" editor and choose Enable breakpoint(s) from
the context menu
- Right-click the breakpoint in the "Breakpoints" view
and choose Enable from the context menu
- Select the breakpoint in the "Breakpoints" view
and click Enable in the toolbar of the "Breakpoints" view
- Select the breakpoint in the "Breakpoints" view,
click the drop-down arrow in the upper-right-hand corner of the
title bar, and choose Enable
- Select the node on which the breakpoint is set in the "Collaboration
template" editor and click Enable breakpoint(s) in
the toolbar of Collaboration Debugger
- Select the node on which the breakpoint is set in the "Collaboration
template" editor and select Collaboration Debugger > Enable breakpoint(s) from
the menu bar
Filtering breakpoints
You can filter the "Breakpoints" view
to only display breakpoints set on certain types of nodes. Do the following
to filter the "Breakpoints" view:
- Do one of the following to display the "Breakpoints
Filter" dialog:
- Click Filter in the title bar of the "Breakpoints" view
- Click the down-facing arrow in the upper-right-hand corner of
the title bar of the "Breakpoints" view and select Filter from
the drop-down menu
Collaboration Debugger displays the "Breakpoints Filter" dialog,
as shown in Figure 93:
Figure 92. Breakpoints filter
- Use the following techniques to configure your filter settings:
- Enable the All Node Types checkbox to
display all supported node types
- Enable only the checkboxes for specific node types to display
only those types
- Click Reset to apply the default filter
settings
- Enable one of the following radio buttons to specify how broadly
the filter should be applied:
- for all collaboration objects
- for current collaboration object only
- for current diagram only
- for current diagram and its children
- Click OK.
