27.12.2012 Views

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

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

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

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

DUMP<br />

3. You can assign a dumpid to any dump that you create by means of the DUMP<br />

comm<strong>and</strong>. Note, however, that even though you can use a single DUMP<br />

comm<strong>and</strong> to make multiple DUMP requests, you can assign only one dumpid<br />

per comm<strong>and</strong>.<br />

The dump identifier is an asterisk (*) followed by a 1- to 97-character string<br />

(truncated to 80 characters for a z/Architecture mode guest) that is to be<br />

assigned to the dump. If specified, the dump identifier must be the last oper<strong>and</strong><br />

you enter on the comm<strong>and</strong> line. Blanks are permitted in the dumpid.<br />

For example, dump G *general registers creates a dump of your general<br />

registers <strong>and</strong> assigns the dump the identifier “general registers”.<br />

4. As each request is processed, a message is sent to your display device. This<br />

permits you to stop DUMP processing by pressing the PA1 key. When the<br />

comm<strong>and</strong> terminates, you may enter another comm<strong>and</strong>.<br />

5. The defaults for the following DUMP oper<strong>and</strong>s are:<br />

Oper<strong>and</strong><br />

Default Before Rounding<br />

G 0-end<br />

G- 0-end<br />

G-5 0-G5<br />

G5- G5-end<br />

G5 G5<br />

T error<br />

T- T0-end<br />

T-1000<br />

T0-1000<br />

T1000-<br />

T1000-end<br />

T1000 T1000<br />

352 z/<strong>VM</strong>: <strong>CP</strong> <strong>Comm<strong>and</strong>s</strong> <strong>and</strong> <strong>Utilities</strong> <strong>Reference</strong><br />

PSW current<br />

6. When dumping a range of addresses or subchannels, the comm<strong>and</strong> oper<strong>and</strong><br />

must be followed by an address, a range, or a colon (:), hyphen (-), or period<br />

(.) which forms a range. When dumping registers, the comm<strong>and</strong> oper<strong>and</strong> can<br />

st<strong>and</strong> alone.<br />

7. If you enter a comm<strong>and</strong> line that contains an oper<strong>and</strong> that is not valid, the<br />

DUMP comm<strong>and</strong> terminates when it encounters that oper<strong>and</strong>. Any previous<br />

valid oper<strong>and</strong>s are processed before termination occurs.<br />

8. The DUMP comm<strong>and</strong> lets you dump information in the following formats:<br />

v Hexadecimal string / word segments<br />

v EBCDIC translation for uppercase letters <strong>and</strong> numbers 0 through 9<br />

v Hexadecimal word segments with EBCDIC <strong>and</strong> ASCII translation<br />

v Instruction<br />

v Storage key<br />

Note: The EBCDIC translation is displayed only when the storage location<br />

contains the hexadecimal representation contained in a system<br />

translation table. This table is tailorable by the system programmer via<br />

the system configuration file. The <strong>IBM</strong>-supplied table supports translation<br />

for the hexadecimal representation of the digits 0 through 9, the

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!