resyncflash

The resyncflash command is a point in time copy of an existing FlashCopy pair established with the -record and -persist parameters. The resyncflash command only copies the parts of the volume that have changed since the last point in time copy. When a pair is established with the -record and -persist parameters, the pair initially synchronizes and then a record of all host write operations to the source is maintained in the source volumes. When the resyncflash command is issued on the pair, the new data that is written to the source is copied to the target. The parameters specified in this command replace the parameters in the existing relationship. In order to keep the initial -record and -persist parameters, the -record and -persist parameters must be specified in the resyncflash command.

Read syntax diagramSkip visual syntax diagram
>>-resyncflash--+-------------------------+--+----------+------->
                '- -dev--storage_image_ID-'  '- -record-'   

>--+-----------+--+----------+--+-----------+------------------->
   '- -persist-'  '- -freeze-'  '- -tgtpprc-'   

>--+--------------+--+--------------+--------------------------->
   '- -tgtoffline-'  '- -tgtinhibit-'   

>--+------------------------------+----------------------------->
   '- -seqnum--flash_sequence_num-'   

>--+-source_volume_ID:target_volume_ID--+-------+-+------------><
   |                                    '-. . .-' |   
   '-" - "----------------------------------------'   

Parameters

-dev storage_image_ID
(Optional) Specifies the storage image ID, which includes values for the manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified ID for the source and target volumes and you do not specify a value for the devid variable in your profile file.
Example: IBM.1750-68FA120
-record
(Optional) Records the changed tracks on both volumes within a FlashCopy pair. Use this parameter if you intend to use the resyncflash command again with this pair. The -persist parameter is automatically selected when the -record parameter is selected.
Note: You cannot reissue the resyncflash command if you leave this parameter out of your command string.
-persist
(Optional) Retains the FlashCopy relationship after the background copy completes. The FlashCopy relationship between the source and the target volumes remains indefinitely until broken by a rmflash command. This parameter is automatically selected when the -record parameter is selected. Select this parameter along with the -record parameter if you are using this volume pair with the commands resyncflash, reverseflash, or setflashrevertible.
Note: You cannot reissue the resyncflash command if you leave this parameter out of your command string.
-freeze
(Optional) 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.
-tgtpprc
(Optional) Allows the FlashCopy target volume to be a Remote Mirror and Copy source volume.
-tgtoffline
(Optional) Causes the mkflash command to be rejected if the target volume is online for host system access. This parameter only applies to CKD volumes.
-tgtinhibit
(Optional) Prevents host system write operations to the target while the FlashCopy relationship exists.
-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. Only the relationships that are modified successfully by the resyncflash command get the specified sequence number, leaving the ones that failed with the previous one (if they were previously specified).
This parameter is not supported for machine type 2105.
Example: 0010
source_volume_ID:target_volume_ID . . . | -
(Required) Increments a FlashCopy relationship for the source and target volume pairs with the IDs specified. 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 or you specify a value for the devid variable in your profile file. You must separate multiple FlashCopy pair IDs with spaces.
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-75FA120/0001:IBM.1750-68FA120/0004
Example of a shortened version: 0001:0004
Example of multiple pairs: 0001:0004 0003:00FF 0008:000C

Example (1750)

Invoking the resyncflash command
dscli>resyncflash IBM.1750-68FA120/0100:IBM.1750-68FA120/0200  
The resulting output
Date/Time: Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 
DS: IBM.1750-68FA120

Remote FlashCopy volume pair IBM.1750-68FA120/0100:IBM.1750-68FA120/0200
 successfully resynchronized.
Related reference
mkflash
rmflash
lsflash
setflashrevertible
reverseflash
commitflash
revertflash
unfreezeflash
mkgmir
pausegmir
resumegmir
rmgmir
showgmir
lssession
mksession
chsession
rmsession
chlss
chlcu
mkremoteflash
lsremoteflash
rmremoteflash
setremoteflashrevertible
resyncremoteflash
reverseremoteflash
commitremoteflash
revertremoteflash
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.