clearvol

The clearvol command clears Copy Services relationships for a base logical volume.

Read syntax diagramSkip visual syntax diagram
>>-clearvol--+-------------------------+--+--------------+------>
             '- -dev--storage_image_ID-'  '- -pprcsource-'   

>--+--------------+--+------------+--+------------+------------->
   '- -pprctarget-'  '- -fcsource-'  '- -fctarget-'   

>--+-Volume_ID-+-----------------------------------------------><
   '-"  -  "---'   

Parameters

-dev storage_image_ID
(Optional). Specifies the storage image ID, which consists of manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified ID for the volume ID.
Example: IBM.1750-68FA120
-pprcsource
(Optional). This parameter is used with a base logical volume. It removes any remote mirror and copy relationships on the logical volume where the specified logical volume operates as a remote mirror and copy source.
-pprctarget
(Optional). This parameter is used with a base logical volume. It removes any remote mirror and copy relationships on the logical volume where the specified logical volume operates as a remote mirror and copy target.
-fcsource
(Optional). This parameter is used with a base logical volume. It removes any FlashCopy relationships on the logical volume where the specified logical volume operates as a FlashCopy source.
-fctarget
(Optional). This parameter is used with a base logical volume. It removes any FlashCopy relationships on the logical volume where the specified logical volume operates as a FlashCopy target.
Volume_ID | -
(Required). Specifies the volume ID where Copy Services relationships are to be cleared. This parameter accepts a fully qualified volume ID, which includes the storage image ID or a shortened version, if the -dev parameter is specified. The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ where X is the address group (0 - 1), XY together is the logical subsystem number 00 - 1E (for 1750) , and ZZ is the volume number (00 - FF).
If you specify the dash (-), this parameter information is automatically supplied.
Example: IBM.1750-68FA120/0001

Example (1750)

Invoking the clearvol command
dscli>clearvol -dev IBM.1750-68FA120 0001
The resulting output
Date/Time: Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 
DS:  IBM.1750-68FA120

Volume 0001 successfully cleared.
Related reference
lsckdvol
showckdvol
lsfbvol
showfbvol
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.