Add Breakpoint (QteAddBreakpoint) API

Required Parameter Group:

  Default Public Authority: *USE

  Service Program: QTEDBGS

  Threadsafe: No

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

None.

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.

Message ID	Error Message Text
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.

API Introduced: V3R1