DSS *dumpid VMDUMP specifies that CP take a dump of all discontiguous saved
segments in use by the user's virtual machine.
is a line of user input up to 100 characters long
including imbedded blanks asterisks which the user
can enter for his own benefit (that is, for descriptive purposes, such as the time and date of the dump, or what was being processed at the time of the dump) • If the
user specifies this operand, it becomes the DMPDMPID field in the dump file information record data
area. If specified, user must enter *dumpid as the
last operand on the VMDUMP command line.
1. The jump profile produced contains a whole number of 4K pages. CP rounds down the hex1oc1 operand to a 4K boundary if its value is
not a multiple of 4K. CP rounds up the hex10c2 operand to a 4K boundary minus one.
2. Due to 4K boundary rounding for the hex1oc1 operand, additional dumps of up to 4095 more bytes than the user specified can occur.
3. If the user enters the FORMAT operand followed by another valid of the VMDUMP command (for example, SYSTEM),:P uses the keywnrd following FORMAT as the vmtype and CP ignores the normal
meaninq of the keyword following FORMAT. 4. If the user omits a dash or a colon between the hex1oc1 and hex1oc2 operands, and he separates the operands with one or more blanks, CP dumps only the storage contents at those two specific hexadecimal
addresses. The user must insert blanks to separate operands or
sets of operands if he specifies more than one operand on the
command line. The user must not insert blanks to the left or right
of the rancre or length delimiters (-, :, or .) unless he intends to use the default value of the missing operand that the blank
represents.
5. First level storage is main storage. CP, however, dumps only
second storaqe (that is, storage VM/370 creates for the
guest virtual machine.) Operating systems running in a guest virtual machine such as OS/VS and DOS/VS, have virtual (third
level) storage of their own. CP cannot dump this third level storage direct1v. The user or the virtual operating system is
responsible for converting any third level storage addresses to
second level storage addresses before issuing the command. COMMAND COMPLETE is the response indicating normal completion of the VMDUMP function.
section 5. Format of CP :ommands 171

172 section 5. Format of CP Commands