z/VM: CP Commands and Utilities Reference - z/VM - IBM

MODIFY DIAGNOSE
Usage Notes
PRIVCLASSANY
tells CP that users with any privilege class can issue the DIAGNOSE code that
you are redefining.
PRIVclasses classes
tells CP that only users with 1 or more of the specified privilege classes can
issue the DIAGNOSE code that you are redefining. Whatever you specify on
this operand will replace the current privilege classes. The variable classes is 1
or more privilege classes in the range A through Z, 1 through 6, or an asterisk
(*). Privilege class * indicates all privilege classes (A-Z and 1-6).
Note: If you want more than one privilege class, specify your classes in one
string of characters. Do not separate the classes with blank spaces. For
example, specify “privclasses abc123”, not “privclasses a b c 1 2 3”.
1. To define a new DIAGNOSE code, use the DEFINE DIAGNOSE command
(page 160).
2. To load the DIAGNOSE processing code into CP’s system execution space,
use the CPXLOAD command (page 101).
3. To activate a new DIAGNOSE code:
v While defining it, use the ENABLE operand of the DEFINE DIAGNOSE
command (page 160).
v After defining it, use the ENABLE DIAGNOSE command (page 429).
4. To display information about a DIAGNOSE code (status, entry point name, and
privilege class), use the QUERY DIAGNOSE command (page 779).
5. To display the real address of the CP DIAGNOSE code table block for a
DIAGNOSE code, use the LOCATE DGNBK command (page 533).
6. To deactivate a DIAGNOSE code:
616 z/VM: CP Commands and Utilities Reference
v While defining it, use the DISABLE operand of the DEFINE DIAGNOSE
command (page 160).
v After defining it, use the DISABLE DIAGNOSE command (page 266).
7. To remove the DIAGNOSE processing code from CP’s system execution
space, use the CPXUNLOAD command (page 107).
8. Many external security managers (ESMs) do not support DIAGNOSE codes
above X'03FC'. For this reason, CP does not support DIAGNOSE codes above
X'03FC'. The DIAGNOSE codes between X'0000' and X'03FC' are divided as
follows:
X'0000' to X'00FC'
Reserved for IBM use
X'0100' to X'01FC'
Reserved for customer use
X'0200' to X'03FC'
Reserved for IBM use.
9. When CHECKR15 YES is specified, the diagnose router will check register 15
on return from the diagnose handler. If register 15 contains:
RC = 0
Processing was successful. Complete the guest instruction.
RC = 4
Processing failed due to a condition which would cause a guest
program check. Simulate guest program interruption passed in R0.
RC = 8
Nullify the instruction.