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(*)
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.

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

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.


Top | Debugger APIs | Source Debugger APIs
Source Debugger APIs and Exit Programs | Create View APIs
| APIs by category

[Information Center Home Page | Feedback ] [Legal | AS/400 Glossary]