GroupFreeDestNMVBlocks
Command:
GroupFreeDestNMVBlocks SnapshotGroup
Description:
Perform this command on a snapshot relationship group whose destination volumes are NMVs to free NMV storage units allocated to that NMV destination volume. This command should be used after disabling, and before re-enabling the snapshot relationship group.
(e.g., If you previously performed a Complete Image on the group and now you want to re-enable it, perform this command before performing the enable to clear the used NMV data blocks from the destination volumes.)
Arguments:
SnapshotGroup: A valid snapshot group name.
Return Values:
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, or one or more snapshot relationships are currently enabled.
DCSPIT_ERROR_DEVICE_DOES_NOT_EXIST: At least one snapshot relationship in the group does not exist.
DCSPIT_ERROR_NO_SUCH_DEVICE: Either a Snapshot-configured volume does not exist, or Snapshot has not yet been established on a disk partition.
DCSPIT_ERROR_INSUFFICIENT_RESOURCES: Memory allocation has failed.
ERROR_INVALID_PARAMETER: hDeviceHandle is an invalid handle.
DCSPIT_ERROR_INVALID_DEVICE_REQUEST: At least one snapshot relationship destination volume in the snapshot group is not an NMV.
DCSPIT_ERROR_DEVICE_BUSY: The NMV is still reclaiming allocated chunks and the NMV destination volumes should not be used until a subsequent call of this CLI command returns successfully. Continue to re-issue the command until a successful status is returned.
Comments:
A successful return from this command indicates that all snapshot relationship destination volumes are NMVs and that the associated NMV pools have enough free blocks for the NMVs to be used.
This command is applied to all snapshot relationships in the group, but can only be successful on the snapshot relationships that are currently disabled.
This command has no effect on snapshot relationship destinations created from partition-based volumes.