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

ENABLE DIAGNOSE
►►
ENable
Authorization
Purpose
Operands
DIAGnose
Usage Notes
ALL
▼
diag
diag1-diag2
Privilege Class: A
Use ENABLE DIAGNOSE to permit CP to process requests for one or more
locally-developed DIAGNOSE codes.
You can also permit processing of locally-developed DIAGNOSE codes during
initialization using the ENABLE DIAGNOSE configuration file statement. For more
information, see the z/VM: CP Planning and Administration book.
ALL
tells CP to enable all existing DIAGNOSE codes.
Note: This operand enables all DIAGNOSE codes: the locally-defined ones, the
IBM-supplied ones, and any supplied by third-party software vendors.
diag
diag1-diag2
is the number of the DIAGNOSE code that you are enabling. Each diag must
be a hexadecimal number between X'0000' and X'03FC' and must be a multiple
of 4. You can specify a single DIAGNOSE code, a range of DIAGNOSE codes,
or any combination thereof.
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. If you do not specify the ENABLE operand, 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.
4. To change the definition of an existing DIAGNOSE code after initialization, use
the MODIFY DIAGNOSE command (page 615).
5. To display information about a DIAGNOSE code (status, entry point name, and
privilege class), use the QUERY DIAGNOSE command (page 779).
6. To display the real address of the CP DIAGNOSE code table block for a
DIAGNOSE code, use the LOCATE DGNBK command (page 533).
7. To deactivate a DIAGNOSE code:
ENABLE DIAGNOSE
►◄
Chapter 2. CP Commands 429