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

VMDUMP
1724 z/VM: CP Commands and Utilities Reference
-hexloc2
-END
-ALL
:hexloc2
:END
:ALL
is the ending address in the range of storage locations to be dumped. END is
the default. The address hexloc2 may be one to eight hexadecimal digits;
leading zeros are optional. The value you specify for hexloc2 must be equal to
or greater than hexloc1, within the specified address space, and not greater
than the maximum address that VMDUMP can dump (X'7FFFEFFF'). If the
value you specify for hexloc2 is equal to the starting location, the system dumps
the single page of storage containing that location. If the value you specify for
hexloc2 is not equal to the starting location and is not a multiple of 4 KB, the
system rounds up the value to the next 4 KB boundary.
Specify END to dump the remaining contents of configured storage of the
specified address space up to the maximum address that VMDUMP can dump
(X'7FFFEFFF'). If you specify ALL, VMDUMP dumps from hexloc1 to the end of
the virtual machine address space up to the maximum address that VMDUMP
can dump (X'7FFFEFFF'). A virtual machine address space consists of
configured guest storage as well as discontiguous saved segments in use by
the virtual machine. For address spaces that a user does not own, both END
and ALL dump the contents of the entire address space up to the maximum
address that VMDUMP can dump (X'7FFFEFFF'), including DCSSs.
If END or ALL was specified or defaulted and storage exceeds the maximum
address that VMDUMP can dump (X'7FFFEFFF'), pages over that address will
not be dumped. An information message describing this situation will be
displayed.
If you specify only the dash (-) or colon (:) range delimiter, and omit either
hexloc2 or END, END is the default. However, if you omit both the range
delimiter and hexloc2 or END, the system dumps the single page of storage
starting at hexloc1. If you omit both hexloc1 and hexloc2 or END, hexloc1
defaults to zero, hexloc2 defaults to END, and VMDUMP dumps all of
configured guest storage up to the maximum address that VMDUMP can dump
(X'7FFFEFFF'). (Note that in this case specification of the range delimiter is
irrelevant.)
See Usage Note 10 for examples of range specifications.
.bytecount
.END
.ALL
is a hexadecimal number indicating the number of bytes of storage to be
dumped, starting with the first byte at hexloc1. The value you specify for
bytecount must be at least one and can be from one to eight hexadecimal
digits; leading zeros are optional. The ending storage address resulting from
bytecount must be within the specified address space and not greater than the
maximum address that VMDUMP can dump (X'7FFFEFFF'). If the ending
storage address is not a multiple of 4 KB, the system rounds up the value to
the next 4 KB boundary.
Specify END to dump the remaining contents of configured storage of the
specified address space up to the maximum address that VMDUMP can dump
(X'7FFFEFFF'). If you specify ALL, VMDUMP dumps from hexloc1 to the end of
the virtual machine address space up to the maximum address that VMDUMP
can dump (X'7FFFEFFF'). A virtual machine address space consists of