View source for How to debug

Debugging is by default enabled whenever you play out.
To disable/enable debugging, check the corresponding flag in the 'Play-Out' properties by
right-clicking your project and choosing properties-->PlayGo-->Play-Out-->General tab-->Debug flag:

[[Image:playout.properties.general.jpg|800px]]
<br>
When playing-out you can see information about the LSC execution in the 'Play-Out' view, and you can set breakpoints directly on the LSC diagram or in the Java code.

==Play-Out View==
[[Image:playoutView.jpg|800px]]
<br>
The Play-Out view displays the information logged at runtime by the [[The_Tracer | Tracer]]. Each line represents an explicit or implicit event that occurred during execution. The information is grouped by events. The icon at each line defines the type of information it provides:<br>
[[Image:event.gif]] - information about the event that occurred in the system and triggered the steps included in this sub tree. Contains the event signature.<br>
[[Image:cut.gif]] - information about the cut change. Includes the name of the LSC, the sequence of locations that constitute the current cut, and whether the cut is hot or cold.<br>
[[Image:binding.gif]] - information about a binding of a lifeline. Includes the type of lifeline and the name of the bounded instance.<br>
[[Image:completion.gif]] - information about LSC completion/finish. <br>
[[Image:violationHot.gif]] - information about a hot violation. <br>
[[Image:violationCold.gif]] - information about a cold violation. <br>
<br>
Upon clicking an entry in the view, a graphical indication is displayed on the diagram. For example, when clicking a 'cut change' entry, the cut is drawn on the diagram.
[[Image:playoutView.cutChange.jpg|800px]]<br><br>
The information provided in the play-out view can be filtered using the filters provided in the view's toolbar:<br>
[[Image:playoutView.filters.png|800px]]

== Applying breakpoints==
Breakpoints can be applied at runtime on the diagram, as well as in the Java code.

On the diagram, set a breakpoint by right-clicking a message and choosing 'Toggle Breakpoint':

[[Image:LSCEditor.breakpoint.png | 800px]]

<br>
Applying a breakpoint in the Java code is done in the standard way (e.g., right-clicking the left-hand side-bar of a source line and choosing 'Toggle Breakpoint').

In both cases, the execution will stop when reaching a breakpoint. Once stopped, it can be resumed by clicking the resume button in the toolbar of the Debug view:
[[Image:debugView.jpg|800px]]