Displays the contents of memory.
Format
DUMP address-expression1 [:address-expression2]
1 – Parameters
address-expression1
Specifies the first memory location to be displayed.
address-expression2
Specifies the last memory location to be displayed (default is
address-expression1).
2 – Qualifiers
2.1 /BINARY
Displays each examined entity as a binary integer.
2.2 /BYTE
Displays each examined entity as a byte integer (length 1 byte).
2.3 /DECIMAL
Displays each examined entity as a decimal integer.
2.4 /HEXADECIMAL
Displays each examined entity as a hexadecimal integer.
2.5 /LONGWORD
/LONGWORD (default)
Displays each examined entity in the longword integer type
(length 4 bytes). This is the default type for program locations
that do not have a compiler-generated type.
2.6 /OCTAL
Displays each examined entity as an octal integer.
2.7 /QUADWORD
Displays each examined entity in the quadword integer type
(length 8 bytes).
2.8 /WORD
Displays each examined entity in the word integer type (length 2
bytes).
3 – Description
The DUMP command displays the contents of memory, including
registers, variables, and arrays. The DUMP command formats its
output in a manner similar to the DCL command DUMP. The debugger
DUMP command makes no attempt to interpret the structure of
aggregates.
In general, when you enter a DUMP command, the debugger evaluates
address-expression1 to yield a program location. The debugger
then displays the entity stored at that location as follows:
o If the entity has a symbolic name, the debugger uses the size
of the entity to determine the address range to display.
o If the entity does not have a symbolic name (and, therefore,
no associated compiler-generated type) the debugger
displays address-expression1 through address-expression2 (if
specified).
In either case, the DUMP command displays the contents of these
locations as longword (by default) integer values in the current
radix.
The default radix for display is decimal for most languages. The
exceptions are BLISS and MACRO, which have a default radix of
hexadecimal.
Use one of the four radix qualifiers (/BINARY, /DECIMAL,
/HEXADECIMAL, /OCTAL) to display data in another radix. You can
also use the SET RADIX and SET RADIX/OVERRIDE commands to change
the default radix.
Use one of the size qualifiers (/BYTE, /WORD, /LONGWORD,
/QUADWORD) to change the format of the display.
The DUMP command sets the current entity built-in symbols %CURLOC
and period (.) to the location denoted by the address expression
specified. Logical predecessors (%PREVLOC or the circumflex
character (^)) and successors (%NEXTLOC) are based on the value
of the current entity.
Related command:
EXAMINE
4 – Examples
1.DBG> DUMP/QUAD R16:R25
0000000000000078 0000000000030038 8.......x....... %R16
000000202020786B 0000000000030041 A.......kx ... %R18
0000000000030140 0000000000007800 .x......@....... %R20
0000000000010038 0000000000000007 ........8....... %R22
0000000000000006 0000000000000000 ................ %R24
DBG>
This command displays general registers R16 through R25 in
quadword format and hexadecimal radix.
2.DBG> DUMP/BYTE/DECIMAL 30000:30040
0 0 0 0 0 3 0 -80 °....... 0000000000030000
0 0 0 0 0 3 1 64 @....... 0000000000030008
0 0 0 0 0 3 0 48 0....... 0000000000030010
0 0 0 0 0 3 0 56 8....... 0000000000030018
0 0 0 0 0 3 0 -64 À....... 0000000000030020
0 0 0 0 0 3 0 -80 °....... 0000000000030028
0 0 0 0 0 0 7 -50 Î....... 0000000000030030
101 101 119 32 116 120 101 110 next wee 0000000000030038
107 k 0000000000030040
DBG>
This command displays locations 30000 through 30040 in byte
format and decimal radix.