>>-+-----------------------------------------------------------+-><
'-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.