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

DISPLAY Guest Storage (z/Architecture)
Usage Notes
308 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 to display.
INDEXnn
displays the contents of guest storage using the specified starting address
(hexloc1) as a displacement from the address in the specified register (nn). This
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 Display 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 Display 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. When running with a saved segment, you can display 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 display those locations
(or associated keys) causes the “nonaddressable storage” response to be
displayed.
Refer to “Usage Notes” on page 282.
2. When you use the operand ALEThexword.ALraddr., the primary list bit in the
ALET is ignored.
3. When the operands L, PRI, SECO, HOME, ASTEraddr., ASCEhexword.,
ASNasn., AREGareg., ALEThexword., and ALEThexword.ALraddr. are
specified, the access-register-translation (ART), the ASN translation and the
dynamic-address-translation (DAT) processes may be used. These contain
special-case translation processes, including:
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.
v Access register 0 is always treated as containing ALET 0. The contents of
access register 0 are not used during access-register-translation processing.
v General register 0 is always treated as containing the value 0 when used as
the base or index register. The contents of general register 0 are never
used.
4. The BASE operand is primarily intended to be used in conjunction with the L
operand. It lets you display the storage used by the virtual machine in one less
step than would otherwise be possible. Without the BASE operand, you may
need to display the contents of a general register, add the displacement, and
then enter the DISPLAY command to examine storage the program is using.
With the use of access registers, the BASE option also lets you examine