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

DISPLAY Guest Storage (ESA/XC)
292 z/VM: CP Commands and Utilities Reference
- hexloc2
specifies the last of a range of hexadecimal storage locations whose contents
are to be displayed. If specified, hexloc2 must be equal to or greater than
hexloc1 and must be within the bounds of the address space to be displayed.
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 or INDEX operand is used, hexloc2 is the address of the
last location to be displayed. 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 displayed 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 forming this sum. 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 display 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 displayed.
The byte count that 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.
Specify END if you want to display the remaining contents of storage. END is
the default, if you specify period (.).
BASEnn
displays 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 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 display. 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
displays 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 Display command.