DEBUG


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

You can use DEBUG as a diagnostic tool. When you specify the FRMSG subkeyword, DFSMSdss issues messages that explain why you cannot use fast replication or Preserve Mirror operation during COPY processing. The DEBUG(FRMSG) keyword overrides the DEBUG=FRMSG parameter that is 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.

Specify DEBUG(SMSMSG) to instruct DFSMSdss to display ACS WRITE statements to the job output.

Specify DEBUG(FRMSG) with one of the following sub-keywords:

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

Example 1: Data set copy

ADR948I  (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR
 DATA SET TEST.SRC.KSDS1 BECAUSE THE TARGET DEVICES DO NOT PROVIDE
 COMPATIBLE DATA SET FAST REPLICATION FUNCTIONS

Example 2: Data set copy

ADR918I (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED
FOR DATA SET TEST.SRC.KSDS1, RETURN CODE 3

Return code 3 indicates that one or more source devices are not eligible for fast replication at this time.

Example 3: Data set copy

ADR918I (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED
FOR DATA SET TEST.SRC.KSDS1, RETURN CODE 15

Return code 15 indicates that for the SMS allocation, target volumes that would allow fast replication to be used could not be selected.

Example 4: Full volume or tracks copy

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

Return code 1 indicates that the source device is not capable of fast replication.

Guideline: DFSMSdss suppresses SMS allocation messages regarding fast replication during a data set copy operation when you specify the DEBUG(FRMSG(MINIMAL)) keyword.

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:

Example 1: Data set copy

ADR948I (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED
FOR DATA SET TEST.SRC.KSDS1 BECAUSE THE TARGET DEVICES DO NOT PROVIDE
COMPATIBLE DATA SET FAST REPLICATION FUNCTIONS
      2 VOLUMES SUPPORT DATA SET FLASHCOPY
      1 VOLUME SUPPORTS SNAPSHOT
      3 VOLUMES DO NOT SUPPORT ANY TYPE OF DATA SET FAST REPLICATION

Example 2: Data set copy

ADR918I (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR  DATA SET
TEST.SRC.KSDS1, RETURN CODE 3
      1 VOLUME WAS REJECTED FOR QFRVOLS REASON CODE 7 - VERSION 1 FC RELATION
        EXISTS
      2 VOLUMES WERE REJECTED FOR QFRVOLS REASON CODE 8 - MAX ESS FC
        RELATIONS
      1 VOLUME WAS REJECTED FOR QFRVOLS VOLUME REASON CODE CA - BOUNDARY
        EXCEPTION

Example 3: Data set copy, target data set is non-SMS-managed

ADR918I (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR
DATA SET TEST.SRC.KSDS1, RETURN CODE 14
     1 VOLUME WAS REJECTED FOR QFRVOLS VOLUME REASON CODE 7 - VERSION 1 FC
       RELATION EXISTS
     2 VOLUMES WERE REJECTED FOR QFRVOLS VOLUME REASON CODE 8 - MAX ESS
       FC RELATIONS
     2 VOLUMES WERE REJECTED FOR QFRVOLS VOLUME REASON CODE C9 - FLASHCOPY
       NOT SUPPORTED
     1 VOLUME WAS REJECTED FOR DFSMSDSS REASON CODE 1 - INSUFFICIENT SPACE
     1 VOLUME WAS REJECTED FOR DFSMSDSS REASON CODE 2 - NO FREE DSCB
       IN THE VTOC
     2 VOLUMES WERE REJECTED FOR DFSMSDSS REASON CODE 3 - VOLUME IS SMS
       MANAGED
     1 VOLUME WAS REJECTED FOR DFSMSDSS REASON CODE 4 - LSPACE MACRO FAILED
       WHILE CALCULATING FREE SPACE
     1 VOLUME WAS REJECTED FOR DFSMSDSS REASON CODE 8 - DADSM FAILURE
       OCCURRED WHILE ALLOCATING THE DATA SET ON THE VOLUME

Example 4: Data set copy, target data set is SMS-managed Data set copy, target data set is non-SMS-managed

ADR918I (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR
DATA SET TEST.SRC.KSDS1, RETURN CODE 15
IGD17330I DATA SET TEST2.TGT.KSDS1 WAS ALLOCATED ON VOLUME(S) WHICH ARE
          NOT ELIGIBLE FOR FAST REPLICATION. PREFERRED FAST REPLICATION
          WAS SPECIFIED BY CALLER
IGD17290I THERE WERE 3 CANDIDATE STORAGE GROUPS OF WHICH THE FIRST 3
          WERE ELIGIBLE FOR VOLUME SELECTION. THE CANDIDATE STORAGE
          GROUPS WERE: SG1, SG2, SG3
IGD17267I THE FOLLOWING 1 CANDIDATE STORAGE GROUPS WERE INELIGIBLE FOR
          PREFERRED FAST REPLICATION BECAUSE THEY DID NOT HAVE A SUFFICIENT
          NUMBER (2) OF ELIGIBLE FAST REPLICATION VOLUMES: SG3
IGD17268I 2 VOLUMES WERE NOT USED FOR FAST REPLICATION BECAUSE THE SMS VOLUME
          STATUS WAS DISABLED
IGD17268I 2 VOLUMES WERE NOT USED FOR FAST REPLICATION BECAUSE THEY WERE
          NOT ONLINE
IGD17268I 6 VOLUMES WERE NOT USED FOR FAST REPLICATION BECAUSE OF FLASHCOPY
          NOT SUPPORTED - ANTRQST QFRVOLS VOLUME RSN(201)
IGD17268I 2 VOLUMES WERE NOT USED FOR FAST REPLICATION BECAUSE OF BOUNDARY
          EXCEPTION - ANTRQST QFRVOLS VOLUME RSN(202)
IGD17268I 2 VOLUMES WERE NOT USED FOR FAST REPLICATION BECAUSE OF XRC SRC
          CURRENTLY ACTIVE - ANTRQST QFRVOLS VOLUME RSN(5)
IGD17268I 1 FR-ELIGIBLE VOLUMES WERE NOT USED FOR FAST REPLICATION BECAUSE
          STORAGE GROUP HAS INSUFFICIENT FAST REPLICATION VOLUMES
IGD17268I 4 FR-ELIGIBLE VOLUMES WERE NOT USED FOR FAST REPLICATION BECAUSE
          THEY DID NOT HAVE SUFFICIENT SPACE
IGD17269I 2 NON-FR VOLUMES WERE REJECTED BECAUSE THE SMS VOLUME STATUS WAS
          DISABLED
IGD17269I 2 VOLUMES WERE REJECTED BECAUSE THEY WERE NOT ONLINE
IGD17269I 1 VOLUMES WERE REJECTED BECAUSE OF A DADSM FAILURE
IGD17269I 5 VOLUMES WERE REJECTED BECAUSE THEY DID NOT HAVE SUFFICIENT
          SPACE

Example 5: Full volume or tracks copy

ADR947I (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR VOLUME SRCV01 BECAUSE
THE SOURCE AND TARGET DEVICES DO NOT PROVIDE COMPATIBLE FAST REPLICATION FUNCTIONS
     VOLUME SRCV01 SUPPORTS DATA SET FLASHCOPY
     VOLUME TGTV01 SUPPORTS SNAPSHOT

In examples 4 and 5, DEBUG(FRMSG(SUM)) and DEBUG(FRMAG(DTL)) result in the same level of informational message being issued.

Note:

DFSMSdss supplies fast replication ineligible reasons at the summarized level when summary information is applicable.
Specifying SUMMARIZED causes DFSMSdss to issue SMS allocation messages regarding fast replication in a data set copy operation when the target data set is SMS-managed.
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 fast replication method cannot be used. It is as though the DEBUG(FRMSG(SUMMARIZED)) keyword had been specified.

FRMSG(DETAILED): Specifies that DFSMSdss is to issue a message with detailed information When applicable, detailed information regarding ineligible volumes is provided in the message text. The following examples show the messages that are issued when you specify this keyword:

Eample 1: Data set copy

ADR948I (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR
DATA SET TEST.SRC.KSDS1 BECAUSE THE SOURCE DEVICES DO NOT PROVIDE COMPATIBLE
DATA SET FAST REPLICATION FUNCTIONS
     VOLUME SRCV01 SUPPORTS DATA SET FLASHCOPY
     VOLUME SRCV02 SUPPORTS DATA SET FLASHCOPY
     VOLUME SRCV03 DOES NOT SUPPORT ANY TYPE OF DATA SET FAST REPLICATION
     VOLUME SRCV14 SUPPORTS SNAPSHOT
     VOLUME SRCV25 DOES NOT SUPPORT ANY TYPE OF DATA SET FAST REPLICATION
     VOLUME SRCV26 DOES NOT SUPPORT ANY TYPE OF DATA SET FAST REPLICATION

Example 2: Data set copy

ADR918I (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR
DATA SET TEST.SRC.KSDS1, RETURN CODE 3
     VOLUME SRCV01 WAS REJECTED FOR QFRVOLS VOLUME REASON CODE 7 - VERSION
                   1 FC RELATION EXISTS
     VOLUME SRCV02 WAS REJECTED FOR QFRVOLS VOLUME REASON CODE 8 - MAX ESS
                   FC RELATIONS
     VOLUME SRCV03 WAS REJECTED FOR QFRVOLS VOLUME REASON CODE 8 - MAX ESS
                   FC RELATIONS
     VOLUME SRCV04 WAS REJECTED FOR QFRVOLS VOLUME REASON CODE CA - BOUNDARY
                   EXCEPTION

Example 3: Data set copy, target data set is non-SMS-managed

ADR918I (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR
DATA SET TEST.SRC.KSDK1, RETURN CODE 14
     VOLUME TGTV01 WAS REJECTED FOR QFRVOLS VOLUME REASON CODE 7 - VERSION 1
                   FC RELATION EXISTS
     VOLUME TGTV02 WAS REJECTED FOR QFRVOLS VOLUME REASON CODE 8 - MAX ESS
                   FC RELATIONS
     VOLUME TGTV03 WAS REJECTED FOR QFRVOLS VOLUME REASON CODE 8 - MAX ESS
                   FC RELATIONS
     VOLUME TGTV04 WAS REJECTED FOR QFRVOLS VOLUME REASON CODE C9 - FLASHCOPY
                   NOT SUPPORTED
     VOLUME TGTV05 WAS REJECTED FOR QFRVOLS VOLUME REASON CODE C9 - FLASHCOPY
                   NOT SUPPORTED
     VOLUME TGTV21 WAS REJECTED FOR DFSMSDSS REASON CODE 1 - INSUFFICIENT
                   SPACE
     VOLUME TGTV22 WAS REJECTED FOR DFSMSDSS REASON CODE 2 - NO FREE DSCB IN THE VTOC
     VOLUME TGTS01 WAS REJECTED FOR DFSMSDSS REASON CODE 3 - VOLUME IS
                   SMS MANAGED
     VOLUME TGTS02 WAS REJECTED FOR DFSMSDSS REASON CODE 3 - VOLUME IS
                   SMS MANAGED
     VOLUME TGTS23 WAS REJECTED FOR DFSMSDSS REASON CODE 4 - LSPACE MACRO
                   FAILED WHILE CALCULATING FREE SPACE
     VOLUME TGTS24 WAS REJECTED FOR DFSMSDSS REASON CODE 8 - DADSM FAILURE
                   OCCURRED WHILE ALLOCATING THE DATA SET ON THE VOLUME

Example 4: Full volume or tracks copy

ADR947I (ttt)-mmmmm(yy), FAST REPLICATION COULD NOT BE USED FOR
VOLUME SRCV01 BECAUSE THE SOURCE AND TARGET DEVICES DO NOT PROVIDE
COMPATIBLE FAST REPLICATION FUNCTIONS
     VOLUME SRCV01 SUPPORTS DATA SET FLASHCOPY
     VOLUME TGTV01 SUPPORTS SNAPSHOT

Note:

DFSMSdss supplies fast replication ineligible reasons at the individual volume level when detailed information is applicable.
Specifying DETAILED causes DFSMSdss to issue SMS allocation messages regarding fast replication in a data set copy operation when the target data set is SMS-managed. For an SMS allocation, DFSMSdss supplies the same level of information as if you had specified DEBUG(FRMSG(SUMmarized)).
For a non-SMS allocation during a data set copy operation, DFSMSdss supplies fast replication ineligible reasons at the individual volume level.