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

DUMP Guest Storage (ESA/XC)
are to be dumped. If specified, hexloc2 must be equal to or greater than
hexloc1 and must be within the bounds of the address space to be dumped.
The value hexloc2 may be from one to sixteen hexadecimal digits, separated
with an optional underscore for readability; leading zeros are optional. The
colon (:) means the same as a dash (–) when you specify a range of
addresses.
If neither the BASE nor INDEX operand is used, hexloc2 is the address of the
last 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, hexloc2 is a displacement
rather than an address. The last location to be dumped is specified by the sum
of hexloc2 and the contents of the registers specified with the BASE and/or
INDEX operands. If general register 0 is specified in the BASE or INDEX
operand, it is always treated as containing zero when this sum is being formed.
The sum is treated as a 24-bit or 31-bit address according to the addressing
mode of the virtual CPU.
Specify END if you want to dump the remaining contents of storage. END is the
default if you specify dash (-) or colon (:).
END
. bytecount
is a hexadecimal integer designating the number of bytes of storage (starting
with the byte at hexloc1) to be dumped.
The byte count you specify must have a value of at least 1 and may be from
one to sixteen hexadecimal digits, separated with an optional underscore for
readability; leading zeros are optional. The default is zero.
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.
The specified register (nn) may be a decimal number from 0 to 15 or a
hexadecimal number from 0 to F.
If the virtual CPU is in access-register mode, and the L operand is specified (or
defaulted), nn designates an access register/general register pair. Access
register nn is implicitly used, in the same manner as if the AREG operand had
been specified, in conjunction with the virtual machine’s host access list to
determine the address space to dump. If the virtual CPU is not in the
access-register mode, or if one of the other space-designation operands (PRI,
AREG, ALET, SPACE, ASIT) is specified, access register nn is not implicitly
used.
INDEXnn
dumps the contents of guest storage using the specified starting address
(hexloc1) as a displacement from the address in the specified register. The
specified register may be a decimal number from 0 to 15 or a hexadecimal
number from 0 to F.
*dumpid
is an asterisk followed by a 1- to 97-character identifier that is to be assigned to
the dump. If specified, the dumpid must be the last operand you enter on the
command line.
% indicates 31-bit address indirection. Indirection means that the contents of the
Chapter 2. CP Commands 361