DEBUG

Admin
Visual
IBM Z Security and
Compliance Center
Audit
RACF
Audit
ACF2
Audit
Top Secret
Alert
Adapters
for SIEM
Manager
RACF z/VM
▪ ▪ ▪ ▪ ▪ ▪ ▪ ▪ ▪

This command is meant to diagnose problems in the operation of the program. With the exception of the following parameters, most of the DEBUG parameters are not documented in this manual. Use the DEBUG command when advised to do so by IBM Software Support.

This command is not supported in restricted mode, except for PERFORM, DICT, ACTION, CPIC, RESTRICT.

The DEBUG options that are documented are:
ABEND
Issues an immediate user abend 16 for the purpose of testing error recovery procedures and stops further processing.
ABENDSTACK
Causes an immediate exhaustion of the SYSSTACK memory stack trap, for the purpose of testing error recovery procedures involving message CKR998I, and stops further processing.
ABEND991
Issues an eye catcher failure trap, for the purpose of testing error recovery procedures involving message CKR0991, and stops further processing.
ABEND991Z
Issues an nil pointer detection trap, for the purpose of testing error recovery procedures involving message CKR0991, and stops further processing. This trap applies to the program's default pointer and integer width.
ABEND991Z31
Issues an nil pointer detection trap, for the purpose of testing error recovery procedures involving message CKR0991, and stops further processing. This trap applies to 31 bit pointers.
ABEND991Z32
Issues an nil pointer detection trap, for the purpose of testing error recovery procedures involving message CKR0991, and stops further processing. This trap applies to 32 bit unsigned integers or pointers.
ABENDLATE
Requests a user abend 2759 with dump at the end of processing. Message CKR2479 is issued before the abend. This option is not allowed in restricted mode.
ACTION
Prints the message CKR2829 to list the National Language Support decisions during processing of an action command under ISPF. This field also prints CKR2670 messages to document the substitution map being used by a FORALL command.
CIB
Debug the operator command interface. It issues message CKR3112 when the program has started listening to operator commands. It also prints some control block content.
CPIC
This parameter no longer has meaning since CPI-C support has been removed from the program.
EMAIL
This option can be used to diagnose email address problems. It lists messages detailing the program's understanding of the email address passed in terms of phrase, local-part, and domain. It also lists the line length used for the email output.
FIELD
For RACF systems, this option gives detailed diagnostic information about the processing of fields from RACF profiles.

For ACF2 systems, this option gives detailed diagnostic information about the processing of fields from ACF2 logonid records and ACF2 structured infostorage records. You can use this option to identify the records and fields that cause messages CKR1193-CKR1198.

GUARD
Branches to an odd address (0C6 abend) within guarded code. This should not lead to a crash.
IIOPEN
This debug option can be used to suppress the abend intercept around most file opens. Instead, the normal abend recovery summary dump is shown.
INDEX
This parameter applies only to RACF systems. It requests debug output that lists which profiles are actually read from a RACF data set, and which profiles lookups are taking place. It can be used to debug query response time problems. This parameter is not supported in restricted mode.
LICENSE

This parameter performs no function on z/VM.

For z/OS systems, this parameter:
  • Causes install, entitlement, and product enablement status to be listed in the SYSPRINT.
  • Only has effect if it comes in the input before any CARLa constructs that need access to entitlement information for some reason (like a DEFINE before the first NEWLIST). Generally this means it is most effective when passed in the parameter string.
  • For the ISPF interface, you can use the Preamble; see setup_libry_cmds_se3_setup_preamble.html#setup_libry_cmds_se3_setup_preamble.
PERFORM
This parameter applies only to RACF systems. It does the following:
  • Requests debug output that details which NEWLIST / select can exploit the RACF data set index.
  • Lists the initial key request queue.
  • Can be used to debug query response time problems.
  • Triggers the creation of CKR1698 messages in the SYSPRINT.

    These messages report elapsed and CPU time at various stages in the processing. They report both the delta since the previous CKR1698 (or start of program for the first message), and the total elapsed time since the program started. Information is more complete under ISPF, providing the status messages themselves in the SYSPRINT with record counts and other information. In batch mode, only the ISPF message number is listed without the message content.

This parameter is supported in restricted mode.
READALL
This parameter requests debug output concerning the tests for the CKR.READALL profile in the CKRSITE class.
RESTART
Debug RESTART_INTERVAL processing. It shows token creation and deletion in messages CKR3113 and CKR3115 and SMF INMEM disconnect in message CKR3114.
RESTRICT
This parameter applies only to RACF systems. It prints message CKR2854 to list the TCB dirty bits and the module dirty bits of all modules in the Job Pack Queue to help in PADS debugging. This is also automatically activated by a 913 abend on CKFREEZE, CKRUNLIN, or a RACF database.
SEGMENT
This parameter applies only to RACF systems. It requests debug output that shows where a user or group segment was found that could not be accurately assigned to the proper entity type. This may happen for OMVS segments that have only the field UID filled in.
SVC99
This parameter applies only to z/OS systems. This debug option shows all debugging information for all SVC 99 (DYNALLOC) calls being done.