Using z/VM FLASHCOPY ESTABLISH to establish relationships

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 shows the parameters are available when establishing relationships by using the FLASHCOPY ESTABLISH command.
Note: The FLASHCOPY ESTABLISH command does not cancel the relationship after the copy operation completes.
Table. Parameters for the FLASHCOPY ESTABLISH command

Parameter

Value

Description

SOURCE

Primary device number, Starting cylinder of source, Ending cylinder of source

Specifies the virtual device number (device address or mini disk number), the starting cylinder, and the ending cylinder of the copy source.

TARGET

Secondary device number, Starting cylinder of target, Ending cylinder of target

Specifies the virtual device number (device address or mini disk number), the starting cylinder, and the ending cylinder of the copy destination.

CHGRECORD

-

Establishes a relationship whose target is the entire virtual volume. If the S-VOL and the T-VOL are updated, the data that has been changed is managed as differential data.

When you specify this parameter, an Incremental Type1 relationship is established regardless whether the IBM® host supports the Multiple Incremental FlashCopy® function.

NOTGTWRITE

-

Write to the S-VOL is not allowed until the FLASHCOPY TGTWRITE is executed.

REVERSIBLE

-

Establishes a relationship whose target is the entire virtual volume. If the S-VOL and the T-VOL are updated, the data that has been changed on the S-VOL or T-VOL is managed as differential data, and write to the T-VOL is not allowed until the FLASHCOPY TGTWRITE command is executed.

NOCOPY

-

Does not perform the background copy when establishing the relationship.

FAILNOSPACE

-

When the T-VOL is a TSE-VOL and the pool becomes full, the state of the relationship will change to failed state. For details about failed state, see Managing failed states.

When the T-VOL is a TSE-VOL, this parameter is set by default.

NOSETARGET

-

This parameter can be set when the T-VOL is not a TSE-VOL. If this parameter is specified when the T-VOL is a TSE-VOL, creating relationships will fail.

See the IBM® z/VM CP Commands and Utilities document for your version of z/VM for more information about the parameters.

An example of the FLASHCOPY ESTABLISH command follows. In this example, cylinders 0 to 99 are copied from device 10 to device 20 in COPY mode. The relationship remains after the completion of the copy operation.

FLASHCOPY ESTABLISH SOURCE 10 0-END TARGET 20 0-END
Command complete: FLASHCOPY 0010 0 99 TO 0020 0 9

To cancel the relationship after the copy completes, use the FLASHCOPY WITHDRAW command. For more information on the FLASHCOPY WITHDRAW command, see Using z/VM CP FLASHCOPY WITHDRAW to release Compatible FlashCopy® V2 relationships.