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.

Responses<br />

Messages<br />

7. During STORE comm<strong>and</strong> processing, the authorization mechanisms used<br />

during normal address translation are not used.<br />

8. Special authorization is required to use the SPACE or ASIT oper<strong>and</strong> of this<br />

comm<strong>and</strong> to alter any address space other the host-primary address space of<br />

the virtual <strong>CP</strong>U. In order to use this comm<strong>and</strong> to alter storage in an address<br />

space, one of the following conditions must be satisfied:<br />

v Your virtual machine must be the owner of the address space. Your virtual<br />

machine is the owner of its host-primary address space <strong>and</strong> of any address<br />

space that it creates using the CREATE function of the ADRSPACE macro.<br />

v If the address space is owned by another virtual machine, your virtual<br />

machine must have read-write authorization to the address space. The<br />

owner of the address space can grant authorization to your virtual machine<br />

using the PERMIT function of the ADRSPACE macro.<br />

Authorization is granted on a space-by-space basis, so that you may be<br />

authorized to alter one address space of a virtual machine but may not be<br />

authorized to alter a different space.<br />

9. The oper<strong>and</strong>s V <strong>and</strong> W used to place data in third-level storage from guest<br />

primary <strong>and</strong> secondary are being supported for compatibility. The PRI <strong>and</strong><br />

SECO oper<strong>and</strong>s replace the V <strong>and</strong> W oper<strong>and</strong>s.<br />

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

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

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

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

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

11. The STORE comm<strong>and</strong> requires a segment table designation (STD) to alter<br />

third-level storage (storage that appears virtual to your virtual machine). It may<br />

receive the STD as an oper<strong>and</strong>, find it in a control register, or use the<br />

access-register translation (ART) process or the address space number (ASN)<br />

translation process to obtain the STD. The access-register translation <strong>and</strong> ASN<br />

translation processes may fail because of one of several program exception<br />

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

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

displayed along with a response indicating the nature of the exception<br />

condition.<br />

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

Response 1:<br />

Store complete<br />

is issued when the comm<strong>and</strong> completes successfully.<br />

H<strong>CP</strong>003E Invalid option - {option|comm<strong>and</strong><br />

contains extra option(s) starting with<br />

option}<br />

H<strong>CP</strong>005E Invalid hexdata - hexdata<br />

H<strong>CP</strong>010E Invalid register - register<br />

STORE Guest Storage (ESA/390)<br />

H<strong>CP</strong>012E Invalid PSW - psw<br />

H<strong>CP</strong>026E Oper<strong>and</strong> missing or invalid<br />

H<strong>CP</strong>033E Hexloc missing or invalid<br />

H<strong>CP</strong>160E Hexloc hexloc exceeds storage<br />

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

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

Saved successfully!

Ooh no, something went wrong!