Function

Use the $T DEBUG=YES|NO command to start or stop the monitoring and recording of JES2 activities.

Use the command, with its other parameters, to selectively request that JES2 monitor and record only certain JES2 activities.

Parameters

DEBUG={Y|N}

Specifies whether JES2 is to record certain JES2 events and monitor certain JES2 activities. Specifying DEBUG=YES requests JES2 to record all events listed individually (BERT=YES, CKPT=YES, and so on) for this command.

BERT={YES|NO}

Specifies whether (YES) or not (NO) JES2 provides error code $BR3 to inform the operator that a data error has been detected in a chain of BERTs.

CKPT={YES|NO}

Specifies whether (YES) or not (NO) JES2 should verify the integrity of the checkpoint data set and protect the storage containing JQEs, JOEs and other checkpoint data when a member releases the checkpoint.

MEMBER_STATUS=={YES|NO}

Specifies whether (YES) or not (NO) JES2 issues the $HASP1701 message whenever the status of a MAS member changes.

MISC={YES|NO}

Specifies whether (YES) or not (NO) JES2 provides occurrence counting of certain JES2 events.

SECURITY={YES|NO}

Specifies whether (YES) or not (NO) JES2 indicates that the security product (ex: RACF®) is to log information contained in the $HASP186 message, or if in WARN mode. This applies JES2 output selection when the security authorization fails.

STORAGE={YES|NO}

Specifies whether (YES) or not (NO) JES2 provides $HASP095 error code GW3 to inform the operator that $RETWORK macro processing detected that the storage being returned was modified beyond the length specified by its associated $GETWORK macro invocation.

SYMREC={YES|NO}

Specifies whether (YES) or not (NO) JES2 should issue the $HASP805 message when it invokes the MVS™ SYMREC service to indicate a possible error.

VERBOSE={YES|NO}

Specifies whether (YES) or not (NO) JES2 sends $BLDMSG system log-only messages to the console.

VERSION={YES|NO}

Specifies whether (YES) or not (NO) JES2 should verify the integrity of a newly created checkpoint version.

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS system command group is assigned.

This command requires control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991 .

Processing Considerations

Be aware that if you specify YES for the CKPT, or VERSION parameters in a production environment, these options will affect JES2 performance because there is a noticeable increase in the processor cycles JES2 uses.

By using the DEBUG command with the CKPT, or VERSION parameters, you can detect some incorrect updates resulting from checkpoint serialization programming errors in JES2 modules or installation exits.

Use the DEBUG command, with the CKPT parameter specified, for testing installation exits that update checkpointed information. Some common program errors such as failing to use the $QSUSE macro before updating checkpointed information, or failing to use the $CKPT macro after updating the checkpoint may be found by using CKPT=YES. However, you should not rely on CKPT=YES since timing and the order of events play a large part in surfacing serialization errors.

Scope

Single member. This command will be in effect for this member only.

However, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP827 message displays the current setting of the DEBUG option.

JES2 monitors all specifiable JES2 activities.

JES2 monitors all JES2 activities except MISC and STORAGE.