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

DUMP Guest Storage (z/Architecture)
378 z/VM: CP Commands and Utilities Reference
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
is the last of a range of hexadecimal storage locations whose contents are to
be dumped to your virtual printer. If specified, hexloc2 must be equal to or
greater than hexloc1 and within the virtual storage size. The address hexloc2
may be from one to sixteen hexadecimal digits, separated with an optional
underscore for readability; leading zeros are optional.
Specify END if you want to dump the remaining contents of storage. END is the
default if you specify dash (-) or colon (:).
A colon (:) means the same as a dash (-) when you are specifying a range of
addresses.
END
. bytecount
is a hexadecimal number designating the number of bytes of storage (starting
with the byte at hexloc1) to be dumped to your virtual printer.
The specified byte count must have a value of at least 1 and may be from one
to sixteen hexadecimal digits; leading zeros are optional.
Specify END if you want to dump the remaining contents of storage. END is the
default if you specify period (.).
BASEnn
dumps the contents of guest storage using the specified starting address
(hexloc1) as a displacement from the address in the specified general register
(nn). The specified register may be a decimal number from 0 to 15 or a
hexadecimal number from 0 to F. nn specified indicates an AR/GR pair if all the
following are true:
v The L operand is specified.
v The virtual machine is an ESA virtual machine.
v The virtual CPU is in access register mode.