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

QUERY DIAGNOSE
►►
Query
Authorization
Purpose
Operands
DIAGnose
Usage Notes
ALL
▼
diag
diag1-diag2
Privilege Class: A, C, E
Use QUERY DIAGNOSE to display information (status, entry point names, and
privilege classes) about one or more DIAGNOSE codes.
ALL
tells CP to display information about all existing DIAGNOSE codes.
diag
diag1-diag2
is the number of the DIAGNOSE code for which you want information. Each
diag must be a hexadecimal number between X'0000' and X'03FC'. You can
specify a single DIAGNOSE code, a range of DIAGNOSE codes, or any
combination thereof.
1. If you do not specify the ENABLE operand on the DEFINE DIAGNOSE
command, a new DIAGNOSE code is initially in a disabled state after being
defined. CP treats disabled DIAGNOSE codes as if they were never defined. If
you try to use a disabled DIAGNOSE code in a program, CP will give you a
program check specification exception.
2. 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).
3. To change the definition of an existing DIAGNOSE code after initialization, use
the MODIFY DIAGNOSE command (page 615).
4. To display the real address of the CP DIAGNOSE code table block for a
DIAGNOSE code, use the LOCATE DGNBK command (page 533).
5. To deactivate a DIAGNOSE code:
QUERY DIAGNOSE
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).
6. 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:
►◄
Chapter 2. CP Commands 779