Step Command

This command executes one or more procedure steps during debugging. The exact number of steps depends on the optional switch parameters. The thread pauses after the specified steps have been executed.

Step thread_name [-into] [-over] [-out] [-noerror]

Prerequisites

The specified thread must have been activated by a Start command and subsequently paused by an error, a breakpoint, or by a Break command.

Parameters

thread_name

The name of the thread to be stepped.

-into

An optional switch specifying that the next procedure step should be executed and that thread execution should pause immediately afterwards. If that step calls another procedure, pause inside that procedure, before executing the first instruction. This switch is the default if no switches are specified.

-over

An optional switch specifying that the next procedure step should be executed and that thread execution should pause immediately afterwards. If that step calls another procedure, execute that entire procedure and pause before the step following the procedure call.

-out

An optional switch specifying that procedure steps should be executed until the current procedure returns to its caller. Thread execution pauses before the step following the call to the current procedure.

-noerror

An optional switch specifying that the current step should be skipped if it generated the error that stopped thread execution. Otherwise, the step in error is retried and may generate the error again.

Remarks

This command is normally used only when debugging a procedure. It allows procedure statements to be stepped individually so that the results of each statement can be examined. If this command is entered at the console, the next statement to be executed is displayed when the thread pauses.

Examples

Step My_project -into

Thread My_project: Running

my_procedures:21:       a = a+1

Thread My_project: Paused