The following table describes the parameters that you can use with the ANTRQST macro to establish Compatible FlashCopy® V2 relationships by volume.
|
Parameter |
Value |
Description |
|---|---|---|
|
SDEVN |
Source device number |
Specifies the device number (device address) of the S-VOL on which you want to perform the FCESTABLISH command. |
|
TDEVN |
Target device number |
Specifies the device number (device address) of the T-VOL on which you want to perform the FCESTABLISH command. |
|
INCREMENTAL |
YES |
Establishes a relationship including all tracks in the volume. If you specify YES for this parameter and COPY for the MODE parameter, the relationship is maintained after the background copy operation completes, and the differential data between the S-VOL and the T-VOL is maintained. As long as the relationship is maintained, you cannot update the T-VOL. When you execute the ANTRQST macro with the INCREMENTAL parameter, the differential data between the S-VOL and the T-VOL is copied. When this parameter is specified and the IBM® host supports the Multiple Incremental FlashCopy® function, an Incremental Type2 relationship is established. For other cases, an Incremental Type1 relationship is created. |
|
NO |
The relationship will be deleted after background copying completes. NO is the default setting. |
|
|
YTW |
The relationship remains in effect after the background copy operation completes. Data can be written to the T-VOL. Subsequent changes are tracked so that future operations are performed incrementally. This relationship continues until explicitly ended with a Withdraw request. When this parameter is specified and the IBM® host supports the Multiple Incremental FlashCopy® function, an Incremental Type2 relationship is established. For other cases, an Incremental Type1 relationship is created. Note: The target volume is writable while the incremental relationship is active. Any writes to the target during this period are overwritten if a subsequent incremental copy is executed, keeping the target an exact copy of the source. If the relationship is reversed, the changes made to the target are reflected to the source. |
|
|
TGTPPRIM |
YES |
Specifies using the Compatible FlashCopy® V2 T-VOL as a TCz P-VOL or a URz P-VOL. |
|
NO |
Specifies that the Compatible FlashCopy® V2 T-VOL is not sharing a volume with a TCz P-VOL or a URz P-VOL. NO is the default setting. |
|
|
RETINFO |
Return value |
Obtains the return code and the reason code for the execution results. For information about the codes, see the IBM® z/OS® MVS System Messages, Vol 1 (ABA-AOM), or the ANTRQSTL macro code. |
|
MODE |
COPY |
Copy all of the data in the source volume copy range specified in SDEVN in the background to the target volume specified by TDEVN. The relationship ends automatically, and the Compatible FlashCopy® V2 relationship is deleted when all of the data is copied. COPY is the default setting. |
|
NOCOPY |
Do not copy data in the background. The relationship does not end automatically even when all of the data is copied. To withdraw the relationship, use the FCWITHDR command. In the following cases, the data subject to read/write processing is copied from the source to the target before Compatible FlashCopy® V2 read/write processing starts.
|
|
|
NO2CPY |
A relationship created using NOCOPY mode is changed to COPY mode and a background copy operation is started. When all of the data is copied, the relationship is released automatically. |
|
|
ONLINTGT |
YES |
Do not check the path group. The relationship is established even when the copy target is online. |
|
NO |
Check the path group. The relationship is not established when the copy target is online. NO is the default setting. |
|
|
ACTION |
FREEZE |
Operates on the host and suspends the write operations to all S-VOLs. To resume the write operation, you need to issue the FCWITHDRAW command with the ACTION parameter. If a timeout occurs, the write operation may be resumed even when you do not issue the FCWITHDRAW command. You can change the set timeout value (120 seconds by default). For further information, see Suspending write operations to S-VOLs when establishing FlashCopy relationships |
|
FRR |
Reverse the S-VOL and T-VOL of an existing relationship.
|
|
|
TGTUCB |
YES |
Specifies the device number (device address) of the T-VOL on which you want to perform the FCESTABLISH command. To specify this number, use the TDEVN parameter. YES is the default setting. |
|
NO |
Specifies the serial number, CU number, and LDEV number of the T-VOL on which you want to execute the FCESTABLISH command. To specify this number, use the TGTSERIAL, TGTLSS, TGTDVC parameters instead of TDEVN. |
|
|
PRESMIR |
NO |
Establishes the relationship without using the Preserve Mirror FlashCopy® function. NO is the default setting. |
|
REQ |
Establishes the relationship using the Preserve Mirror FlashCopy® function. If the relationship cannot be established, the system rejects the command. TGTPPRIM=YES must be specified at the same time. |
|
|
PREF |
Establishes the relationship using the Preserve Mirror FlashCopy® function. If the relationship cannot be established, the copy operation is executed using the existing FlashCopy® to PPRC Primary Volume function. TGTPPRIM=YES must be specified at the same time. |
|
|
TGTSERIAL |
Serial number of the storage system containing the T-VOL |
Specifies the serial number of the storage system containing the T-VOL on which you want to execute the FCESTABLISH command. Use this parameter when the TGTUCB parameter is set to NO or the REMOTE parameter is set to YES. |
|
TGTLSS |
T-VOL CU number |
Specifies the CU number of the T-VOL on which you want to perform the FCESTABLISH command. Use this parameter when the TGTUCB parameter is set to NO or the REMOTE parameter is set to YES. |
|
TGTDVC |
T-VOL LDEV number |
Specifies the LDEV number of the T-VOL on which you want to execute the FCESTABLISH command. Use this parameter when the TGTUCB parameter is set to NO, or the REMOTE parameter is set to YES. |
|
REMOTE |
YES |
Use the Remote FlashCopy® function to establish a relationship. |
|
NO |
You do not use the Remote FlashCopy® function. NO is the default setting. |
|
|
DEVN |
TCz source device number |
Specifies the TCz source device number (device address). Use this parameter when REMOTE is set to YES. |
|
SRCSERIAL |
Serial number of the storage system containing the S-VOL |
Specifies the serial number of the storage system containing the S-VOL on which you want to execute the FCESTABLISH command. Use this parameter when REMOTE is set to YES. |
|
SRCLSS |
S-VOL CU number |
Specifies the CU number of the S-VOL on which you want to perform the FCESTABLISH command. Use this parameter when REMOTE is set to YES. |
|
SRCDVC |
S-VOL LDEV number |
Specifies the LDEV number of the S-VOL on which you want to execute the FCESTABLISH command. Use this parameter when REMOTE is set to YES. |
|
SSID |
SSID |
Specifies the SSID of the CU on which to establish the FlashCopy® relationship. Use this parameter when REMOTE is set to YES. |
|
SETGTOK* |
YES |
Specifies that the T-VOL can be a TSE-VOL. |
|
NO |
Specifies that the T-VOL cannot be a TSE-VOL. |
|
|
*Valid in Compatible FlashCopy® SE. |
||