z/VM: CP Commands and Utilities Reference - z/VM - IBM

DUMP Guest Storage (ESA/XC)
360 z/VM: CP Commands and Utilities Reference
the specified address as an EBCDIC string, or as an ASCII string if the X option
is specified. The specified address range is not boundary-aligned.
The storage key is dumped on the first line and at every page boundary.
M dumps the contents of storage in hexadecimal and character form. A header is
dumped as the first line, and at every page boundary and contains the
high-order 32 bits of the 64-bit address along with the storage key. Storage is
dumped in word segments. An address range is dumped starting at the X'10'
byte boundary in which the specified address resides. The hexadecimal output
is followed by the storage as an EBCDIC string, or as an ASCII string if the X
option is specified.
If you do not specify any of the options T, M, K, S, I, N, or U, the contents of
storage are dumped in hexadecimal word segments.
0
hexloc1
specifies the starting storage location that is to be dumped. The value hexloc1
may be one to sixteen hexadecimal digits, separated with an underscore for
readability; leading zeros are optional. The default is zero.
If neither the BASE or INDEX operand is used, hexloc1 is the address of the
first location to be dumped. This address is treated as a 31-bit address,
regardless of the addressing mode of the virtual CPU.
If either the BASE or the INDEX operand is used, hexloc1 is a displacement
rather than an address. The first location to be dumped is specified by the sum
of hexloc1 and the contents of the registers specified with the BASE operand,
the INDEX operand, or both. If general register 0 is specified in the BASE or
INDEX operand, it is always treated as containing zero when forming this sum.
The sum is treated as a 24-bit or 31-bit address according to the addressing
mode of the virtual CPU.
Storage locations and the minimum amount dumped are rounded according to
the following conventions (in hexadecimal):
Option Start Minimum Length
T 10 10
M 10 10
K 7FF 7FF
S 1 1
I 2 2 - 6 depending on the instruction
N 4 4
U 1 1
% indicates 31-bit address indirection. Indirection means that the contents of the
specified address are used instead of the address itself. In this case, the 31 bits
at the specified address (the high-order bit is turned off) are used as the new
address for the Dump command.
& indicates 64-bit address indirection. Indirection means that the contents of the
specified address are used instead of the address itself. In this case, the 64 bits
at the specified address are used as the new address for the Dump command.
: END
- hexloc2
specifies the last of a range of hexadecimal storage locations whose contents