R DEBUG command [ MPE Debug/Stack Dump Reference Manual ] MPE/iX 5.0 Documentation
MPE Debug/Stack Dump Reference Manual
R
DEBUG command
Resumes program execution and optionally establishes another breakpoint.
SYNTAX
R [ [segment.] offset[:[@] [count]]]
[cond ]
NOTE To resume and set a group or account breakpoint, use prefix G for
group or P for account before the segment parameter, as follows:
{G}
R[[{P} segment.] offset [ : [@] count]]
Privileged Mode
To resume and set a breakpoint for system segmented library, use prefix S
before the segment parameter, as follows:
R [ [ S segment.] offset [: [@] count] ]
To resume and set a breakpoint in processes other than your own, use the
pin number of a desired process as follows:
R[[pin.[ segtype] segment.] offset[:[@][ count]]][,...]
[ cond]
where segtype is one of the prefixes G, P or S.
PARAMETERS
segment The logical code segment to contain the breakpoint. If
omitted, the current segment applies. (Optional
parameter.)
offset The relative offset of the breakpoint from the start of
the segment. If omitted, no breakpoint is set,
(Optional parameter.)
:@ Makes breakpoint permanent until program terminates or
breakpoint cleared by explicit C command. If omitted,
and if count is omitted, the breakpoint is cleared
(deleted) after first execution. (Optional parameter.)
R20:@ Resume and then break each time
location 20 is executed.
:count An expression specifying when the breeakpoint is
executed. When count is reached, the breakpoint is
executed and, if @ is not specified, deleted. (Optional
parameter.) If omitted, breakpoint is executed the
first time it is reached.
R20:3 Resume and then break the third time 20
is executed,
When @ and count are combined, the breakpoint is
conditionally permanent, that is, the breakpoint will
break, but not delete after count executions.
R 20:@3 Resume and then break every third time
20 is executed,
:cond An expression specifying a condition upon which the
breakpoint is executed. This condition takes the form
{expression } {expression }
{modbase[offset] } relop {modbase[offset] }
where:
expression is a value;
modbase is one of the stack relative
modification bases DB, DL, Q, S;
offset is the offset relative to the modify
base which specifies the memory
location desired (if omitted, offset is
0);
relop is one of the operators -, >, <, < =, >
=, < >.
At least one of the operands in the condition must be of
the form modbase [offset]. When the condition is true,
the breakpoint is executed and, if @ is not specified,
deleted. (Optional parameter.) If cond is omitted,
breakpoint is executed the first time it is reached.
R 2:DB+3=5 Resume and then break if the value of
DB+3=5 when you reach location 2 of the
current segment.
R 2:@DB+3=5 Resume and then, every time you reach
location 2 of the current segment,
break if DB+3=5.
NOTE If the R command is used with no parameters specified, execution
resumes without establishment of a new breakpoint. Control is
returned to the instruction following a direct call to DEBUG, or to
the instruction which generated a break to DEBUG.
EXAMPLES
?R 110
Resume, set a breakpoint at location 110 of the current segment, and run
until this breakpoint is encountered.
?R 15.3.2:@
Resume, set a breakpoint at location 2 in segment 3 of process 15, and
continue running in your current process. Process 15 runs until the
breakpoint is encountered. (Requires privileged mode.)
MPE/iX 5.0 Documentation