EnableNewSnap

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:

EnableNewSnap DcsSnap{relationship#}

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:

 relationship# :  A value that represents the snapshot relationship number.

For example: EnableNewSnap DcsSnap1

Return Value:

0:  success.

-1:  failure. Call the GetLastErrors command 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:

You can use the GetSnapStatus command or the GetSnapExtendedStatus command to verify the success of this command.

You can use the DisableSnap command to disable the snapshot relationship.

EnableNewSnap