GroupEnable

Command:

GroupEnable SnapshotGroup

Description:

This command is used to enable a group of existing snapshot relationships. 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 relationships are enabled, you can perform additional snapshot activities on them.

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:

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.

GroupEnable