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

Usage Notes
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.
DUMP Guest Storage (z/Architecture)
*dumpid
is an asterisk followed by a 1- to 80-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. When you use the operand ALEThexword.ALraddr., the primary list bit in the
ALET is ignored.
4. The operands L, PRI, SECO, HOME, ASTEraddr., ASCEasce., 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 ASCE in guest control register 1, regardless of the current contents of
the dispatchable unit access list.
v ALET 1 always indicates the current secondary address space designated
by the ASCE in guest control register 7, regardless of the current contents
of the dispatchable unit access list.
Chapter 2. CP Commands 379