EnableNewSnap
EnableNewSnap, GroupEnableNew, SGEnableNew, and SCSIGroupEnableNew have been deprecated. EnableNewSnap has the same function as EnableSnap and is only maintained for backward compatibility. GroupEnableNew has the same function as GroupEnable and is only maintained for backward compatibility. SGEnableNew has the same function as SGEnable and is only maintained for backward compatibility. SCSIGroupEnableNew has the same function as SCSIGroupEnable and is only maintained for backward compatibility.
Command:
EnableNewSnap { DcsSnap#}
Description:
Enable a snapshot relationship if you want to create a logical image of data that is instantly available for use, and is independent of the source volume from which it was created. Once the snapshot relationship is enabled, you can perform additional snapshot activities on it.
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_INVALID_PARAMETERS: There is a potential version mismatch between API and driver, the snapshot relationship is already enabled, or the source or destination volume is already active in a conflicting Snapshot role.
DCSPIT_ERROR_DEVICE_DOES_NOT_EXIST: The snapshot relationship does not exist.
DCSPIT_ERROR_NO_SUCH_DEVICE: Either the configured snapshot volume does not exist, or Snapshot has not yet been established on the disk partition.
DCSPIT_ERROR_OBJECT_NAME_NOT_FOUND: The configured source volume does not exist.
DCSPIT_ERROR_INSUFFICIENT_RESOURCES: Memory allocation has failed.
DCSPIT_ERROR_INVALID_VIEW_SIZE: The source volume configured for the snapshot relationship is larger than the destination volume configured for the snapshot relationship.
ERROR_INVALID_PARAMETER: hDeviceHandle is an invalid handle.
DCSPIT_ERROR_INVALID_DEVICE_REQUEST: The nEnableFlags argument conflicts either with the existing snapshot relationship configuration, or with the EnableFlags value stored within the corresponding Mapstore entry for the snapshot relationship.
DCSPIT_ERROR_SECTION_TOO_BIG: The chunk size value is too low to represent the snapshot relationship. Choose a larger chunk size value.
Comments:
EnableNewSnap has been deprecated. EnableNewSnap has the same function as EnableSnap and is only maintained for backward compatibility.
You can use GetSnapStatus or GetSnapExtendedStatus to verify the success of this command.
You can use the DisableSnap command to disable the snapshot relationship.