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.

Responses<br />

Note: Unless you specify the ENABLE oper<strong>and</strong> of the DEFINE DIAGNOSE<br />

comm<strong>and</strong>, the new DIAGNOSE code is initially in a disabled state after<br />

being defined.<br />

5. To activate a new DIAGNOSE code after defining it, use the ENABLE<br />

DIAGNOSE comm<strong>and</strong> (page 429).<br />

6. To change the definition of an existing DIAGNOSE code after initialization, use<br />

the MODIFY DIAGNOSE comm<strong>and</strong> (page 615).<br />

7. Once defined, a DIAGNOSE code cannot be deleted. It may be altered in<br />

various appropriate ways, but it remains in existence until a SHUTDOWN or<br />

RESTART IPL is done.<br />

8. To display information about a DIAGNOSE code (status, entry point name, <strong>and</strong><br />

privilege class), use the QUERY DIAGNOSE comm<strong>and</strong> (page 779).<br />

9. To display the real address of the <strong>CP</strong> DIAGNOSE code table block for a<br />

DIAGNOSE code, use the LOCATE DGNBK comm<strong>and</strong> (page 533).<br />

10. To remove the DIAGNOSE processing code from <strong>CP</strong>’s system execution<br />

space, use the <strong>CP</strong>XUNLOAD comm<strong>and</strong> (page 107).<br />

11. Many external security managers (ESMs) do not support DIAGNOSE codes<br />

above X'03FC'. For this reason, <strong>CP</strong> does not support DIAGNOSE codes above<br />

X'03FC'. The DIAGNOSE codes between X'0000' <strong>and</strong> X'03FC' are divided as<br />

follows:<br />

X'0000' to X'00FC'<br />

Reserved for <strong>IBM</strong> use<br />

X'0100' to X'01FC'<br />

Reserved for customer use<br />

X'0200' to X'03FC'<br />

Reserved for <strong>IBM</strong> use.<br />

12. For more information about user-defined DIAGNOSE codes, see the z/<strong>VM</strong>: <strong>CP</strong><br />

Exit Customization book.<br />

Response 1 (Disable One):<br />

To disable DIAGNOSE code X'100', enter the following:<br />

disable diagnose 100<br />

Ready;<br />

After <strong>CP</strong> finishes processing this comm<strong>and</strong>, any virtual machine that issues<br />

DIAGNOSE code X'100' receives a program specification exception in that virtual<br />

machine.<br />

Response 2 (Disable All):<br />

To disable all DIAGNOSE codes on your system, enter the following:<br />

disable diagnose all<br />

Ready;<br />

Response 3 (Disable All Local):<br />

To disable all locally-defined DIAGNOSE codes, enter the following:<br />

disable diagnose 100-1fc<br />

Ready;<br />

Response 4 (Disable Almost All Local):<br />

DISABLE DIAGNOSE<br />

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

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

Saved successfully!

Ooh no, something went wrong!