VMDUMP
The VMDUMP command, when used with the VM/lnteractive Problem Control
system Extension (VM/IPCS Extension) program product, dumps storage for
quest virtual machines (that is, the virtual that VM/370 creates
for the virtual machine user). See Usage Note 5. The VM/IPCS Extension
debugs errors, as well as stores and maintains error information about
the virtual machine. The VM/IPCS Extension displays this information at
the user's terminal. VMDUMP provides the VM/IPCS Extension with header
information to identify the owner of the dump; it also maintains dump
information, writes the dump to a spool file, and formats the dump. In
addition to saving the storage contents of the virtual machine, the VMDUMP command also dumps: • virtual program status word (PSW) • General registers • Floating point registers • Control reqisters • storaqe protection keys • Virtual machine type identification • Timer values also provides the user with the ability to send dumps to other
users.
The VMDUMP command, when issued without the Extension
installed, only writes an unformatted dump to a spool file. It does not
format the dump without the VM/IPCS Extension. However, a user may
write routines that perform this function. For more information on the Extension, refer to VML11Q [§g£!§ s!g Bgfgrggf§, Order No. SC34-2019. Except for the *dumpid operand, the user can specify the operands of
the VMDUMP command in any order. The *dumpid operand must be the last
operand specified on the command line.
168 IBM VM/370 CP Command Reference for General Users

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