Programming Guide : Debugging Your Application : How You Can Use Break Conditions : Source Breakpoints
 
Share this page          
Source Breakpoints
A source breakpoint is a defined place in a script where the application passes control to the Debugger. Source breakpoints can pass control to the Debugger only between statements. Therefore, when you are setting source breakpoints and you choose a line of code that is not the beginning of a statement, the Debugger searches back through the script until it finds the start of a statement and places the breakpoint there.
When a running application encounters a source breakpoint, it passes control to the Debugger just before the execution of the statement on which the breakpoint is positioned. If the line on which you placed the breakpoint contains more than one statement, the Debugger gains control before the first statement on the line.
Ways to Set Source Breakpoints
There are a number of ways to access a script to set source breakpoints:
In the Frame Editor or 4GL Procedure Editor
Click Tools, Processed Script/Breakpoints.
The script is displayed.
On the Debug tab
1. Click the Develop tab and then select an application in the Applications portlet.
2. Click the Debug tab.
3. Select the component in the Source Components portlet.
The script is displayed in the Source Breakpoints portlet.
From the Develop tab
4. Click the Develop tab and then select an application in the Applications portlet.
5. Select a component in the Components portlet.
6. Click Run, Debug.
The Debugger window opens, displaying the script.
In the Debugger
When a running application has stopped at a predefined breakpoint, the Debugger opens. You can set additional source breakpoints in the Debugger.
Set Source Breakpoints
You can set source breakpoints in a script in any of the facilities described in Ways to Set Source Breakpoints.
To set a source breakpoint
Move to the line in the script where you want to put the breakpoint and click the line number.
The Debugger inserts a breakpoint at that line, as indicated by a Stop sign icon:
For more information on how to deactivate or reactivate a breakpoint, see Deactivate and Reactivate Break Conditions.
Delete Source Breakpoints
A breakpoint appears as a Stop sign icon in a script. You can remove source breakpoints by deleting them from the script in either the Debugger or the Processed Script windows or on the Source Breakpoints portlet of the Debug tab.
To delete a source breakpoint
1. Open the facility to display the script with source breakpoints.
2. Click the Stop sign icon to delete a breakpoint.