GroupEnableNew
EnableNewSnap and GroupEnableNew have been phased out. 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.
Command:
GroupEnableNew SnapshotGroup
Description:
This command is used to enable a group of existing snapshot relationships if there is a Mapstore configured with them and you would like to ignore the Mapstore’s capabilities. (Otherwise, use the GroupEnable command.) Enable a snapshot relationship if you want to create an image of data that is instantly available for use, 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:
SnapshotGroup: A valid snapshot group name.
Return Value:
0: success.
-1: failure (see the Comments section below).
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 of the snapshot relationship is larger than the destination volume of 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:
GroupEnableNew has been deprecated. GroupEnableNew has the same function as the GroupEnable command and is only maintained for backward compatibility.
You can use the GroupGetStatus command to verify the success of this command. To discover why the command may have failed, use the GetLastErrors command.
You can use the GroupDisable command to disable the snapshot relationship group.