resyncremoteflash

Parameters

-dev storage_image_ID

(Optional) The storage image ID consists of the manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command.

Example: IBM.2107-75FA120

-conduit LSS_ID

(Required) The source logical subsystem (LSS) of an existing remote mirror and copy relationship that is to be used as a means for communicating with the remote storage image. The source volume IDs that are specified in the SourceVolumeID:TargetVolumeID parameter, must serve as secondary volumes in a remote mirror and copy relationship in which one of the conduit LSS volumes serves as a primary volume.

When you use this parameter, you must specify a fully qualified LSS ID. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range 00 - FE.

Example: IBM.2107-75FA120/00

-record

(Optional) This parameter, without the -multinc parameter, creates a type 1 incremental FlashCopy relationship. The type 1 FlashCopy® records data changes on both the source and target volumes of the FlashCopy pair.

A single volume can be the source volume to up to 12 FlashCopy relationships, and these relationships can be any combination of normal, persistent, or incremental relationships. However, only a single type 1 incremental relationship can exist.

Select this parameter when you create an initial FlashCopy relationship that you later want to use with the resyncflash or reverseflash command. If the -multinc parameter is not selected, you can also use the setflashrevertible command.

When you select the -record parameter, the –persist parameter is automatically selected.

-persist

(Optional) Creates a persistent FlashCopy relationship in which the relationship remains after the copy completes and remains indefinitely until you enter a rmflash command against the FlashCopy pair. If this parameter is not specified, a normal FlashCopy relationship is created and is automatically removed after the copy completes.

A single volume can be the source volume to up to 12 FlashCopy relationships, and these relationships can be any combination of normal, persistent, or incremental relationships. However, only a single type 1 incremental relationship can exist.

See the -record parameter for a description of a type 1 incremental FlashCopy relationship and the -multinc parameter for a description of a type 2 incremental relationship.

When you select either the -record or the -multinc parameter, the persist parameter is automatically selected.

-multinc

(Optional) Creates a type 2 incremental FlashCopy relationship. The type 2 FlashCopy records data changes only on the target volume of the FlashCopy pair.

A single volume can be the source volume to up to 12 FlashCopy relationships, and these relationships can be any combination of normal, persistent, or incremental relationships. However, only a single type 1 incremental relationship can exist.

The type 2 FlashCopy allows for more than one incremental FlashCopy relationship from the same source volume. However, because the change recording is maintained only on the target volume, the type 2 FlashCopy can cause a performance impact as more type 2 FlashCopy relationships are added.

Select this parameter when you create multiple FlashCopy volume pairs with the same source volume that you want to use with the resyncflash and reverseflash commands. However, FlashCopy pairs established with this modified recording method cannot be used with the setflashrevertible command.

When you select the -multinc parameter, the -persist and -record parameters are automatically selected.

-freeze

(Optional) The Freeze Consistency Group condition. This parameter causes the source volume to be busy (Queue Full status on Open Systems) to all host I/O operations until a FlashCopy Consistency Group Created command is received. All writes to the source volume are queued by the host and are written after the Consistency Group Created command is complete.

During the busy condition, the source volume reports Queue Full for fixed block volumes and busy status for CKD volumes.

The busy condition can also be reset by an extended long busy timeout (default 120 seconds). The timeout condition affects all FlashCopy source volumes that are contained within a respective logical subsystem and that are established or modified with the -freeze parameter.

Note: This parameter is used with other processing steps for purposes such as backups, testing, or recovery solutions. The use of this parameter ensures that volumes on the target LSSs are consistent with the source LSSs volumes.

-tgtpprc

(Optional) Allows the FlashCopy target volume to be a remote mirror and copy source volume.

-tgtoffline

(Optional) Causes the resyncremoteflash command to be rejected if the target volume is online for host system access.

Note: This parameter applies only to count key data volumes.

-tgtinhibit

(Optional) Prevents host system write operations to the target while the FlashCopy relationship exists.

-tgtse

(Optional) The target volume you specify as a space-efficient logical volume. An error message is generated if the target volume is a space-efficient volume and you do not specify this parameter.

-nocp

(Optional) Inhibits the background copy. Data is copied from the source volume to the target volume only if a track on the source volume is modified. The FlashCopy volume pair relationship remains indefinitely until it is broken by a rmflash command, or until all tracks on the source volume are modified.

When -tgtse is specified and the -cp and -nocp parameters are not specified, the no background copy behavior is the default.

You cannot use the -nocp parameter with the -cp parameter in the same command.

-cp

(Optional) Starts a background copy. When -tgtse is not specified and the -cp and -nocp parameters are not specified, the background copy behavior is the default.

You cannot use the -cp parameter with the -nocp parameter in the same command.

-seqnum flash_sequence_num

(Optional) Associates the FlashCopy relationships that are established with the specified sequence number. You can use this sequence number as an identifier for a relationship or group of relationships. Only the relationships that are modified successfully by the resyncremoteflash command are assigned the specified sequence number, leaving the ones that fail with the previous one (if they were previously specified).

Example: 0010

-srcss SS_ID

(Optional) The subsystem ID of the source logical subsystem at the remote site. The subsystem ID is a four-digit hexadecimal number in the range (0001 - FFFF). When this parameter is used, all source volumes must be designated within the same logical subsystem.

This parameter is required for IBM Enterprise Storage Server versions 2.4.0 and 2.4.1.

Example: FF10

-resetreserve

(Optional) Forcibly clears any SCSI reservation on the target volume and allows establishing of a FlashCopy relationship. The reservation is not restored after the relationship is established.

• When this option is not specified and the target volume is reserved, the command fails.
• This option is ignored if the target is a CKD volume; this option is applicable only for fixed block volumes.

SourceVolumeID:TargetVolumeID ... | -

(Required) The remote FlashCopy relationship for the source and target volume pairs be incremented with the designated IDs. This parameter accepts fully qualified volume IDs, which includes storage image IDs or a shortened version without storage image IDs, if the -dev parameter is specified,

A FlashCopy pair ID consists of two volume IDs: one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume.

The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of XYZZ, where:

XY

The logical subsystem number, 00 - FE.

ZZ

The volume number, 00 - FF.

X

The address group, 0 - F.

The ellipsis (...) indicates that, optionally, you can specify multiple values. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.

Example of a fully qualified FlashCopy pair ID: IBM.2107-75FA120/0001:IBM.2107-75FA120/0004

Example of a shortened version: 0001:0004

Example of multiple pairs: 0001:0004 0003:00FF 0008:000C