Using ICKDSF to establish Compatible FlashCopy V2 relationships by volume

DDNAME

DNAME

JCL statement

Specifies the JCL DD statement identifying the volume. If the host server OS is z/OS, this parameter or the UNITADDRESS parameter is required.

SYSNAME

SYSNAME

Specifies the SYSNAME in the ASSGN system control statement. If the host server OS is VSE, this parameter is required.

UNITADDRESS

UNITADDR

UNIT

Source device number

Specifies the device number (device address) of the S-VOL for the FLASHCPY ESTABLISH command. If the host server OS is z/OS, this parameter or the DDNAME parameter is required.

TARGETVOL

TGTVOL

CU number

LDEV number

Target device number

Specifies the CU number, LDEV number, and device number (device address) of the T-VOL for the FLASHCPY ESTABLISH command. This parameter is required.

CHANGERECORDING

CHANOERCD

CHRCD

YES

Establishes a relationship for the entire volume. The relationship to be established is an Incremental Type1 relationship. The relationship will be maintained after the background copy operation completes, and if the S-VOL and the T-VOL are updated, the updated tracks will be managed as differential data.

V2

Establishes a relationship for the entire volume. The relationship to be established is an Incremental Type2 relationship. The relationship will be maintained after the background copy operation completes, and if the S-VOL and the T-VOL are updated, the updated tracks will be managed as differential data.

NO

Establishes a relationship for the entire volume. The relationship will be deleted after the background copy operation completes.

NO is the default setting.

INHIBITTARGETWRITES

INHIBWRTS

NOTGTWR

YES

Inhibits writes to the T-VOL. If the relationship is maintained after the background copy operation completes, you cannot access the T-VOL in write mode until the relationship is deleted or you execute a command to enable write access.

NO

Do not inhibit writes to the T-VOL when the relationship is maintained after the background copy operation completes.

NO is the default setting.

MODE

COPY

Establishes a relationship for the entire volume, and executes the background copy operation.

COPY is the default setting.

NOCOPY

Establishes a relationship for the entire volume. The background copy operation is not executed.

ONLINTGT

ONTGT

YES

Establishes the relationship when the S-VOL is online.

NO

Does not establish the relationship when the copy target is online.

NO is the default setting.

RESTORE

N/A

If the S-VOL or the T-VOL of the relationship established by specifying YES or V2 for CHANGERECORDING is updated, only the data that has been changed on the S-VOL or T-VOL is copied. If you specify YES or V2 for CHANGERECORDING and you reverse the S-VOL or T-VOL, Reverse Restore is executed, and only the data that has been changed on the S-VOL or T-VOL is copied.

The relationship will be maintained after the copy operation completes if you specify YES or V2 for CHANGERECORDING. If you specify NO or nothing for INCREMENTAL CHANGERECORDING, the relationship will be withdrawn after the copy operation completes.

For CHANGERECORDING, if you specify a value different from the one for the incremental type of the existing relationship, the incremental type is not changed, and the copy operation continues with the incremental type of the existing relationship. For example, if you specify V2 for an Incremental Type1 relationship, or YES for an Incremental Type2 relationship, the incremental type is not changed.

FASTREVERSERESTORE

FASTREVREST

N/A

Specifies that the S-VOL and T-VOL of the relationship are to be reversed.

• If you specify YES or V2 for CHANGERECORDING, only the data that has been changed on the S-VOL or T-VOL is copied.
• If you specify NO for CHANGERECORDING or specify nothing, only the data that has been copied from the S-VOL to the T-VOL is copied.
• If you specify YES or V2 for CHANGERECORDING, the relationship will be maintained after the copy operation completes. If you specify NO or nothing for CHANGERECORDING, the relationship will be withdrawn after the copy operation completes.

For CHANGERECORDING, if you specify a value different from the one for the incremental type of the existing relationship, the command is rejected. For example, if you specify V2 for an Incremental Type1 relationship, or YES for an Incremental Type2 relationship, the command is rejected.

TGTCANCOMEONLINE

TGTONLINE

YES

Enables the T-VOL to be set online after the relationship is established.

YES is the default setting.

NO

Prevents the T-VOL from being set online until the relationship is deleted.

TGTOKASPPRCPRIM

YES

Specify this parameter when the Compatible FlashCopy^® V2 T-VOL and the TCz P-VOL or URz P-VOL share a volume.

NO

Specify this parameter when the Compatible FlashCopy^® V2 T-VOL and the TCz P-VOL or URz P-VOL do not share a volume.

NO is the default setting.

SOURCEVOL

SRCVOL

CU number

LDEV number

SSID

Serial number

Source device number

Specifies the CU number, the LDEV number, SSID, the serial number, or the device number (device address) of the S-VOL when you use the Remote FlashCopy^® function.

PRESERVEMIRROR

PRESMIR

REQUIRED

Establishes the relationship using the Preserve Mirror FlashCopy^® function. If the relationship cannot be established, the system rejects the command. You must also specify TGTOKASPPRCPRIM(YES).

PREFERRED

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. You must also specify TGTOKASPPRCPRIM(YES).

NO

Establishes the relationship without using the Preserve Mirror FlashCopy^® function.

NO is the default setting.

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.