DUMP can specify END instead of hexloc2 or you can leave the field
blank, since the default is END. If you specify :END or -END,
the contents of storage from hexloc1 to END are dumped. The
contents of storage locations hexloc1 through hexloc2 are
printed with EBCDIC translation at the printer. The operand,
hexloc2, mav be from one to six hexadecimal digits; leading zeros are optional;
{. } b"tecou n t JH!J2 *dumpid is a hexadecimal integer designating the number of bytes of
storage (starting with the byte at hexloc1) to be dumped to
the printer. The period (.) must be specified to dump the
contents of more than one storage location by bytecount. The
sum of hexloc1 and bytecount must be an address that does not
exceed the virtual machine size. LI this address is not on a
fullword boundary, it is rounded up to the next highest fullword. The value, bytecount, must be one or greater and can be no longer than six hexadecimal digits. Leading zeros
are optional.
can be entered for descriptive purposes. If specified, it
becomes the first line printed preceding the dump data. Up to 100 characters, with or without blanks, may be specified after
the asterisk prefix. No error messages are issued, but only 100 characters are used, including asterisks and embedded
blanks.
1. First level storage is real main storage. Jnly second-level storage (storage that is real to the virtual machine) can be
dumped. operating systems running in a virtual machine such as DOS/VS and OS/VS have virtual (third level) storage of their own.
This third-level storage cannot be dumped directly. The user or
the virtual operating system is responsible for converting any
third-level storage locations to second-level storage locations
before issuing the command.
2. The CP command executes in an area of storage separate from vour virtual machine storage and does not destroy any portion of vour storaqe.
3. If the DUMP command is used in CMS mode, use the #CP DUMP command or depress the P!1 key before entering the command.· This procedure
maintains thp virtual machine's registers for the dump. Otherwise,
the registers are those of the CMS command processor.
4. The DUMP command prints the virtual PSi and the virtual registers
(general, floating-point, and control). If only this information
is desired, at least one virtual address must be specified, such as DU!'!P ,., 5. The output format for the virtual storage locations is eight words
per line with the EBCDIC translation on the right. Each fullword
consists of eight hexadecimal characters. All the rest of the
information (PSW, general and floating-point registers, and storage kevs) is printed in hexadecimal. If you have the ECMODE option in yoar directory entry, the control registers are also printed. To print the dump on the real printer, a :LOSE command
section 5. Format of CP Commands 81

DUMP mast be issued for the spooled virtual printer.
6. vou should define beginning and ending dump locations in
the manner:
dump Lhexloc1-hexloc2
dump Lhexloc1.bytecount
dump Lhexloc1-hexloc2 hexloc1.bytecount * dumpid
If, however, a blank follows the type character (L or T) or the
character and the hexloc, the default dump starting and ending
locations are assumed to be the beginning and/or end of virtual If a dash or a colon is not specified between the hexloc1
and hexloc2 operands and the two operands are separated by one or blanks only the contents of the locations defined by the two
operands is dumped. Blanks are used to separate operands or sets
of operands if more than one operand is entered on the same command
line. Blanks must not be used to the riqht or left of range or
length delimiters ( : or -or .), unless it is intended to take the
default value of the missing operand defined by the blank. Thus,
all the followinq produce full storaqe dumps:
dump 1 dump t: dump O-end dump t 1ump 1. dump l:end
dump -dump t. dump t:end
dump dump 0- dump O:end dump . dump 0: dump l.end dump 1- dump o. dump t.end du"p t- dump I-end dump O.end dump 1: dump t-end
The following produces three full dumps:
dump 1 • t
dump - • • 7. When running with a discontiguous saved segment (DCSSt, you can
dump storaqe locations outside the range of your virtual machine
size if they are within the ness. If there exist locations between
the upper limit of your virtual machine and the address at which
the Dess was saved, an attempt to dump those locations (or
associated keys) results in a "nonaddressable storage" message
appearinq in the printer output.
As the dump proqresses,
terminal, indicatinq that
boundary: DUMPING LOC hexloc
the following
the dump is
message is displayed at
continuing from the next
the 6LJk where hexloc is the segment (64K) boundary address for the dump
continuation, such as 020000, 030000, or 040000. If you press the attention key,
while the message is beinq
terminated. COMMAND COMPLETE or its equivalent, on the terminal
displayed, the dump function is
is the response indicating normal completion of the dump function. P2 IBM VM/370 CP Command Reference for General Users