SET-BREAK( ) method

Sets a breakpoint for a debugging session.

Return type:

LOGICAL

Applies to:

DEBUGGER system handle

 

Syntax 

SET-BREAK ( [ procedure [ , line-number ] ] )

procedure

A character expression that specifies the name of the procedure in which you want to set the breakpoint. The specified procedure does not have to exist at the time the breakpoint is set. If you do not specify procedure, the method sets the breakpoint at the next executable line of the current procedure.

line-number

An integer expression that specifies the line number in procedure (based at line 1 of the debug listing) where you want to set the breakpoint. A positive integer greater than or equal to 1 represents a line number in the specified procedure file. Zero (0) or a negative integer value represents the first executable line of the main procedure block in the specified procedure file. If you do not specify line-number, the method sets the breakpoint at the first executable line of procedure file. If line-number is greater than the last executable line number, the method sets the breakpoint at the last executable line of procedure. If line-number does not specify an executable line, the method sets the breakpoint at the next executable line after the line specified by line-number.

If the Debugger is initialized, this method returns TRUE. Otherwise, it returns FALSE with no effect. For more information, see the reference entry for the DEBUGGER system handle.

Note:

To use this method, you must have the Application Debugger installed in your OpenEdge environment.

Note that the Debugger sets breakpoints on physical lines—not statements. If you invoke DEBUGGER:SET-BREAK( ) on a line that contains other executable statements, all the other statements on that line execute before the breakpoint occurs on the next executable line. This is true whether the statements appear on the same line before or after the invocation of the SET-BREAK( ) method.

If you invoke DEBUGGER:SET-BREAK ( procedure , line-number ) on the same line that is specified by procedure and line-number, the specified line executes the first time without breaking. The breakpoint occurs only on the second and succeeding executions of the line.

Note:

You cannot set a watchpoint programmatically using the DEBUGGER system handle. A watchpoint is a form of breakpoint which tells the Debugger to interrupt program execution when the value of a variable, buffer field, or attribute reference changes.