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.

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

Responses<br />

used is X'00000000', prefixing is performed as usual on the addresses that<br />

specify the range of storage in the host-primary address space.<br />

6. The BASE oper<strong>and</strong> is intended to be used in conjunction with the L oper<strong>and</strong>. It<br />

lets you display the storage used by the virtual machine in one less step than<br />

would otherwise be possible. Without the BASE oper<strong>and</strong>, you may need to<br />

display the contents of a general register, add the displacement, <strong>and</strong> enter the<br />

DISPLAY comm<strong>and</strong> to examine storage the program is using. With the use of<br />

access registers, the BASE option additionally lets you examine storage<br />

without needing to know whether the program is currently in access register<br />

mode. This is done automatically for you by <strong>CP</strong>.<br />

7. When multiple DISPLAY requests are entered on a single line, the BASE <strong>and</strong><br />

INDEX oper<strong>and</strong>s are not applied to subsequent DISPLAY requests on the<br />

comm<strong>and</strong> line. They must be explicitly entered for each DISPLAY request.<br />

8. During DISPLAY comm<strong>and</strong> processing, key-controlled protection is not used.<br />

However, all of the host-related protection mechanisms, such as those applied<br />

during host-access-register translation, are used as normal.<br />

9. If the AREG or ALET oper<strong>and</strong> is specified, the DISPLAY comm<strong>and</strong> uses the<br />

host-access-register translation (ART) process to determine the address space<br />

to display. This translation process may fail because of one of several program<br />

exception conditions. If the translation does not succeed, the current request is<br />

rejected <strong>and</strong> processing of the comm<strong>and</strong> line is terminated. The rejected<br />

oper<strong>and</strong>s are displayed along with a message indicating the nature of the<br />

exception condition.<br />

10. When the ASIT or SPACE oper<strong>and</strong> is specified, the DISPLAY request fails if<br />

the specified address space does not exist, or if you are not authorized to<br />

access the address space. The current request is rejected <strong>and</strong> processing of<br />

the comm<strong>and</strong> line is terminated. The rejected oper<strong>and</strong>s are displayed along<br />

with a message indicating the nature of the error.<br />

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

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

Response 1:<br />

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

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

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

option is specified) ASCII. The storage key is displayed on the first line of a request,<br />

<strong>and</strong> at every page 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 />

Rhexloc *TRANSLATION* [key]<br />

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

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

hexadecimal location of the first data byte to be displayed. A minimum of one

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

Saved successfully!

Ooh no, something went wrong!