Using PPRC TSO to establish Compatible FlashCopy V2 relationships by volume

Compatible FlashCopy User Guide for VSP One Block 85

Version

10.5.x

Audience

anonymous

Part Number

MK-26VSP1B031-02

ft:lastEdition

2026-05-04

Use the FCESTABL command parameters to establish Compatible FlashCopy^® V2 relationships by volume.

Table. FCESTABL command parameters for establishing relationships by volume
Parameter	Value	Description
SDEVN	Source device number	Specify the device address of the S-VOL on which you want to execute the FCESTABL command. (This parameter is required.)
TDEVN	Target device number	Specify the device address of the T-VOL on which you want to perform the FCESTABL command. (This parameter is required.)
MODE	COPY	All of the data in the copy range of the volume specified as the source by SDEVN is copied in the background to the volume specified as the target by TDEVN. The relationship ends automatically, and all of the data is copied. COPY is the default mode.
	NOCOPY	Data is not copied in the background. The relationship does not end automatically, even if all of the data is copied over time. To withdraw the relationship, you must use the FCWITHDR command. In the following cases, data is copied from the S-VOL to the T-VOL before access occurs in the following cases: There is access to write data on the copy source of the specified area within the extent. There is access to write data on the copy target of the specified area within the extent. There is access to read data on the copy target of the specified area within the extent.
	NOCOPY2COPY	A relationship created using NOCOPY mode is changed to COPY mode, and a background copy occurs for data not already copied to the T-VOL. When all of the data is copied, the relationship is released automatically.
ONLINTGT	YES	The path group is not checked. The relationship is established even if the copy target is online.
ONLINTGT	NO	The path group is checked. The relationship is not established when the copy target is online. NO is the default setting.
INCREMENTAL	YES	Establishes a relationship that includes all of the tracks in the volume. If you specify YES for this parameter and COPY for the MODE parameter, the relationship will be maintained after the background copy operation is completed, and the differential data between the S-VOL and the T-VOL will be managed. As long as the relationship is maintained, you cannot update the T-VOL. The differential data between the S-VOL and the T-VOL will be copied when you re-execute the FCESTABL command with the INCREMENTAL parameter, or you execute the FCESTABL command (Reverse Restore) with the S-VOL and the T-VOL reversed. When you specify this parameter, an Incremental Type2 relationship is created if the IBM^® host supports the Multiple Incremental Compatible FlashCopy^® function. For other cases, Incremental Type1 relationships are created.
	NO	The relationship will be deleted after the background copy operation is completed. NO is the default setting.
	YTW	The relationship remains in effect after background copy operation is completed. Data can be written to the T-VOL. Subsequent changes are tracked so that future operations are performed incrementally. This relationship continues until explicitly terminated by a Withdraw request. When you specify this parameter, an Incremental Type2 relationship is created if the IBM^® host supports the Multiple Incremental FlashCopy^® function. For other cases, Incremental Type1 relationships are created. Note:While the incremental relationship is active, the target remains writable. However, any changes made to the target during this period is overwritten by the next incremental copy operation, ensuring the target remains an exact replica of the source. If the relationship is reversed, modifications made to the target are also applied to the source.
TGTPPRIM	YES	Specify YES when the Compatible FlashCopy^® V2 T-VOL and the TCz P-VOL (or URz P-VOL) share the same volume.
TGTPPRIM	NO	Specify NO when the Compatible FlashCopy^® V2 T-VOL and the TCz P-VOL (or URz P-VOL) do not share the same volume. NO is the default setting.
TGTUCB	YES	Specifies the device number (device address) of the T-VOL on which you want to execute the FCESTABL command. To specify the device number, use the TDEVN parameter. YES is the default setting.
TGTUCB	NO	Specifies the serial number, CU number, and LDEV number of the T-VOL on which you want to execute the FCESTABL command. To specify this number, use the TARGET parameter instead of the TDEVN parameter.
TARGET	Serial number CU number LDEV number of the T-VOL	Specifies the serial number, CU number, and LDEV number of the T-VOL on which you want to execute the FCESTABL command. Use this parameter when the TGTUCB parameter is set to NO.
REMOTE	YES	Use the Remote FlashCopy^® function to establish a relationship.
REMOTE	NO	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 the REMOTE parameter is set to YES.
SOURCE	Serial number CU number LDEV number of the S-VOL	Specifies the serial number, CU number, and LDEV number of the S-VOL on which you want to execute the FCESTABL command. Use this parameter when the REMOTE parameter is set to YES.
SSID	SSID	Specifies the SSID of the CU on which you establish the Compatible FlashCopy^® V2 relationship. Use this parameter when the REMOTE parameter is set to YES.
ACTION	FREEZE	Operates on the host and suspends write operations to all S-VOLs. To resume write operations, run the FCWITHDRAW command with the ACTION parameter specified. If a timeout occurs, write operations might be resumed even if you do not run 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.
ACTION	FRR	Reverses the direction of the Compatible FlashCopy^® V2 relationship, restoring the source volume to the state it was in when it was last flashed to the target. Changed tracks are copied back from the target to the source.
PRESERVEMIRROR or PRESMIR	NO	Establishes the relationship without using the Preserve Mirror FlashCopy^® function. NO is the default setting.
	REQUIRED or REQ	Establishes the relationship by using the Preserve Mirror FlashCopy^® function. If the relationship cannot be established, the command is rejected. You must also specify TGTPPRIM(YES).
	PREFERRED or PREF	Establishes the relationship by 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. You must also specify TGTPPRIM(YES).
SETGTOK*	YES	Specifies that the T-VOL can be a TSE-VOL.
SETGTOK*	NO	Specifies that the T-VOL cannot be a TSE-VOL.
*Valid in Compatible FlashCopy^® SE

To perform volume copying:

Set the T-VOL offline.
Execute the FCESTABL command without specifying the EXTENTS and XTNTLST parameters.
Before you set the T-VOL online to an LPAR that has the S-VOL online, you must change the VOLSER of the T-VOL.
When the VTOC is copied, the VOLSER of the S-VOL and the T-VOL become identical, so this step is necessary before setting the T-VOL online.
Set the T-VOL online.

FCESTABL command example

The following is an example of FCESTABL command usage. In this example, the FCESTABL command specifies that the data in source device 4202 will be copied to target device 4203 using COPY mode while device 4203 is online.

FCESTABL SDEVN(X'4202') TDEVN(X'4203') MODE(COPY) ONLINTGT(YES)