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

Responses
convert a real address to an absolute address, while in other cases prefixing is
not performed and real addresses are treated unchanged as absolute
addresses.
These rules have an effect on the interpretation of the addresses that specify
the range of storage locations to be dumped:
v When storage is specified using the ALET or AREG operand and the ALET
used is not X'00000000', prefixing is not performed on the addresses that
specify the range of storage in the target address space.
v When storage in the host-primary address space is specified by using the
PRI operand, or by using the ALET or AREG operand when the ALET used
is X'00000000', prefixing is performed as usual on the addresses that
specify the range of storage in the host-primary address space.
7. Although the R operand is not shown in this command, it is accepted for
compatibility with the DUMP GUEST STORAGE command used for XA, ESA,
or XC virtual machines. The R operand perform the same function as the L
operand and dumps storage from the host-primary address space.
8. The BASE operand is intended to be used in conjunction with the L operand. It
lets you dump the storage used by the virtual machine in one less step than
would otherwise be possible. Without the BASE operand, you may need to
dump the contents of a general register, then add the displacement, and then
enter the DUMP command to examine storage the program is using. With the
use of access registers, the BASE option additionally lets you examine storage
without needing to know whether the program is currently in the
access-register mode. This is done automatically for you by CP.
9. When multiple DUMP requests are entered on a single line, the BASE and
INDEX operands are not applied to subsequent DUMP requests on the
command line. They must be explicitly entered for each DUMP request.
10. During DUMP command processing, key-controlled protection is not used.
However, all of the host-related protection mechanisms, such as those applied
during host-access-register translation, are used as normal.
11. If the AREG or ALET operand is specified, the DUMP command uses the
host-access-register translation (ART) process to determine the address space
to display. This translation process may fail, because of one of several program
exception conditions. If the translation does not succeed, the current request is
rejected and processing of the command line is terminated. The rejected
operands are displayed along with a message indicating the nature of the
exception condition.
12. When the ASIT or SPACE operand is specified, the DUMP request fails if the
specified address space does not exist, or if you are not authorized to access
the address space. The current request is rejected, and processing of the
command line is terminated. The rejected operands are displayed along with a
message indicating the nature of the error.
13. If you use an underscore, it must be followed by eight hexadecimal digits.
14. For more information, see “Usage Notes” on page 351.
Response 1:
Rhexloc word1 word2 word3 word4 [key] [*TRANSLATION*]
DUMP Guest Storage (ESA/XC)
This is the response you receive with the T or N option. The EBCDIC translation is
given only for the T option. The storage key is dumped on the first line of a request,
and at every page boundary.
Chapter 2. CP Commands 363