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.

DEFINE DIAGNOSE<br />

DEFINE DIAGNOSE<br />

►►<br />

►<br />

►<br />

DEFine<br />

MAC<br />

Notes:<br />

CHECKR15<br />

CHECKR15<br />

Authorization<br />

Purpose<br />

Oper<strong>and</strong>s<br />

DIAGnose<br />

PRIVCLASSANY<br />

PRIVclasses<br />

NO<br />

YES<br />

NO<br />

(1)<br />

diag<br />

classes<br />

AUDIT<br />

Privilege Class: A<br />

PROC<br />

1 Oper<strong>and</strong>s can be specified in any order.<br />

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

DISAble<br />

ENable<br />

PROT<br />

EPName<br />

<strong>VM</strong>AC<br />

Use DEFINE DIAGNOSE to define a new DIAGNOSE code on the system.<br />

You can also define a new DIAGNOSE code during initialization using the DEFINE<br />

DIAGNOSE configuration file statement. For more information, see the z/<strong>VM</strong>: <strong>CP</strong><br />

Planning <strong>and</strong> Administration book.<br />

diag<br />

is the number of the DIAGNOSE code that you are defining. The variable diag<br />

is a hexadecimal number between X'0' <strong>and</strong> X'3FC' <strong>and</strong> must be a multiple of 4.<br />

The recommended variable range is a value between X'100' <strong>and</strong> X'1FC'<br />

because that is the range of diagnose codes reserved for customer use. All<br />

other DIAGNOSE code numbers are reserved for <strong>IBM</strong> use.<br />

AUDIT<br />

tells the external security manager (ESM) to audit the DIAGNOSE code that<br />

you are defining. When you audit a DIAGNOSE code, the ESM logs each<br />

attempt by users to issue this DIAGNOSE code.<br />

DISAble<br />

tells <strong>CP</strong> not to call the entry points <strong>and</strong> external symbols associated with this<br />

DIAGNOSE code until you enable it. (For more information about enabling<br />

DIAGNOSE codes, see Usage Note 3.) If omitted, DISABLE is the default.<br />

name<br />

VPROT<br />

INVAR<br />

INVXC<br />

ENable<br />

tells <strong>CP</strong> to immediately start calling the entry points <strong>and</strong> external symbols<br />

associated with this DIAGNOSE code.<br />

EPName name<br />

tells <strong>CP</strong> the name of the entry point that contains the code to process the<br />

►<br />

►<br />

►◄

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

Saved successfully!

Ooh no, something went wrong!