VMDUMP The format of the VMDUMP command is: r VMDUMP L ________ _
hexloc1
Q r , Ihexloc11 Q
L J r , I!Q ! I ITO useridl iSYSTEM , L .J r I {-:}
i I I I {.} I {.} I L rFORMA.T vmtypel
r DSS 1
[*dumnidl r , , I hexloc21 I i i , L J I I r , I I bytecount II I II L J J
, I I I I I I I , I _ __ J
is the first or only hexadecimal virtual storage address
dumped. If the user omits the hexloc1 operand, the
default is zero, the beginning of virtual machine
storaqe. The user may also specify the hexloc2 or
bvtecount operands with the hexloc1 operand when he knows
the dump size he wants. If the user specifies hexloc2
with hexloc1, CP takes a dump of the storage contents
within the range of addresses between hexloc1 and
hexloc2. For example, when the user enters:
vmdump 1000- 2000 or
vmdump 1000:2000 CO dumps the contents of virtual machine storage at the
hexadecimal addresses between 1000 and 2000. If the user
specifies the bytecount operand with hexloc1, hexloc1
specifies the beginning address of the dump and the
hexadecimal number of bytes dumped. If the user enters:
vmdump 1000.8A CP dumps the contents of virtual machine storage
beqinninq at hexadecimal address 1000 for a total of 8A bytes. The user can specify a maximum of three different of virtual storage that he wants dumped each time
he issues the VMDUMP command. See Usage Notes 1, 2, and
4. Section 5. Format of CP Commands 169

VMDUMP {-:} hexlo:;2 f.}bytecollnt ""0 llserid !Q * SYSTE'1 FORMAT vmtype is the last hexadecimal virtllal storage address dumped.
If the user does not specify the hexloc2 operand, the
default is END, and CP dumps the contents of virtual
machine storage starting from hexloc1 to the end of virtual storage. The user must precede the hexloc2
operand with one of the allowable delimiters {either a dash or a colon} to dump the contents of more than one
location by storage address. For example, if the user
enters:
vmdump :2000 or
vmdump -2000 CP takes a dump of the contents of virtual storage from
hexadecimal location zero (the default for hexloc1) to
hexadecimal address 2000. See Usage Notes 1 and 4 for an expanded explanation of the use of delimiters. The user
may specify up to a maximum of three different virtual
machine storage areas he wishes to dump each time he
issues the VMDUMP command. The user must specify a value for hexloc2 which is greater than hexloc1 value. The
hexloc2 value must not exceed the limit of virtual
storaqe.
is the hexadecimal number of bytes dumped, starting with
the first byte of virtual storage at hexloc1. If the
user does not specify bytecount, the default is END, and Cp takes a dump of the contents of virtual machine
storage from the first byte at hexloc1 to the end of virtual storage. The user must specify a period (.)
delimiter if he wants to dump the contents of more than
one storage location by bytecount. When the user enters:
vmdump 1000. 20 Cp takes a dump of the virtual storage contents from
hexadecimal location 1000 for a length of X'20' bytes.
See Usage Note 2 for an expanded explanation of delimiter
use.
transfers the dump to the virtual card reader of the specified. If the user enters an asterisk after TO, CP transfers the dump to the user's own virtual card
reader.
transfers the dump to the virtual card reader of the
userid specified on the SYSDUMP operand of the SYSOPR system generation macro instruction. The user must not specify TO preceding the keyword SYSTEM. provides VM/IPCS Extension with the virtual machine type (vmtype) which VM/IPCS Extension uses to format the dump.
The vmtype keyword is a one-to-eight byte name of the
operating system runnina in a virtual machine (for CMS). CP also uses the specified vmtype"as the virtual card reader filetype. CP does not validity check
the vmtype. Any vmtype longer than eight bytes generates
an error message and halts further VMDUMP processing.
The dump header record includes the user specified vmtype
and the VM/IPCS Extension uses the vmtype information to
format the dump. If the user enters FORMAT, he must also
specify a vmtype. If he does not specify FORMAT, the
default vmtype is FILE. See Usage Note 3. 170 IBM VM/370 CP Command Feference for General Users