DEBUG


>>-+----------------------------------------------------------+-><
   '-DEBUG--(--+-FRMSG--(--+-MINimal----+--)--+--------+-+--)-'   
               |           +-SUMmarized-+     '-,TRACE-' |        
               |           +-DETAILED---+                |        
               |           '-DTL--------'                |        
               '-TRACE--+------------------------------+-'        
                        '-,FRMSG--(--+-MINimal----+--)-'          
                                     +-SUMmarized-+               
                                     +-DETAILED---+               
                                     '-DTL--------'

You can use the DEBUG keyword as a diagnostic tool. Specify DEBUG with one of the following sub-keywords:

TRACE: Specifies that DFSMSdss is to print messages that identify the relocated extents.
FRMSG: Specifies that DFSMSdss is to issue an informational message to explain why fast replication or Preserve Mirror operation could not be used during the DEFRAG operation. The DEBUG keyword overrides the DEBUG=FRMSG parameter specified in the JCL EXEC statement. For Preserve Mirror operations, the DEBUG(FRMSG) keyword might not have an effect if the FlashCopy® target is not a PPRC Primary device.
If you specify DEBUG(FRMSG), you must also specify one of the following sub-keywords:

FRMSG(MINIMAL): Specifies that DFSMSdss is to issue an informational message with a minimal level of information. The following examples show the messages that are issued when you use this keyword:

Examples

ADR918I  (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR
VOLUME SRCV01, RETURN CODE F

Return code F indicates that the volume does not support data set fast replication.

ADR918I  (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR
VOLUME SRCV01, RETURN CODE 3

Return code 3 indicates that the source device is not eligible for fast replication at this time.

FRMSG(SUMMARIZED): Specifies that DFSMSdss is to issue an informational message with summary information. When applicable, summary information regarding ineligible volumes is provided in the message text. The following examples show the messages that are issued when you use this keyword:

Examples

ADR918I  (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR
VOLUME SRCV01, RETURN CODE F

Return code F indicates that the volume does not support data set fast replication.

In this example, the DEBUG(FRMSG(MINIMAL)) keyword provides the same level of informational message as when you specify the DEBUG(FRMSG(SUMMARIZED)) or DEBUG(FRMSG(DETAILED)) keyword.

ADR918I  (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR
VOLUME SRCV01, RETURN CODE 3
     VOLUME SRCV01 WAS REJECTED FOR QFRVOLS VOLUME REASON CODE 7 - VERSION 1 FC
     RELATION EXISTS

In this example, the DEBUG(FRMSG(SUMMARIZED)) keyword provides the same level of informational message as when you specify the DEBUG(FRMSG(DETAILED)) keyword.

Guideline: When the FASTREPLICATION(REQUIRED) keyword is specified and the DEBUG(FRMSG(MIN | SUM | DTL)) keyword is not specified, DFSMSdss still issues an informational message when a data set fast replication method cannot be used in DEFRAG operation. It is as if the DEBUG(FRMSG(SUMMARIZED)) keyword had been specified.

FRMSG(DETAILED): Specifies that DFSMSdss is to issue an informational message with detailed information. When applicable, detailed information regarding ineligible volumes is provided in the message text.

Note: DFSMSdss issues an informational message with summary of reasons why fast replication is ineligible for this processing when applicable.

Example

ADR918I  (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR
VOLUME SRCV01, RETURN CODE 3
     VOLUME SRCV01 WAS REJECTED FOR QFRVOLS VOLUME REASON CODE 7 - VERSION 1 FC
     RELATION EXISTS

In this example, the DEBUG(FRMSG(DETAILED)) keyword provides the same level of informational message as when you specify the DEBUG(FRMSG(SUMMARIZED)) keyword.