TERMINATE
Discards a created or activated snapshot.
For the TERMINATE command to function properly, no target devices can be linked to the snapshot, unless AUTO_UNLink is specified.
When AUTO_UNLink is specified, SnapVX unlinks all target devices from the snapshot.
The TERMINATE command does not terminate TimeFinder/Clone hardlinked snapshots.
NOTE: For information about space considerations upon TERMINATE, see
Freeing tracks .
Syntax
TERMinate
(
NAME({snapshot_name |*})
SOUrce
({
VOLume(volser )|
UNIT({cuu |lowcuu-highcuu |lowcuu:highcuu |cuu (count )})|
SYMDV#({symdv# |lowsymdv#-highsymdv# |lowsymdv#:highsymdv# |symdv# (count )})|
SCFGroup(gnsgrp )
})
[optional_parameters ]
)
Where
optional_parameters are:
[AUTO_UNLink ({Yes|No}) The default value is No.
[CHECKBCVHoldstatus ({Yes|No})] The default value is Yes.
[FREE ({Yes|No})] The default value is No.
[WAIT_FOR_Definition ({Yes|No})]] The default value is Yes.
[GROUP (grpname [,grpname ,...])]
[LOCAL ({
UNIT(cuu ) [CONTROLLER({[xxxxxxx- ]xxxxx |name })]|
VOLUME(volser ) [CONTROLLER({[xxxxxxx- ]xxxxx |name })]|
DDNAME(ddname ) [CONTROLLER({[xxxxxxx- ]xxxxx |name })]|
CONTROLLER({[xxxxxxx- ]xxxxx |name })
})]
[REMOTE (RAGROUP(nn.nn.nn.nn )
{UNIT(cuu ) [CONTROLLER({[xxxxxxx- ]xxxxx |name })]|
VOLUME (volser ) [CONTROLLER({[xxxxxxx- ]xxxxx |name })]| DDNAME(ddname ) [CONTROLLER({[xxxxxxx- ]xxxxx |name })]})]
[TERMinate_ALL ({Yes|No})] The default value is No.
Command-specific parameters
NAME({snapshot_name |*})
See
NAME . Specifying * as the
snapshot_name causes all snapshots on the specified source device to be terminated. NAME(*) cannot be specified together with TERMinate_ALL(Yes).
Example
TERM ( -
NAME(TESTSNAPSHOT) -
SOURCE( SYMDV#(1D0) ) -
LOCAL(UNIT(6200)) -
)