S, SS [ System Debug Reference Manual ] MPE/iX 5.0 Documentation
System Debug Reference Manual
S, SS
Single steps.
Syntax
S[S] [num_instrs] [ L[OUD] | Q[UIET] ]
This command single steps the specified number of instructions. If the
user attempts to single step into the system NL or SL (or any portion of
code he/she does not have access to view), Debug stops single stepping
and free-runs the process (for example, proceed as if the CONTINUE
command had been issued). For native mode processes, Debug stops
processing as soon as it returns from the inaccessible code. For
compatibility mode processes, the process continues to run until it
encounters a breakpoint.
Parameters
num_instrs The number of instructions to be executed. If
omitted, a single instruction is executed. Negative
values are converted to positive values.
L[OUD] | Q[UIET] If LOUD is specified, the address where the process
stopped is printed. If QUIET is specified, no
message is displayed. The default is LOUD.
Examples
%cmdebug > s
%cmdebug >
Single step to the next instruction.
%cmdebug > ss 5 l
Step to: PROG %0.172
%cmdebug >
Step 5 instructions "loudly", that is, print the ending address.
$nmdebug > s #20 l
Step to: 115.00005f0c processstudent+$1e8
$nmdebug >
Step 20 instructions, and print the address when stopped.
Limitations, Restrictions
The single step command cannot be used within a macro that is invoked as
a function.
CAUTION The output format of all System Debug commands is subject to
change without notice. Programs that are developed to
postprocess System Debug output should not depend on the exact
format (spacing, alignment, number of lines, uppercase or
lowercase, or spelling) of any System Debug command output.
MPE/iX 5.0 Documentation