D DEBUG command [ MPE Debug/Stack Dump Reference Manual ] MPE/iX 5.0 Documentation
MPE Debug/Stack Dump Reference Manual
D
DEBUG command
Displays memory contents of a specified number of locations relative to a
given code base or data base.
SYNTAX
D [ dispbase][ offset][ ,count] [ ,mode]
PARAMETERS
dispbase One of the following stack (data) relative display
bases:
DB, DL, Q, S
or one of the following code relative display bases:
PB, P, PL
If dispbase is omitted, DB is specified by default.
(Optional parameter.)
Privileged Mode
Includes all of the above plus the following:
A = Absolute Relative (base = location 0).
SY = System Global Relative (base = system base).
CO = Code Segment Relative (base = base of segment).
COX = Program Logical Code Segment Relative (base = base of
segment).
DA = Data Segment Relative (base = base of segment).
DX = Current Absolute DB Relative (base = absolute DB).
EA = Extended Absolute Address (base = bank specified).
The bank number in EA mode follows EA; for example:
D EA2+ 10 Displays one word at location 10 of bank 2.
For CO, COX, and DA, the segment and offset immediately follow the
mnemonic (CO, COX, or DA) unless it is an expression requiring a
calculation. Expressions requiring calculation are enclosed in
parentheses; for example:
D DA22+ 6,6 Displays 6 words starting at location 6 of data segment
22.
D CO(4+ 6),3 Displays first 3 words of segment 12 (octal).
D COX12,3 Displays first 3 words of your program segment 12 (that
is, segment 11 from PMAP).
offset The offset relative to the display base which specifies
the starting memory location of the area to be
displayed. It is written in the following format:
[+] expression [ : [ [+] expression] ]
If no sign is given, positive offset is assumed. If
expression is followed by a colon, indirect addressing
is indicated. The indirect addressing is relative to
the specified dispbase or, if omitted, to DB for stack
relative display or PB for code relative display bases.
The first expression can be followed by an additional
offset expression. For example:
D 6:+2 Display contents of address found by
adding two words to address stored in
DB+ 6.
Multiple levels of indirect are permitted. For example:
D 6:+'Q+3': Display contents of address found by
adding address stored in Q+ 3 to
address stored in DB+ 6.
If offset is omitted, location 0 is specified by
default. (Optional parameter.)
count An expression which defines the number of memory
locations to be displayed. If omitted, count is
assigned a default value of 1. (Optional parameter.)
mode A one-character specifier to indicate the representation
mode for output values: O for octal, I for decimal, H
for hexadecimal, A for ASCII or C for code. When the C
specifier for mode is used, the actual octal content of
a location is displayed along with the code it
represents. Note that all numbers in this code are
octal. If omitted, default mode is octal. (Optional
parameter.)
EXAMPLES
?D5 ?D Q+1:,A
DB+5 047516 DB+0 MA
?D 0-5 ?D Q+1:,4,A
Q-5 177777 DB+0 MAIN'PROG
?D Q-5: D PB+4,C
DB+177777 000020 PB+4 045403 LOAD Q+3,X
Location DB + 5. DB is assumed when dispbase omitted.
Location Q - 5.
Location pointed to by Q - 5.
One word in ASCII at location pointed to by Q+ 1.
Four ASCII words at location pointed to by Q+ 1.
Code at location PB+4.
MPE/iX 5.0 Documentation