Progress
Language Reference


CANCEL-BREAK( ) Method

Removes a breakpoint from a debugging session.

Return Type: LOGICAL

Applies To: DEBUGGER System Handle

SYNTAX
CANCEL-BREAK( [ procedure [ , line-number ] ] ) 

procedure

A character expression that specifies the name of the procedure from which you want to remove the breakpoint The specified procedure does not have to exist at the time the breakpoint is removed. If you do not specify procedure, the method removes any breakpoint set on the line immediately following the current line. (This is different from the SET-BREAK( ) method, which sets a breakpoint on the next executable line.)

line-number

An integer expression that specifies the line number in procedure (based at line 1 of the debug listing) where you want to remove 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 removes the breakpoint at the first executable line of procedure file.

The CANCEL-BREAK( ) method provides the same functionality as the Debugger CANCEL BREAK command. If the Debugger is initialized, this method returns TRUE. Otherwise, it returns FALSE with no effect.

If you invoke DEBUGGER:CANCEL-BREAK ( procedure , line-number ) on the same line that is specified by procedure and line-number, the existing breakpoint on the specified line occurs the first time it is executed. The breakpoint is removed only on the second and succeeding executions of the line.

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

For more information, see the reference entry for the DEBUGGER System Handle.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095