The following table shows the FCWITHDR command parameters used to release Compatible FlashCopy® V2 relationships.
|
Parameter |
Value |
Description |
|---|---|---|
|
SDEVN |
Source device number. |
Specifies the number (device address) of the S-VOL on which to perform the FCWITHDR command. |
|
TDEVN |
Target device number. |
Specifies the number (device address) of the T-VOL on which to perform the FCWITHDR command. |
|
DEVN |
Device number. |
Specifies the number (device address) of the device on which to perform the FCWITHDR command with ACTION parameter. |
|
TCz source device number |
Specifies a TCz P-VOL (device address). Use this parameter when REMOTE is YES. |
|
|
DDSW |
YES |
Specifies that all relationships involving the device specified by SDEVN are withdrawn. Any NOCOPY relationships are converted to COPY and the copy operations for all relationships are completed before the relationship is withdrawn. The DDSW parameter cannot be used with CFCSE. |
|
NO |
Specifies that the relationships specified by the SDEVN parameter are withdrawn without data space withdraw considerations. See the IBM® z/OS DFSMS Advanced Copy Services manual for more information. NO is the default setting. |
|
|
XTNTLST |
Extent (range to withdraw the relationship) |
Specifies the extent range to withdraw by setting the starting and ending addresses of the source extent and the starting and ending addresses of the target extent with CCHH. Up to 32 extents can be specified. When XTNTLST is not specified, the relationships on all of the tracks are withdrawn. XTNTLST can only be used when the number of cylinders for the source is 65,520 or less. XTNTLST cannot be used for Extended Addressable Volumes (EAV). |
|
XXTNTLST |
Extent (range to withdraw the relationship) |
Specifies the extent range to withdraw by setting the starting and ending addresses of the source extent and the starting and ending addresses of the target extent with ccccccch (cylinder and head numbers) when either or both the source and target exceeds 65,520 cylinders. Up to 32 extents can be specified. When using EAVs, use XXTHTLST to specify extents. |
|
ACTION |
THAW |
Resume write operations from the host for volumes that belong to the same CU as the device specified by the DEVN parameter. |
|
TGTUCB |
YES |
Specifies that the z/OS® device number specified in the SDEVN and TDEVN parameters is to be used. YES is the default setting. |
|
NO |
Specifies that the serial number, the CU number, and the LDEV number of the T-VOL are specified to perform the FCWITHDR command. To specify this number, use the TARGET parameter instead of TDEVN. |
|
|
TARGET |
Serial number, CU number, LDEV number of the T-VOL |
Specifies the serial number, the CU number, and the LDEV number of the T-VOL for which you want to perform the FCWITHDR command. Use this parameter when TGTUCB is NO. |
|
REMOTE |
YES |
Use the Remote FlashCopy® function to withdraw the relationship. |
|
NO |
Do not use the Remote FlashCopy® function. NO is the default setting. |
|
|
SOURCE |
Serial number, the CU number and the LDEV number of the S-VOL |
Specifies the serial number, the CU number and the LDEV number of the S-VOL on which you want to perform the FCWITHDR command. Use this parameter when REMOTE is YES. |
|
SSID |
SSID |
Specifies the SSID of the CU on which you withdraw the FlashCopy® relationship. Use this parameter when REMOTE is YES. |
To use the XTNTLST or XXTNTLST parameter, the size of the copy source extent and the copy target extent must be the same.
When you execute the FCWITHDR command, the combination of parameters that you specify will determine the command output. The following table shows the results of these combinations.
|
Relationship activity |
Parameter combinaton or relationship status |
Results |
|---|---|---|
|
Unspecified |
|
The relationships specified in the command are withdrawn when the command is executed. |
|
When the specified device has no relationships to withdraw |
The command will do nothing and end normally. |
|
|
When the specified device has no relationships that fall within the range specified by the XTNTLST or XXTNTLST parameter |
The FCWITHDR command will do nothing and end normally. |
|
|
DDSW parameter set to YES |
The relationships for the volume specified by the SDEVN parameter are withdrawn based on the MODE (COPY mode or NOCOPY mode) with which each relationship was established. The individual relationships are released as indicated in this table based on the mode of each relationship. All relationships are withdrawn as the appropriate conditions are met. |
|
|
FCWITHDR is issued for a relationship in COPY mode and the copy has not completed. |
The ongoing background copy operation is stopped and cancelled. |
The relationships specified in the command are withdrawn. |
|
DDSW parameter set to YES |
The relationships established with the specified copy source extents on the volume specified by SDEVN are withdrawn after the background copy is completed. |
|
|
FCWITHDR is issued for a relationship in NOCOPY mode. |
DDSW parameter set to YES |
The relationships established with the device specified in the SDEVN parameter are changed to COPY mode, and each relationship is withdrawn after the background copy for that relationship completes. |
The following table lists the FCWITHDR parameter combinations that will result in successful execution.
|
Parameter values |
|||||||
|---|---|---|---|---|---|---|---|
|
Case number |
SDEVN |
TDEVN |
DEVN |
DDSW setting |
XTNTLST or XXTNTLST |
ACTION |
|
|
Source |
Target |
||||||
|
1 |
Not specified |
Specified |
Not specified |
No |
Not specified |
Not specified |
Not specified |
|
2 |
Not specified |
Specified |
Not specified |
No |
Specified |
Specified |
Not specified |
|
3 |
Specified |
Specified |
Not specified |
No |
Not specified |
Not specified |
Not specified |
|
4 |
Specified |
Specified |
Not specified |
No |
Specified |
Specified |
Not specified |
|
5 |
Specified |
Specified or not specified |
Not specified |
Yes |
Not specified |
Not specified |
Not specified |
|
6 |
Specified |
Specified or not specified |
Not specified |
Yes |
Specified |
Specified |
Not specified |
|
7 |
Not specified |
Not specified |
Specified |
No |
Not specified |
Not specified |
THAW |
The extents information specified by the XTNTLST or XXTNTLST parameter is valid only when the following conditions are met:
- The value used for the XTNTLST or XXTNTLST parameter is for both the source and target. If the value is only set for one of the two, the copy operation will fail.
- The size of the specified copy source and copy target extents is same.
- The relationship is
established with INCREMENTAL = NO or is established without INCREMENTAL. CAUTION:Data on the T-VOL might be inconsistent if the relationships are withdrawn by FCWITHDR and the DDSW parameter is either set to NO or it is not set.