z/OS JES2 Commands
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


$D DEBUG - Display the JES2 DEBUG option

z/OS JES2 Commands
SA32-0990-00

Start of change

Function

Use the $D DEBUG command to display the JES2 monitoring and recording activity settings.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-+- $D DEBUG ---------------------+--------------------------><
   '- $D DEBUG -|  DEBUG CHOICES  |-'   

DEBUG CHOICES

|--,BERT--,CKPT--,MISC--,SECURITY--,STORAGE--,SYMREC------------>

>--,VERSION--,MEMBER_STATUS-------------------------------------|

Parameters

DEBUG
Displays all JES2 events and monitor activity settings.
BERT
Displays the JES2 setting for error code $BR3 to inform the operator that a data error has been detected in a chain of BERTs.
CKPT
Displays the JES2 setting for verifying the integrity of the checkpoint data set and protect the storage containing JQEs, JOEs and other checkpoint data when a member releases the checkpoint.
Start of changeMEMBER_STATUSEnd of change
Start of changeDisplays the JES2 setting for issuing the $HASP1701 message whenever the status of a MAS member changes.End of change
MISC
Displays the JES2 setting for occurrence counting of certain JES2 events.
SECURITY
Displays the JES2 setting for the security product (ex: RACF®) logging information contained in the $HASP186 message, or if in WARN mode.
STORAGE
Displays the JES2 setting for providing $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
Displays the JES2 setting for issuing the $HASP805 message when it invokes the MVS™ SYMREC service to indicate a possible error.
VERBOSE
Displays the JES2 setting for sending $BLDMSG system log-only messages to the console.
VERSION
Displays the JES2 setting for verifying the integrity of a newly created checkpoint version.

Authority Required

This command requires display authority.

This command requires read 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 YES is set 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. The response to this command displays information about this member only. To display information about all members in the MAS, 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).

Messages

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

Examples

 1 
 $D debug=y 

 $HASP827 DEBUG 
 $HASP827 DEBUG BERT=YES,CKPT=YES,MISC=YES, 
 $HASP827 SECURITY=YES,STORAGE=YES,SYMREC=YES,VERSION=YES 

JES2 monitors all specifiable JES2 activities.

 2 
$D DEBUG,STORAGE=N,MISC=N,SECURITY=Y

  $HASP827 DEBUG  BERT=YES,CKPT=YES,MISC=NO,
  $HASP827        SECURITY=YES,STORAGE=NO,SYMREC=YES,
  $HASP827        VERSION=YES

JES2 monitors all JES2 activities except MISC and STORAGE.

End of change

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014