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.

>>-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 commanddscli>resyncflash IBM.1750-68FA120/0100:IBM.1750-68FA120/0200
The resulting outputDate/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.