Add Breakpoint (QteAddBreakpoint) API

The calling program uses the Add Breakpoint (QteAddBreakpoint) API to add a breakpoint at a location in a registered view.

Required Parameter Group

View ID

INPUT; BINARY(4)

The identifier of a previously registered view obtained by using the Register Debug View API.

Line number

INPUT; BINARY(4)

The line in the View ID where the breakpoint is to be added.

Column number

INPUT; BINARY(4)

The column in the line where the breakpoint is to be added.

Note: At this time, column numbers are ignored. Column one must be specified.

Line in statement view

OUTPUT; BINARY(4)

The API returns the line number in the statement view where the breakpoint was added.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error Code Parameter.

Error Messages

CPF1938 E

Command is not allowed while serviced job is not active.

CPF1939 E

Time-out occurred waiting for a reply from the serviced job.

CPF1941 E

Serviced job has completed. Debug commands are not allowed.

CPF3CF1 E

Error code parameter not valid.

CPF7102 E

Unable to add breakpoint or trace.

CPF9541 E

Not in debug mode.

CPF9542 E

View not found.

CPF9549 E

Error addressing API parameter.

CPF9567 E

Column number not valid.

CPF9568 E

Line number not valid.