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

VMDUMP
Usage Notes
1726 z/VM: CP Commands and Utilities Reference
XA
has no effect. XA is retained only for compatibility with previous releases. All
dumps are in z/VM format.
*dumpid
is a 1- to 100-character (including any imbedded blanks and special characters)
identifier that is associated with the storage dumped for each address space for
which the operand is specified. When specifying dumpid, you must precede it
with an asterisk (*). The system eliminates any blanks between the asterisk and
the first nonblank character of the dump ID. If you specify a dump ID that is
more than 100 characters in length after the blanks following the asterisk are
eliminated, the system truncates it on the right to a length of 100 characters. If
specified, the dump ID must be the last operand on the command line.
CLOSE
specifies that CP should close the VMDUMP system data file currently open for
the issuing user, if one has been created by a previous request in continuous
output mode.
CANCEL
specifies that CP should close and purge the VMDUMP system data file
currently open for the issuing user, if one exists.
CONt
specifies that VMDUMP is to operate in continuous output mode, leaving the
output file open after each request, until explicitly closed or canceled, or until a
request is processed after continuous output mode has been reset.
NOCont
specifies that at the completion of subsequent VMDUMP requests, the output
file is to be closed.
Combining operands on the VMDUMP command
1. The CONT, NOCONT, CLOSE, and CANCEL operands are not valid in
conjunction with any other VMDUMP operands.
2. When invoking VMDUMP to dump guest storage in continuous output mode,
certain restrictions apply to the use of other command operands:
v The SYSTEM and TO operands, which pertain to ownership of the file and
its structure, can be specified only when the file is opened, that is, on the
first request not counting any requests specifying CONT, NOCONT, CLOSE,
or CANCEL. Subsequent requests that merely repeat the current setting of
the operand are ignored, but requests that attempt to change the setting of
the operand (whether it was set explicitly or by default) are rejected with an
error message.
v Operands used to designate which areas of guest storage to dump are valid
on any of the series of requests in continuous output mode. These operands
are:
PRIMARY
SPACE userid:space_name
ALET alet
ASIT asit
AREG areg
address-range
DCSS