The IBMTSSVC_StorageConfigurationService class provides
the methods for establishing a FlashCopy® relationship
between two IBMTSSVC_StorageVolume instances and then adding it to
an IBMTSSVC_FlashCopySynchronizedSet instance.
Perform the following steps to create a FlashCopy relationship
between two IBMTSSVC_StorageVolume instances and add it to an IBMTSSVC_FlashCopySynchronizedSet
instance:
- Select an IBMTSSVC_StorageVolume instance as the source
volume for the desired FlashCopy relationship.
- Select a valid IBMTSSVC_StorageVolume as a target. Valid
volumes can be determined using IBMTSSVC_CandidateVolume.
Make
sure that the source IBMTSSVC_StorageVolume and target IBMTSSVC_StorageVolume
instances belong to the same IBMTSSVC_Cluster instance.
- Retrieve the IBMTSSVC_StorageConfigurationService instance
that is associated with the IBMTSSVC_Cluster instance to which the
selected IBMTSSVC_StorageVolume instances belong.
- Invoke the IBMTSSVC_StorageConfigurationService.AttachReplica()
method with the following parameter specifications:
- Set SourceElement to the reference (CIMObjectPath) of
the source IBMTSSVC_StorageVolume.
- Set TargetElement to the reference (CIMObjectPath) of
the target IBMTSSVC_StorageVolume.
- Optionally set ElementName to the name of the synchronization.
- Optionally set BackgroundCopyRate to the desired priority
of the background copy rate in percent (0 - 100%).
- Optionally specify Set to add the newly created FlashCopySynchronization
to the set. If you specify a null value, the newly created FlashCopySynchronization
will not be a member of a synchronized set.
- Optionally set CopyType to 5. This sets AutoDelete to
true, which automatically deletes the FlashCopy mapping after the
background copy is complete.
- If you do not want to automatically delete FlashCopy
mappings, Set CopyType to 4.
- Create an IBMTSSVC_FlashCopySynchronizedSet instance by
invoking the IBMTSSVC_StorageConfigurationService.CreateSynchronizedSet()
method with the following parameter specifications:
- Set CopyType to 4 (flash).
- Optionally set ElementName to the name of the newly
created IBMTSSVC_FlashCopySynchronizedSet instance.
- Add the IBMTSSVC_FlashCopyStorageSynchronized instance
to the IBMTSSVC_FlashCopySynchronizedSet instance by invoking the
IBMTSSVC_StorageConfigurationService.ModifySynchronizedSet() method
with the Operation parameter set to 0 (add). If the FlashCopy Added
to the Set is CopyType 5, the Set becomes CopyType 5, and any other
FlashCopy mappings that are added to the Set must have CopyType 5
or the add fails. Similarly, if a Set contains a FlashCopy of CopyType
4, all other FlashCopy mappings in the set must be of CopyType 4 or
the Modify fails.
The synchronization must belong to
the same cluster as the hosting service.