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

DUMP Guest Storage (ESA/390)
Usage Notes
370 z/VM: CP Commands and Utilities Reference
The specified access register is used, in the same manner as if the AREGareg.
operand had been specified, in conjunction with guest access-registertranslation
tables to locate the guest address space.
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.
% 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.
The indirect address specified here (following INDEX and BASE) is determined
after BASE and INDEX are applied.
A maximum of 16 indirection characters can be specified.
*dumpid
is an asterisk followed by a 1- to 97-character identifier that is to be assigned to
the dump. If specified, dumpid must be the last operand you enter on the
command line.
1. The DUMP GUEST STORAGE command dumps the program status words
(PSWs), and the contents of registers (general, floating-point, control, and
prefix), along with the contents of the specified storage. If your virtual machine
is an ESA virtual machine, the subchannel information blocks (SCHIBs) and
the access registers are dumped. If you define a Vector Facility, the vector
registers (VR), vector register pairs (VP), vector status register (VSR), vector
mask register (VMR), vector activity count (VAC), and vector section size
(VSS) are dumped. If you have an ICRF defined and are in ESA mode, the
crypto domain index register is dumped.
2. You can dump storage locations outside the range of your virtual machine size
if they are within a saved segment. Any attempt to dump locations (or
associated keys) between the upper limit of your virtual machine and the
address at which the saved segment is saved causes the “nonaddressable
storage” response to appear in the printed output.
3. The operands HOME, AREGareg., ALEThexword., and ALEThexword.ALraddr.
are valid only if the virtual machine is an ESA virtual machine.
4. When you use the operand ALEThexword.ALraddr., the primary list bit in the
ALET is ignored.
5. The operands L, PRI, SECO, HOME, ASTEraddr., STDhexword., ASNasn.,
AREGareg., ALEThexword., and ALEThexword.ALraddr. use the
access-register-translation (ART), the ASN translation and the
dynamic-address-translation (DAT) processes. These contain special case
translation processes:
v ALET 0 always indicates the current primary address space designated by
the STD in guest control register 1, regardless of the current contents of the
dispatchable unit access list.