Running a Route in Debug mode
To follow step by step the execution of a Route to identify possible bugs, you can run it in Debug mode.
Before running your Route in Debug mode, you need to add breakpoints to the components in your Route. This will allow you to automatically stop the Route at each breakpoint. This way, components and their respective variables can be verified individually and debugged if required.
To add breakpoint to a component, right-click it on the design workspace, and select Add breakpoint on the contextual menu.
- starting endpoints
- isolate components like cConfig, cAWSConnection, cMQConnectionFactory, cBeanRegister, and so on
- Routelet
When a breakpoint is added to a component, you can define a condition to it. To do so:
-
Right-click the component on the design workspace, and select Conditional Breakpoint on the popup menu. The Breakpoint view appears on the component tab.
-
On the Breakpoint view, select the Activate conditional breakpoint check box. Select a language from the Languages list and type in the expression in the Expression field to define the breakpoint. If the condition is matched, the Route will stop at the breakpoint. Otherwise the routing process will continued to the next breakpoint.
Once the breakpoints are defined, you can run your Route in Debug mode. To do so:
-
Click the Run view, and the Debug Run tab.
-
Click the Debug button.
The component that the Route stops at is surrounded by a green border on the design workspace. The message exchange at this component is shown in the Variables view at the upper right corner of the Studio.
-
Click the Breakpoint button to continue the routing process until the next breakpoint.
If, for any reason, you want to stop the Route in progress, simply click the Kill button; if you want to execute the Route to the end, click the Basic Run button.
To remove the displayed monitoring information from the design workspace, click the Clear button in the Debug Run tab.