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

LOCATE DGNBK
►►
LOCate
Authorization
Purpose
Operands
DGNBK
Usage Notes
▼
diag
diag1-diag2
Privilege Class: C, E
Use LOCATE DGNBK to display the real address of the CP DIAGNOSE code table
block for a specific DIAGNOSE code.
diag
diag1-diag2
is the number of the DIAGNOSE code whose real address you want to display.
Each diag must be an existing DIAGNOSE code 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 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).
5. To change the definition of an existing DIAGNOSE code after initialization, use
the MODIFY DIAGNOSE command (page 615).
6. To display information about a DIAGNOSE code (status, entry point name, and
privilege class), use the QUERY DIAGNOSE command (page 779).
7. To deactivate a DIAGNOSE code:
LOCATE DGNBK
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).
8. To remove the DIAGNOSE processing code from CP’s system execution
space, use the CPXUNLOAD command (page 107).
►◄
Chapter 2. CP Commands 533