Using TSO to establish Compatible FlashCopy V2 relationships by extent

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

The following table describes the parameters used to establish Compatible FlashCopy^® V2 relationships by extent with the FCESTABL command.

Table. Parameters for using the FCESTABL command to establish Compatible FlashCopy^® V2 relationships by extent)
Parameter	Value	Description
EXTENTS	Extents (copy range)	Specifies the extent (copy range) by setting the same starting and ending addresses of the source and target with CCHH (cylinder and head numbers). From the copy source, the specified data is copied to the same offset position on the copy target. Up to 32 extents can be specified. When EXTENTS is not specified, the data on all of the tracks is copied.
XTNTLST	Extents (copy range)	Specifies the extent (copy range) by setting the starting and ending addresses of the source, and the starting and ending addresses of the target with CCHH (cylinder and head numbers). From the copy source, the specified data is copied to a different offset position on the copy target. Up to 32 extents can be specified. When XTNTLST is not specified, the data on all of the tracks is copied.
XXTNTLST	Extents (copy range)	Specifies the extent (copy range) by setting the starting and ending addresses of the source, and the starting and ending addresses of the target with ccccccch (cylinder and head numbers), when either of both the copy source and target exceed 65,520 cylinders. From the copy source, the specified data is copied to a different offset position on the copy target. Up to 32 extents can be specified. When XXTNTLST is not specified, the data on all of the tracks is copied.

If you specify 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 FCESTABL command with the EXTENTS parameter, only the specified source extents are copied from the source to the target. The source extents are specified by SDEVN and the target extents are specified by TDEVN. The following figure shows an example of copying only Dataset 2 from the S-VOL to the T-VOL. If you do not specify the EXTENTS parameter, the entire source volume is copied to the target volume.

Figure. Copying datasets using the FCESTABL command with the EXTENTS parameter

When you execute the FCESTABL command with the XTNTLTS or XXTNTLST parameter, the specified source extents are copied to the specified target extents. Starting and ending addresses are specified by cylinder and head and do not have to match in the source and target volumes. The following figure shows an example of copying Dataset 2 from the S-VOL to a different position on the T-VOL.

Figure. Copying datasets using the FCESTABL command with the XTNTLST or XXTNTLST parameter

When you establish a Compatible FlashCopy^® V2 dataset relationship per extent for a volume with CATALOG, you trigger a write operation from the host to both the VTOC and CATALOG (the volume table of contents and dataset attributes and the data set locations).

To perform dataset copying using the FCESTABL command:

Use the VTOC list stored in the S-VOL to check the VTOC INDEX and the position of the extent (cylinder number, header number, and size) used for the dataset copy operation.
Create the copy target dataset on the T-VOL.
Obtain the VTOC list stored in the T-VOL.
Set the T-VOL offline.
Execute the FCESTABL command with the XTNTLST or XXTNTLST parameter.
Use the XTNTLST or XXTNTLST parameter to specify the extent position information for the source and target extents. If there are multiple extents, you need to specify the position information for each extent.

Use the XTNTLST or XXTNTLST parameter as follows:
- Specify multiple copy target datasets to be copied simultaneously from a single copy source dataset.
- Specify the simultaneous execution of volume copying and dataset copying from a single source volume.
- Specify multiple source datasets that are overlapping or are part of another dataset. You can specify a maximum of 16 extents per dataset.
- Do not specify multiple target datasets that are overlapping.
- Specify source and target datasets that reside at one position on the S-VOL and at a different position on the T-VOL.
- Specify source and target datasets that are in the same volume, provided that they do not overlap.
If the T-VOL was set offline in step 4, set it online.
You can skip this step if the ONLINTGT parameter of the FCESTABL command is set to YES.

You can only execute the FCESTABL command once for each Compatible FlashCopy^® V2 relationship.

An example of the FCESTABL command follows. In this example, the FCESTABL command specifies the following:

FCESTABL SDEVN(X'4202') TDEVN(X'4203') MODE(NOCOPY)
     XTNTLST(X'01000004' X'0357000A' X'13000001' X'15570007',
             X'02AC0006' X'02FF000C' X'18A00000' X'18F30006')

The data on the extent starting from CCHH '01000004' and ending at CCHH '0357000A' on source device number 4202 is to be copied to the extent starting from CCHH '13000001' and ending at CCHH '15570007' on target device number 4203.
The data on the extent starting from CCHH '02AC0006' and ending at CCHH '02FF000C' on source device number 4202 is to be copied to the extent starting from CCHH '18A00000' and ending at CCHH '18F30006' on target device number 4203 (the copy operation mode is set to NOCOPY). Example of FCESTABL command (Compatible FlashCopy^® V2 / XTNTLST and NOCOPY are specified):