SET BREAKPOINT

Set a code breakpoint.

Syntax

SET BREAKPOINT AT expression [WHEN condition] [SKIP count ] [CONTINUE] [SYMBOL bid] [THEN actions END] [DISABLE]

Parameters

expression

A breakpoint is set at the address specified by expression. This can be:

A line number in a source module denoted as “module\@LINE number” or “@LINE number

A global name of a procedure

An address

WHEN condition

Evaluates the expression at program break. If the condition result is FALSE (zero), program execution continues. In this case, an optional skip count remains unchanged. The parameter condition may be any valid expression described in C C++ Expressions Overview.

SKIP count

The execution of the program stops if this breakpoint is reached for the (count+1)-th time (and the WHEN clause is true).

CONTINUE

Continues execution after processing the action list.

SYMBOL bid

Stores the ID number of the breakpoint into the debugger variable bid. This variable may be used in expressions or to enable, disable, show, or delete this breakpoint.

actions

An optional command list, enclosed by the keywords THEN and END. It is executed if the program stops at this breakpoint. If more than one action is specified, they must be separated by a semicolon (;).

DISABLE

Adds a breakpoint to the breakpoint list, but does not set it on the target until you enter the ENABLE BREAKPOINT command. This argument is important for saving and restoring the current state of the breakpoint list.

Description

The SET BREAKPOINT command is used to set a code breakpoint at a specified location. The maximum number of code breakpoints, which the user can set, is 1024. Due to hardware limitations this number may be smaller in some circumstances. If all breakpoints have been set, you will receive an error message like Memory: read failed or Memory: write failed.

Example

SET BREAKPOINT AT calculate\@LINE 10
SET BREAKPOINT AT rundown
SET BREAKPOINT AT server\hidden
SET BREAKPOINT AT txtofil WHEN outcount > 10
SET BREAKPOINT AT @LINE 17 WHEN loop > end+5  THEN
                                              EVALUATE temp1,
                                              EVALUATE erg
                                              END
SET BREAKPOINT AT toggle SKIP 20
SET BREAKPOINT AT checkpoint CONTINUE
                                     THEN
                                     EVAL  counter
                                     END
SET BREAKPOINT AT fun2 SYMBOL DBID

See Also


For more complete information about compiler optimizations, see our Optimization Notice.