commitremoteflash

Edit online

The commitremoteflash command sends data to a target volume to form consistency between the remote source and target FlashCopy pair.

Read syntax diagramSkip visual syntax diagram commitremoteflash  -dev  storage_image_ID  -conduit  LSS_ID  -seqnum  flash_sequence_num  -srcss  SS_ID  SourceVolumeID   ...   "-"

Parameters

Notes:
  1. Establish the pair by issuing either the mkflash or mkremoteflash command with the -record and -persist parameters.
  2. Issue either the setflashrevertible or setremoteflashrevertible command against the pair.

Only after you have taken these two steps can you issue the commitremoteflash command.

-dev storage_image_ID
(Optional) The storage image ID consists of the manufacturer name, 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 will temporarily override 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 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 specify this parameter, you must specify a fully qualified LSS ID. The fully qualified LSS ID format is storage_image_ID/XX. The value for the XX is 00 - FE.
-seqnum flash_sequence_number
(Optional) The commit operation is performed only on those source volumes that are associated with the specified sequence number.
This parameter is not supported for machine type 2105.
Example: 0010
-srcss SS_ID
(Optional) The subsystem ID of the source logical subsystem at the remote site. When this parameter is used, all source volumes must be within the same logical subsystem.
This parameter is required only for IBM Enterprise Storage Server versions 2.4.0 and 2.4.1.
Example: FF10
SourceVolumeID ... | -
(Required) Commits remote FlashCopy relationships for the source volumes with the specified IDs. The chosen pair is the one with the enabled -record parameter. You must separate multiple source volume IDs with spaces.
This parameter accepts fully qualified volume IDs, which includes the storage image ID, or a shortened version without the storage image ID if either the -dev parameter is specified, or you can specify a value for the devid variable in your profile file.
The volume ID is a 32 bit number that can be represented as 4 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 volume ID: IBM.2107-75FA120/0001
Example of a shortened version: 0001
Example of IDs: 0001 0003 0008

Example: Committing data to form consistency between the specified remote source and target FlashCopy pair 

dscli> commitremoteflash -dev IBM.2107-75FA120 -conduit IBM.2107-75FA150/10 0100
Output
FlashCopy pair 0100:0200 successfully committed.