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.

U displays the contents of storage in character form. Storage is displayed starting<br />

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

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

The storage key is displayed on the first line, as well as at every page<br />

boundary.<br />

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

displayed 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 />

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

byte boundary in which the specified address resides. X'10' bytes of storage are<br />

displayed per line. The hexadecimal display is followed by the storage as an<br />

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

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

storage are displayed in hexadecimal word segments.<br />

0<br />

hexloc1<br />

specifies the starting storage location that is to be displayed. The value hexloc1<br />

may be one to sixteen hexadecimal digits; leading zeros are optional. The<br />

default is zero.<br />

If neither the BASE or INDEX oper<strong>and</strong> is used, hexloc1 is the address of the<br />

first location to be displayed. This address is treated as a 31-bit address,<br />

regardless of the addressing mode of the virtual <strong>CP</strong>U.<br />

If either the BASE or the INDEX oper<strong>and</strong> is used, hexloc1 is a displacement<br />

rather than an address. The first location to be displayed is specified by the<br />

sum of hexloc1 <strong>and</strong> the contents of the registers specified with the BASE <strong>and</strong>/or<br />

INDEX oper<strong>and</strong>s. If general register 0 is specified in the BASE or INDEX<br />

oper<strong>and</strong>, it is always treated as containing zero when this sum is being formed.<br />

The sum is treated as a 24-bit or 31-bit address according to the addressing<br />

mode of the virtual <strong>CP</strong>U.<br />

Storage locations <strong>and</strong> the minimum amount displayed are rounded according to<br />

the following conventions (in hexadecimal):<br />

Option Start Minimum Length<br />

T 10 10<br />

M 10 10<br />

K 7FF 7FF<br />

S 1 1<br />

I 2 2 - 6 depending on the instruction<br />

N 4 4<br />

U 1 1<br />

% indicates 31-bit address indirection. Indirection means that the contents of the<br />

specified address are used instead of the address itself. In this case, the 31 bits<br />

at the specified address (the high-order bit is turned off) are used as the new<br />

address for the Display comm<strong>and</strong>.<br />

& indicates 64-bit address indirection. Indirection means that the contents of the<br />

specified address are used instead of the address itself. In this case, the 64 bits<br />

at the specified address are used as the new address for the Display comm<strong>and</strong>.<br />

: END<br />

DISPLAY Guest Storage (ESA/XC)<br />

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

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

Saved successfully!

Ooh no, something went wrong!