StartCompleteImage
Command:
StartCompleteImage (DcsSnap#)
Description:
This command is used to begin the Complete Image process on a particular snapshot relationship. Perform the Complete Image process on a snapshot relationship to create a physical copy of the source volume data on the destination volume.
Arguments:
DcsSnap# : A value that represents the snapshot relationship number.
Return Value:
0: success.
-1: failure. Call GetLastErrors for extended error code information.
Error Codes:
DCSPIT_ERROR_CANCELLED: The process was terminated by using the StopCompleteImage command.
DCSPIT_ERROR_INVALID_PARAMETER: There is either a potential version mismatch between API and driver, or the snapshot is not enabled.
DCSPIT_ERROR_DEVICE_DOES_NOT_EXIST: The snapshot does not exist.
ERROR_INVALID_PARAMETER: hDeviceHandle is an invalid handle.
Comments:
If you want to monitor the progress of the process, you can use GetSnapStatus or GetSnapExtendedStatus to verify that the process is still active.
If the Complete Image process is stopped, re-starting the process will start the data replication where it left off. When the process is re-started, it will return immediately.
If you had a Complete Image, a complete physical copy of source volume data on the destination volume, prior to performing the Image Update process on a snapshot relationship, and you want to re-establish the complete image, you must perform this function, once the Image Update process has completed.
The source and destination volumes can be active while the Complete Image process is performed.