Setting a Breakpoint

Set breakpoints where you want to test or examine your application's state.

If you suspect a problem is occurring in a particular statement or function, insert a breakpoint at that point in the code, using any of several PowerBuilder windows. The breakpoint signals the debugger to interrupt program execution so you can examine it. In windows that display breakpoints, each one is marked in with a circular icon. The icon color indicates whether the breakpoint is currently enabled (red) or disabled (white).

The PowerScript debugger provides a range of ways to set and use breakpoints:

Select a line of code in the Script Editor and add a breakpoint
Specify the location of a breakpoint in a file
Break only when a breakpoint is hit a specified number of times
Break only for specified conditions
Filter breakpoints for specified environments
Define custom actions for breakpoints
Set a breakpoint on a function
Disable, enable, or delete a breakpoint

Setting a Breakpoint in a Script
You can set a breakpoint in a script at any time, while working in either debug or design mode.
Changing a Breakpoint Location
Move a breakpoint to a different file or line.
Conditional Breakpoints and Hit Counts
You can use conditional breakpoints and hit counts to control when breakpoints are executed.
Setting a Breakpoint Condition
Define a condition under which a breakpoint should be executed.
Setting a Breakpoint Hit Count
Control the number of times a breakpoint is hit before it stops execution, or track the hit count.
Setting a Breakpoint Filter
Set a breakpoint filter to restrict its use to specified machines, processes, and threads.
Specifying a Tracepoint
Define a custom action for a breakpoint.
Setting a Breakpoint on a Function
Set a breakpoint at a specific function.
Disabling, Enabling, or Deleting a Breakpoint
Control whether breakpoints are bypassed during the current debugging session.

Parent topic: Debugging an Application

Related concepts

Conditional Breakpoints and Hit Counts