Step (QteStep) API


  Required Parameter Group:

1 View ID Input Binary(4)
2 Step count Input Binary(4)
3 Step type Input Char(10)
4 Error code I/O Char(*)

  Default Public Authority: *USE

  Service Program: QTEDBGS

  Threadsafe: No

The calling program uses the Step (QteStep) API to start a step in a program. A step count is specified. When the number of statements specified by the step count is run, the program will be stopped.


Authorities and Locks

None.


Required Parameter Group

View ID
INPUT; BINARY(4)

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

Step count
INPUT; BINARY(4)

The number of statements to be run before the program is to be stopped.

Step type
INPUT; CHAR(10)

Which statements are counted when stepping in the program. The following are allowed:

*INTO Statements in the procedure currently stopped in are counted. Also, if that procedure calls other procedures, these statements are also counted as they are run. Thus, it is possible to stop the program in a procedure called by the procedure currently stopped.
*OVER Only statements in the procedure currently stopped in are counted in the step. Thus, procedures that this procedure calls are stepped over when doing the step. If the program is not currently stopped, then the step count will start with the first procedure called in that program, and all procedures that are called by this procedure are not stepped into, and their statements are not counted.

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

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.
CPF9541 E Not in debug mode.
CPF9542 E View not found.
CPF9549 E Error addressing API parameter.
CPF9576 E Step count not valid.
CPF9577 E Step type not valid.


API Introduced: V3R1

[ Back to top | Debugger APIs | APIs by category ]