Breakpoint Set Command (PLBDBUG)

The Breakpoint Set command sets breakpoints within the program. As many as ten breakpoints may be set at one time. The format for the BP command is:

BP {ExLabel | Address}[,{count}[,{reset}]][;{cmd}]

An execution label or an execution address may be specified with the command. If the label or address is currently shown in the source window, the given line is shown in double intensity mode. At any time in the debugging process, if any line on which a breakpoint is set is shown in the source window, it is displayed in double intensity mode.

The 'count' parameter is optional. If 'count' is specified, the breakpoint does not occur until the instruction has been executed 'count' number of times.

The 'reset' parameter is also optional. If 'reset' is specified, the 'count' will be reset to this value once a breakpoint has occurred.

The optional 'cmd' parameter is a debugger command line to be executed when the break point occurs. The break point command can be referenced and changed using the 'Cn' commands as described below.

Examples:

BP PRT1

Set a breakpoint at PRT1. This breakpoint is taken each time PRT1 is reached.

BP PRT2,5

Set a breakpoint at PRT2. This breakpoint is taken the fifth time PRT2 is reached. When the breakpoint is taken, the count is reset to one. Thereafter, the breakpoint is taken each time PRT2 is reached.

BP PRT3,2,10

Set a breakpoint at PRT3. This breakpoint is taken the second time PRT3 is reached. When the breakpoint is taken, the count is reset to ten. Thereafter, the breakpoint is taken each tenth time PRT3 is reached.

BP PRT4,2,10;DV myvar

Set a breakpoint at PRT4. This breakpoint is taken the second time PRT4 is reached. When the breakpoint is taken, the count is reset to ten and the contents of 'myvar' are displayed. Thereafter, the breakpoint is taken each tenth time PRT4 is reached.

See Also: PLBDBUG Commands, PLBDBUG