(
ttt)-
mmmmm(
yy), FAST REPLICATION
COULD NOT BE USED FOR {DATA SET
dsname | VOLUME
volser | THIS
task TASK},
RETURN CODE
dss_return_code
1Explanation
summarized_info
is:
[, {number {VOLUME WAS | VOLUMES WERE}
REJECTED FOR {QFRVOLS VOLUME REASON CODE
qfrvols_vrsn[ - qfrvols_vrsn_text]
| QFRVOLS EXTENT REASON CODE qfrvols_xrsn
[ - qfrvols_xrsn_text
] | DFSMSDSS REASON CODE
dss_reason_code[ - dss_rsn_text]}}]
detailed_info
is:
[, {VOLUME volser WAS REJECTED FOR
{QFRVOLS VOLUME REASON CODE qfrvols_vrsn[ - qfrvols_vrsn_text
] | QFRVOLS EXTEXT REASON CODE qfrvols_xrsn
[ - qfrvols_xrsn_text
] | DFSMSDSS REASON CODE dss_reason_code
[ - dss_rsn_text]}}]
DFSMSdss cannot use a fast
replication method. The system might issue this message for diagnostic purposes if the
DEBUG(FRMSG(MIN | SUM | DTL)) or the FASTREPLICATION(REQ) keyword is specified. The return code and
reason code listed in the message text are hex values.
If any QFRVOLS reason codes are listed, see the ANTRQST topic of
z/OS DFSMS Advanced Copy Services for an explanation of the QFRVOLS volume or extent reason codes
(qfrvols_vrsn or qfrvols_xrsn). The possible return codes
(dss_return_code) and reason codes (dss_reason_code) are:
- X'1'
- The source device is not capable of fast replication.
- X'2'
- The target device is not capable of fast replication.
- X'3'
- One or more of the source devices are not eligible for fast replication at this time.
When
DEBUG(FRMSG(SUMMARIZED)) is specified, return code X'3' is followed by summarized volume
information that consists of reason codes that indicate why one or more volumes are not eligible.
For each reason code issued, the number of volumes failing for that reason is provided. The reason
codes include SDM QFRVOLS volume reason codes (qfrvols_vrsn) and extent reason
codes (qfrvols_xrsn).
When DEBUG(FRMSG(DETAILED)) is specified, return code
X'3' is followed by detailed information that lists each volume that was considered, along
with a reason code indicating why that volume was ineligible. The reason codes include SDM QFRVOLS
volume reason codes (qfrvols_vrsn) and extent reason codes
(qfrvols_xrsn).
See the ANTQFRVL topic in
z/OS DFSMS Advanced Copy Services for a list of the QFRVOLS volume and extent reason codes.
- X'4'
- The ANTRQST macro fails while trying to determine if fast replication can be used between the
source and target volumes.
- X'5'
- The software required for fast replication is not installed.
- X'7'
- FASTREPLICATION(NONE) is specified for this task.
- X'9'
- One or more target devices are not eligible for fast replication at this time.
When
DEBUG(FRMSG(SUMMARIZED)) is specified, return code X'9' is followed by summarized volume
information that consists of reason codes that indicate why one or more volumes are not eligible.
For each reason code issued, the number of volumes failing for that reason is provided. The reason
codes include SDM QFRVOLS volume reason codes (qfrvols_vrsn) and extent reason
codes (qfrvols_xrsn).
When DEBUG(FRMSG(DETAILED)) is specified, return code
X'9' is followed by detailed information that lists each volume that was considered, along
with a reason code indicating why that volume was ineligible. The reason codes include SDM QFRVOLS
volume reason codes (qfrvols_vrsn) and extent reason codes
(qfrvols_xrsn).
See the ANTRQST topic in
z/OS DFSMS Advanced Copy Services for a list of the QFRVOLS volume and extent reason codes.
- X'A'
- The source data set is a multi-layered VSAM data set, for which DFSMSdss must invoke a utility to move the data.
- X'B'
- The cluster is part of a sphere and another cluster in the same sphere cannot be processed using
fast replication. During DFSMSdss SPHERE
processing, if the base cluster or any of its associated alternate indexes cannot be processed using
fast replication, the entire sphere cannot be processed using fast replication.
- X'C'
- The data set is a PDS and NOPACK is not specified.
- X'D'
- A failure occurs while attempting to register a session with the System Data Mover (SDM).
- X'E'
- The ANTRQST macro fails while trying to determine if the source or target volumes are eligible
for fast replication.
- X'F'
- The volume does not support data set fast replication.
- X'10'
- The data set is being reblocked.
- X'11'
- The source data set stripe count does not match the target data set stripe count.
- X'12'
- The data set is a single-striped multivolume data set.
- X'13'
- The direct access data set is being processed block by block.
- X'14'
- For the non-SMS allocation, target volumes that support fast replication cannot be
selected.
When DEBUG(FRMSG(SUMMARIZED)) is specified, return code X'14' is followed by
summarized volume information that consists of reason codes that indicate why one or more volumes
failed selection. For each reason code issued, the number of volumes failing for that reason is
provided. The reason codes include SDM QFRVOLS volume reason codes
(qfrvols_vrsn), QFRVOLS extent reason codes (qfrvols_xrsn), or
DFSMSdss reason codes
(dss_reason_code).
When DEBUG(FRMSG(DETAILED)) is specified, return code
X'14' is followed by detailed information that lists each volume that was considered, along
with a reason code indicating why that volume was ineligible. The reason codes include SDM QFRVOLS
volume reason codes (qfrvols_vrsn), QFRVOLS extent reason codes
(qfrvols_xrsn), or DFSMSdss reason codes (dss_reason_code).
See the ANTRQST
topic in
z/OS DFSMS Advanced Copy Services for a list of the QFRVOLS volume and extent reason codes. The possible DFSMSdss reason codes
(dss_reason_code) are:
- X'1'
- The target volume does not have enough space to accommodate the target data set.
- X'2'
- There are no free DSCBs in the VTOC.
- X'3'
- The volume is SMS-managed.
- X'4'
- The LSPACE macro was issued for the volume to determine whether enough free space existed on the
volume. The LSPACE macro failed.
- X'5'
- The source data set resides on the volume and the data set is not being renamed.
- X'6'
- One of the following conditions occurred when DFSMSdss attempted to allocate the data set:
- Duplicate data set exists on the volume
- If the volume did not have a duplicate data set, this reason code indicates that the volume does
not contain enough free space to accommodate the data set. For an ISAM data set, the matching space
in the target was not available.
- X'7'
- One of the following conditions occurred when DFSMSdss attempted to allocate the data set:
- The data set is unmovable.
- Either an absolute track allocation (ABSTR) failed or the lack of system support for absolute
track allocation precluded the use of absolute track allocation.
- X'8'
- DFSMSdss attempted to allocate the
data set on the volume, but a DADSM failure occurred.
- X'9'
- An indexed VTOC does not exist on the volume. The REALLOC macro was issued for an absolute track
allocation. The REALLOC macro failed because ALLOC=ABS is not supported on OS VTOCs.
- X'15'
- For the SMS allocation, target volumes that allow fast replication to be used cannot be
selected.
When DEBUG(FRMSG(SUMMARIZED | DETAILED)) is specified, return code X'15' is
followed by SMS allocation messages which provide summarized information. Detailed information at
individual volume level is not available. See the SMS messages for explanations.
- X'16'
- The ANTRQST macro fails while trying to determine if the device is capable of fast
replication.
- X'18'
- The data set is a PDS that you are converting to a PDSE, or vice versa, which requires a utility
to be used by DFSMSdss.
- X'19'
- The data set is a catalog BCS data set which requires a utility to be used by DFSMSdss.
- X'1A'
- The data set is a VSAM data set with key ranges and is extended, which requires a utility to be
used by DFSMSdss.
- X'1B'
- The data set is a KSDS that has imbedded indexes, which requires a utility to be used by DFSMSdss.
- X'1C'
- Multiple volumes are required for the target data set, but multivolume allocation cannot be
used. Therefore, the data set must be extended during the copy, which requires a utility to be used
by DFSMSdss.
- X'1D'
- The CA size of the target data set is different from that of the source data set, which requires
a utility to be used by DFSMSdss.
- X'1E'
- The block size of the target data component is different from that of the source data component,
which requires a utility to be used by DFSMSdss.
- X'1F'
- The blocks per track for the target data component is different from that of the source data
component, which requires a utility to be used by DFSMSdss.
- X'20'
- The blocks per track for the target index component is different from that of the source index
component, which requires a utility to be used by DFSMSdss.
- X'21'
- The block size of the target index component is different from that of the source index
component, which requires a utility to be used by DFSMSdss.
- X'22'
- The data set is an indexed VSAM data set with an imbedded index, TGTALLOC (CYL) was specified,
and the source did not use cylinder allocation, which requires a utility to be used by DFSMSdss.
- X'23'
- Sufficient space cannot be allocated for the target multi-striped VSAM data set. Therefore, the
target data set must be extended during the copy process, which requires a utility to be used by DFSMSdss.
- X'24'
- The target data set is smaller than the source data set because of an internal error.
- X'25'
- The volume has insufficient available FlashCopy®
relationships to complete the task.
- X'26'
- The source index or data component is full and the target has a greater
allocation, which requires a utility to be used by DFSMSdss.
- X'27'
- FCTOPPRCPRIMARY(PRESMIRREQ) was specified, but there were insufficient Preserve Mirror eligible
volumes specified in the output volume list on which to allocate the target data set. DFSMSdss could
not use Fast Replication to perform the operation without causing one or more PPRC pairs to go into
'duplex pending' status.
When FASTREPLICATION(REQUIRED) or DEBUG(FRMSG(SUMMARIZED)) is specified,
return code X'27' is followed by summarized volume information that consists of reason
codes that indicate why one or more volumes failed selection. For each reason code issued, the
number of volumes failing for that reason is provided. The reason codes include SDM QFRVOLS PRESERVE
MIRROR volume reason codes (qfrvols_vrsn) or QFRVOLS PRESERVE MIRROR extent
reason codes (qfrvols_xrsn).
When DEBUG(FRMSG(DETAILED)) is specified,
return code X'27' is followed by detailed information that lists each volume that was
considered, along with a reason code indicating why that volume was ineligible. The reason codes
include SDM QFRVOLS PRESERVE MIRROR volume reason codes (qfrvols_vrsn) or QFRVOLS
PRESERVE MIRROR extent reason codes (qfrvols_xrsn).
Refer to the ANTRQST
section in z/OS DFSMS Advanced Copy Services for a list of the QFRVOLS volume and
extent reason codes.
- X'28'
- The source data set extended format version type does not match the target data set extended
format version type.
- X'29'
- The source extended format sequential data set has an end of file on the non last volume.
System action
DFSMSdss processing continues. The
return code is zero.
Operator response
Programmer response
In order for fast replication to be used in subsequent operations, take the following action,
depending on the return code. The possible actions are:
- X'1'
- Move the source data sets to volumes that support fast replication.
- X'2'
- Choose target devices that support fast replication.
- X'3'
- If the FASTREPLICATION(REQUIRED) or DEBUG(FRMSG(SUMMARIZED | DETAILED)) keyword is specified,
this return code X'3' is followed by one or more QFRVOLS volume reason codes
(qfrvols_vrsn) or extent reason codes (qfrvols_xrsn). See
z/OS DFSMSdfp Advanced Services for information about the QFRVOLS volume and extent reason codes.
If you did not receive
a reason code following return code X'3' and would like to have more information, specify
the DEBUG(FRMSG(SUMMARIZED | DETAILED)) keyword in the JCL and rerun the job.
- X'4'
- See the previously issued ADR932W message and correct the problem.
- X'5'
- Install the IXFP software.
- X'7'
- Remove the FASTREPLICATION(NONE) keyword and rerun the job.
- X'9'
- If the FASTREPLICATION(REQUIRED) or DEBUG(FRMSG(SUMMARIZED | DETAILED)) keyword was
specified, this return code X'9' is followed by one or more QFRVOLS volume reason codes
(qfrvols_vrsn) or extent reason codes (qfrvols_xrsn). See the
ANTRQST topic in the
z/OS DFSMS Advanced Copy Services for information about the QFRVOLS volume and extent reason codes.
If you did not receive
a reason code following return code X'9' and would like to have more information, specify
the DEBUG(FRMSG(SUMMARIZED | DETAILED)) keyword in the JCL and rerun the job.
- X'A'
- None. Fast replication cannot be used.
- X'B'
- Refer to the previously issued ADR918I message for the base cluster and/or any alternate indexes
in the sphere and resolve the problems.
- X'C'
- Specify NOPACK.
- X'D'
- See the previously issued ADR936W message and resolve the problem.
- X'E'
- See the previously issued ADR932W message and resolve the problem.
- X'F'
- Move the data to a volume that supports data set fast replication.
- X'10'
- Remove the REBLOCK keyword if specified.
- X'11'
- For storage classes without guaranteed space, copy the data set to a storage class with the same
Sustained Data Rate (SDR) as the source storage class. For storage classes with guaranteed space,
specify output volumes, the number of which is equal to the number of stripes of the source data
set.
- X'12'
- None. Fast replication cannot be used.
- X'13'
- Remove the AUTORELBLOCKADDRESS or the RELBLOCKADDRESS keyword.
- X'14'
- If you did not receive a reason code following return code X'14' and would like to have
more information, specify the DEBUG(FRMSG(SUMMARIZED | DETAILED)) keyword in the JCL and rerun the
job.
See the reason code provided in this summarized or detailed message. If one or more
QFRVOLS reason codes are provided, see z/OS DFSMS Advanced Copy Services for appropriate actions. If one or more DFSMSdss reason codes are provided, take the following actions depending
on the reason code (dss_reason_code):
- X'1'
- Ensure that the volumes contain enough space.
- X'2'
- Ensure that the VTOC on the volumes contain enough space.
- X'3'
- Specify non-SMS-managed volumes.
- X'4'
- See previously issued messages for information about the LSPACE macro failing reason. Correct
the problem and resubmit the job.
- X'5'
- Rename the target data set.
- X'6'
- Resolve the duplicate data set name and resubmit the job.
- Specify additional target volumes. For indexed sequential data sets, specify a volume that has
free space on the matching tracks.
- X'7'
- Specify a volume that has free space on the matching tracks.
- X'8'
- Correct the DADSM failure and resubmit the job.
- X'9'
- Specify a volume with an indexed VTOC.
- X'15'
- See the SMS allocation messages for an explanation. Correct the problem and resubmit the hob. If
SMS messages were not issued, specify the DEBUG(FRMSG(SUMMARIZED | DETAILED)) keyword in the JCL and
rerun the job.
- X'16'
- See the previously issued ADR932W message and resolve the problem.
- X'18'
- Remove the CONVERT keyword.
- X'19'
- None. Fast replication cannot be used.
- X'1A'
- None. Fast replication cannot be used.
- X'1B'
- None. Fast replication cannot be used.
- X'1C'
- If possible, copy the data set to a single volume that contains enough space to contain the
entire source data set.
- X'1D'
- None. Fast replication cannot be used.
- X'1E'
- None. Fast replication cannot be used.
- X'1F'
- None. Fast replication cannot be used.
- X'20'
- None. Fast replication cannot be used.
- X'21'
- None. Fast replication cannot be used.
- X'22'
- Remove the TGTALLOC(CYL) keyword.
- X'23'
- Ensure that the target volumes contain sufficient space so that the target data set does not
need to be extended during the copy process.
- X'24'
- Search problem reporting databases for a fix for the problem. If no fix exists, contact the IBM® Support Center.
- X'25'
- Rerun the job when there are fewer active relationships on the volume. Use the TSO FCQUERY
command to find out how many relationships are active. See
z/OS DFSMS Advanced Copy Services for more information about FlashCopy TSO
commands.
- X'26'
- The source and target data and index components must be allocated the same size in
order to use a fast replication method. Try adding the keyword TGTALLOC (SRC) or using a
preallocated data set. Once the data set is copied with IDCAMS, subsequent copies of the target data
set by DFSMSdss will likely not require
the use of IDCAMS.
- X'27'
- If the FASTREPLICATION(REQUIRED) or DEBUG(FRMSG(SUMMARIZED | DETAILED)) keyword is specified,
this return code X'27' is followed by one or more QFRVOLS PRESERVE MIRROR volume reason
codes (qfrvols_vrsn). Refer to
z/OS DFSMS Advanced Copy Services
z/OS DFSMS Advanced Copy Services for information about the QFRVOLS
volume reason codes.
If you did not receive a reason code following return code X'27' and
would like to have more information, specify the DEBUG(FRMSG(SUMMARIZED | DETAILED)) keyword in the
JCL and rerun the job.
For a DEFRAG or CONSOLIDATE operation, specify a volume that is
eligible for Preserve Mirror, or specify FCTOPPRCPRIMARY(PRESMIRPREF) keyword, or specify the
FASTREPLICATION(PREFERRED) keyword.
For a Physical COPY FULL, TRACKS, or DATASET operation,
specify an output volume that is eligible for Preserve Mirror, or specify
FCTOPPRCPRIMARY(PRESMIRPREF) keyword, or specify the FASTREPLICATION(PREFERRED) keyword.
For a
Logical DATASET COPY operation, specify a sufficient number of output volumes that are eligible for
Preserve Mirror, or specify FCTOPPRCPRIMARY(PRESMIRPREF) keyword, or specify the
FASTREPLICATION(PREFERRED) keyword. For a DEFRAG or CONSOLIDATE operation, specify a volume that is
eligible for Preserve Mirror, or specify FCTOPPRCPRIMARY(PRESMIRPREF) keyword, or specify the
FASTREPLICATION(PREFERRED) keyword.
- 28
- The IGDSMSxx parmlib option specified PS_EXT_VERSION= 1 which caused the target data set to be
allocated as a version 1 type extended format data set. In order to use fast replication the source
and target data set version type must be the same. Otherwise fast replication cannot be used.
- 29
- None. Fast replication cannot be used.
Source