mkremoteflash

Parameters

-dev storage_image_ID

(Optional) Specifies the storage image ID, which includes manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified ID for the source and target volumes or you do not specify a value for the devid variable in your profile file.

-conduit LSS_ID

(Required) Specifies the source logical subsystem (LSS) of an existing remote mirror and copy relationship that is to be used as a conduit 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 - 1F (1750 only).

Example: IBM.1750-68FA120/00

-tgtpprc

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

-tgtoffline

(Optional) Causes the mkremoteflash command to be rejected if the target volume is online for host system access. This parameter applies only to CKD volumes.

-tgtinhibit

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

-freeze

(Optional) Specifies the Freeze Consistency Group condition. The use of this parameter triggers the queue full condition for the source volume. All writes to the source volume are queued by the host and are written after the queue full condition is reset.

During the queue full condition, the source volume reports long busy status.

The queue full condition is reset by an extended long busy timeout. 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 in conjunction 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.

-record

(Optional) Specifies that the changed tracks on both volumes within a FlashCopy pair be recorded. Select this parameter if you intend to use the resyncremoteflash command again with this pair. The -persist parameter is automatically selected when the -record parameter is specified.

-persist

(Optional) Specifies that you want to retain the FlashCopy relationship after the background copy completes. The FlashCopy relationship between the source and the target volumes remains indefinitely until you issue a rmremoteflash command. This parameter is automatically selected when the -record parameter is specified.

Specify this parameter along with the -record parameter if you intend to use this volume pair with the resyncremoteflash, reverseremoteflash, or setremoteflashrevertible commands.

-nocp

(Optional) Inhibits background copy. Data will be 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 rmremoteflash command, or until all tracks on the source volume are modified.

-seqnum flash_sequence_num

(Optional) Associates the FlashCopy relationships that are established with the specified sequence number. This sequence number can be used as an identifier for a relationship or group of relationships.

Example: 0010

This parameter is not supported for machine type 2105.

-srcss SS_ID

(Optional) Specifies the subsystem ID of the source logical subsystem at the remote site. The ID is in the format 0x0001 - 0xFFFF.

This value is required for the IBM System Storage™ Enterprise Storage Server versions 2.4.0 and 2.4.1. When you specify SS_IDs, the source volumes are restricted to one LSS.

Example: FF10

SourceVolumeID:TargetVolumeID . . . | -

(Required) Specifies that a 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 4 hexadecimal digits in the form of XYZZ where X is the address group (0 - 1), XY together is the logical subsystem number 00 - 1E (for 1750) , and ZZ is the volume number (00 - FF).

If you specify the dash (-), this parameter information is automatically supplied.

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

Example of a shortened version: 0001:0004

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