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

Responses
RC = 12
Present the machine check then nullify the instruction. R2 will contain
the address of the MCRBK which will contain the machine check
information.
RC = 16
Generate machine check for processing damage, then go to
HCPENDOP to terminate the instruction.
RC = 20
Present the machine check, then go to HCPENDOP to terminate the
instruction. R2 will contain the address of the MCRBK, which contains
machine check information.
RC = 24
Issue error message or soft abend for paging I/O error, then nullify the
instruction. R1 has the message or abend number.
If a return code is invalid (negative, not a multiple of 4 or too big ( RC > 24 )),
then a soft abend will occur.
12. The DEFINE COMMAND or DEFINE DIAGNOSE commands should not be
used on a system with an active External Security Manager (ESM);
unpredictable results could occur. To safely define a CP command add the
DEFINE COMMAND or DEFINE DIAGNOSE statement to the SYSTEM
CONFIG file and re-IPL the system. This allows the command and diagnose
additions to control structures to be made prior to activating the ESM.
13. For more information about user-defined DIAGNOSE codes, see the z/VM: CP
Exit Customization book.
Response 1:
To define a general purpose DIAGNOSE code (X'10C') that will be processed by
entry point HCPSRC00, enter the following:
define diagnose 10c epname hcpsrc00 privclasses g
Ready;
Response 2:
To define DIAGNOSE code X'100' and make it available to users with privilege
classes C or E, enter the following:
define diagnose 100 epname qwerty privclasses ce
Ready;
enable diagnose 100
Ready;
query diagnose 100
Code Status EPName PrivClasses
0100 Enabled QWERTY CE
Ready;
Response 3:
To define DIAGNOSE code X'18C' and make it available to all users, enter the
following:
define diagnose 18c epname hcpsrc00 privclassany
Ready;
enable diagnose 18c
Ready;
DEFINE DIAGNOSE
Chapter 2. CP Commands 163