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.

Usage Notes<br />

Responses<br />

. bytecount<br />

is a hexadecimal integer designating the number of bytes of storage (starting<br />

with the byte at hexloc1) to be displayed. The sum of hexloc1 <strong>and</strong> bytecount<br />

must be less than the bounds of addressable storage. This value is the lesser<br />

of the storage size specified at system generation <strong>and</strong> the real storage size.<br />

The specified byte count must have a value of at least one <strong>and</strong> may be from<br />

one to sixteen hexadecimal digits, separated with an optional underscore for<br />

readability; leading zeros are optional.<br />

Specify END if you want to display the remaining contents of storage. END is<br />

the default if you specify a period (.).<br />

1. While host storage is being displayed, the running of a virtual machine or<br />

someone else using the STORE HOST comm<strong>and</strong> could cause data to be<br />

changed. This could create an inconsistency in the data that is viewed.<br />

2. In a multiprocessor environment, each processor has a prefix register that it<br />

uses to relocate addresses between 0 <strong>and</strong> X'1FFF' to another page frame in<br />

storage. The prefix register enables each processor to use a different page<br />

frame to avoid conflict with other processors for such activity as interrupt code<br />

recording. Thus, the range 0 through X'1FFF' refers to different areas of<br />

storage, depending on which processor generates the address. All references to<br />

first-level storage are h<strong>and</strong>led as if they were made on the IPL processor.<br />

3. If you use an underscore, it must be followed by eight hexadecimal digits.<br />

4. For more information, see “Usage Notes” on page 282.<br />

Response 1:<br />

Hhexloc word1 word2 word3 word4 [Key] [*TRANSLATION*]<br />

is the response you receive with the T or N option. The translation is displayed only<br />

if you have also entered the T option <strong>and</strong> is in either EBCDIC or (if the TX option is<br />

specified) ASCII. The storage key is displayed on the first line, <strong>and</strong> at every page<br />

boundary.<br />

Response 2:<br />

Hhexlochi_ Storage Key - [Key]<br />

hexloclo word1 word2 word3 word4 [*TRANSLATION*]<br />

is the response you receive with the M option. The translation is displayed in either<br />

EBCDIC or (if the MX option is specified) ASCII. The storage key is displayed on<br />

the first line, <strong>and</strong> at every page boundary.<br />

Response 3:<br />

Hhexloc *TRANSLATION* [key]<br />

DISPLAY Host Storage<br />

is the response you receive with the U option. The oper<strong>and</strong> Hhexloc is the<br />

hexadecimal location of the first data byte to be displayed. A minimum of 1<br />

character <strong>and</strong> a maximum of 32 characters is displayed on each line. The contents<br />

of storage are displayed in translated form <strong>and</strong> are in either EBCDIC or (if the UX<br />

option is specified) ASCII. Periods in the display data represent nonprintable<br />

characters. The storage key is displayed on the first line, <strong>and</strong> at every page<br />

boundary.<br />

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

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

Saved successfully!

Ooh no, something went wrong!