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

DUMP Guest Storage (ESA/XC)
Usage Notes
362 z/VM: CP Commands and Utilities Reference
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.
1. Special authorization is required to use this command to dump any address
space other than the host-primary address space of the virtual CPU. In order
to use this command to dump storage in an address space, one of the
following conditions must be satisfied:
v Your virtual machine must be the owner of the address space. Your virtual
machine is the owner of its host-primary address space and of any address
space that it creates using the CREATE function of the ADRSPACE macro.
v If the address space is owned by another virtual machine, your virtual
machine must have read-only or read-write authorization to the address
space. The owner of the address space can grant authorization to your
virtual machine using the PERMIT function of the ADRSPACE macro.
Authorization is granted on a space-by-space basis, so that you may be
authorized to dump one address space of a virtual machine but may not be
authorized to dump a different space.
2. In addition to dumping the contents of the specified storage, the DUMP Guest
Storage command dumps the program status words (PSWs), the contents of
registers (general, access, floating-point, control, and prefix), and the
subchannel information blocks (SCHIBs). 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 also dumped.
3. When running with a saved segment, you can dump storage locations outside
the range of your virtual machine size if they are within the saved segment. If
locations exist between the upper limit of your virtual machine and the address
at which the saved segment was saved, any attempt to dump those locations
(or associated keys) causes the “nonaddressable storage” response to be
dumped.
4. The operands L, PRI AREG, and ALET use the host-access-register translation
(ART) process. The ART process performs special-case translation processes
for certain ALET values and access registers:
v The ALET X'00000000' always indicates the host-primary address space.
v Access register 0 is always treated as containing ALET X'00000000'. The
contents of access register 0 are not used during host-access-register
translation processing.
5. General register 0 is always treated as containing the value 0 when used as
the base or index register using the BASE or INDEX operands. The contents
of general register 0 are never used.
6. In the XC environment, special rules govern the conversion of real addresses
into absolute addresses. In some cases, prefixing is performed as usual to