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.

v The FORMAT <strong>and</strong> *dumpid oper<strong>and</strong>s can be specified on more than one<br />

request, but only the last value specified for a particular address space is<br />

recorded.<br />

3. You can specify more than one address range on a single <strong>VM</strong>DUMP<br />

comm<strong>and</strong>, <strong>and</strong> they can be in any order.<br />

4. With the exception of the address space oper<strong>and</strong>s <strong>and</strong> the dump ID, you can<br />

specify the oper<strong>and</strong>s in any order. The dump ID must be the last oper<strong>and</strong> in<br />

the string of oper<strong>and</strong>s begun by an address space oper<strong>and</strong>.<br />

The contents of a virtual machine dump<br />

<strong>VM</strong>DUMP<br />

5. <strong>VM</strong>DUMP processing always creates <strong>and</strong> records a symptom record when<br />

taking a dump.<br />

6. When you dump any address space, you get pages that have been referred to<br />

<strong>and</strong> the storage keys for those pages. In addition, <strong>VM</strong>DUMP dumps this<br />

information for your virtual machine (not necessarily in this order):<br />

v The program status word (PSW)<br />

v General registers<br />

v Control registers<br />

v Access registers<br />

v Floating point registers<br />

v Floating point control register<br />

v Vector registers<br />

v The TOD clock<br />

v The TOD clock comparator<br />

v The TOD programmable register<br />

v The processor timer<br />

v The prefix register<br />

v The prefix page for all virtual processors dumped<br />

v Crypto Domain Index Register<br />

v Crypto Domain Index Mask<br />

v The ASIT <strong>and</strong> the space ID (userid:space_name) for the primary address<br />

space.<br />

v The host access list associated with the primary address space.<br />

Notes:<br />

a. Access registers are dumped only for XA, ESA, XC, <strong>and</strong> z/Architecture<br />

virtual machines.<br />

b. The Crypto Domain Index Register <strong>and</strong> Crypto Domain Index Mask are<br />

dumped only for ESA mode virtual machines that have a virtual Integrated<br />

Cryptographic Facility (ICRF) defined.<br />

c. <strong>VM</strong>DUMP dumps processor information for each define virtual processor,<br />

up to 64 processors.<br />

7. Each page of virtual machine storage is dumped only once to a file. If a page<br />

is specified in separate calls to the same address space or on more than one<br />

request in continuous output mode, only the first request for the page is<br />

honored; later requests are suppressed. Likewise, if a DCSS or DSS<br />

associated with an address space is specified on more than one request in<br />

continuous output mode, only the first request results in the DCSS being<br />

written to the dump file.<br />

8. Dumps for a V=V virtual machine do not contain pages that have never been<br />

referred to. When a <strong>VM</strong>DUMP request for a V=V virtual machine contains only<br />

ranges within pages that have not been referred to, only the virtual processor<br />

information that is automatically dumped is placed in the dump (see Usage<br />

Note 6). In continuous mode, this information is added to the dump on the first<br />

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

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

Saved successfully!

Ooh no, something went wrong!