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

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

DUMP Guest Storage (z/Architecture)<br />

The spacename BASE is preassigned by <strong>CP</strong> to be the name of your virtual<br />

machine’s host-primary address space.<br />

ASCEasce.<br />

dumps the contents of third-level storage (storage that appears virtual to your<br />

virtual machine) using the specified address-space-control element (ASCE).<br />

Specify asce as one to sixteen hexadecimal digits, separated with an optional<br />

underscore for readability; leading zeros are optional.<br />

N dumps the contents of storage in hexadecimal without EBCDIC translation. This<br />

is the default. Storage is dumped in word segments. An address range is<br />

dumped starting at the fullword in which the specified address resides. Storage<br />

is dumped in fullword increments.<br />

The storage key is dumped on the first line <strong>and</strong> at every page boundary.<br />

I dumps the contents of storage in instruction format. The specified address is<br />

rounded down to the nearest halfword boundary.<br />

The storage key is dumped on the first line <strong>and</strong> at every page boundary.<br />

K dumps the storage keys in hexadecimal for all page frames or partial page<br />

frames included in the specified address range.<br />

R dumps the contents of second-level storage (storage that appears real to your<br />

virtual machine).<br />

S dumps the contents of storage in hexadecimal translation. Storage is dumped<br />

as a string starting at the location specified. The specified address range is not<br />

boundary-aligned.<br />

The storage key is dumped on the first line <strong>and</strong> at every page boundary.<br />

T dumps the contents of storage in hexadecimal <strong>and</strong> character form. Storage is<br />

dumped in word segments. An address range is dumped starting at the<br />

X'10'-byte boundary in which the specified address resides. The hexadecimal<br />

words are followed by the storage as an EBCDIC string, or as an ASCII string if<br />

the X option is specified.<br />

The storage key is dumped on the first line <strong>and</strong> at every page boundary.<br />

U dumps the contents of storage in character form. Storage is dumped starting at<br />

the address specified as an EBCDIC string, or as an ASCII string if the X option<br />

is specified. The specified address range is not boundary-aligned.<br />

The storage key is dumped on the first line <strong>and</strong> at every page boundary.<br />

M dumps the contents of storage in hexadecimal <strong>and</strong> character form. A header is<br />

dumped as the first line, <strong>and</strong> at every page boundary <strong>and</strong> contains the<br />

high-order 32 bits of the 64-bit address along with the storage key. Storage is<br />

dumped in word segments. An address range is dumped starting at the X'10'<br />

byte boundary in which the specified address resides. The hexadecimal output<br />

is followed by the storage as an EBCDIC string, or as an ASCII string if the X<br />

option is specified.<br />

If you do not specify any of the options T, M, K, S, I, N, or U, the contents of<br />

storage are dumped in hexadecimal word segments without EBCDIC translation<br />

(N).<br />

0<br />

hexloc1<br />

is the starting storage location that is to be dumped to your virtual printer. The<br />

address hexloc1 may be one to sixteen hexadecimal digits separated with an<br />

optional underscore for readability. Leading zeros are optional. The default is 0.<br />

Chapter 2. <strong>CP</strong> <strong>Comm<strong>and</strong>s</strong> 377

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

Saved successfully!

Ooh no, something went wrong!