rmpool
Removes a VOB storage pool
SYNOPSIS
- rmpool [ –c·omment comment | –cfi·le comment-file-pname | –cq·uery
- | –cqe·ach | –nc·omment ] pool-selector ...
DESCRIPTION
The rmpool command deletes
one or more storage pool directories from a VOB, along with all the data container
files stored within them.
Reassigning Elements
Before removing a storage pool, you must
reassign all its currently assigned elements to a different pool, using the chpool command. Otherwise, rmpool aborts
with an elements using pool error. To list
all the elements in a source or cleartext pool, use a find command.
For example
This command does not work with derived object
pools.
Deleting Derived Object Pools
There is no way to move a shared derived
object from one pool to another. Thus, you can delete a derived object pool
only if either condition is true:
- No
directory elements have been assigned to the pool.
- All
data containers in the pool have been removed by the scrubber program
or rmdo commands, and each directory element
that currently uses the pool has been assigned to a different derived object
pool.
RESTRICTIONS
Identities
You must have one
of the following identities:
- Pool
owner
- VOB
owner
- root (UNIX)
- Member
of the ClearCase administrators group (Windows)
Locks
An error occurs if one
or more of these objects are locked: VOB, pool.
Mastership
(Replicated VOBs
only) No mastership restrictions.
OPTIONS AND ARGUMENTS
Event Records and Comments
- Default
- Creates one or more event records, with commenting
controlled by your .clearcase_profile file (default: –nc).
See the comments reference page. Comments
can be edited with chevent.
- –c·omment comment | –cfi·le comment-file-pname |–cq·uery | –cqe·ach | –nc·omment
- Overrides the default with the option you
specify. See the comments reference
page.
Specifying the Pools to Be Removed
- Default
- Removes a pool from the VOB containing the
current working directory unless you specify another VOB with the @vob-selector suffix.
- pool-selector ...
- One or more names of existing storage pools.
Specify pool-selector in the form [pool:]pool-name[@vob-selector]
EXAMPLES
The UNIX examples in this section are written for use in csh.
If you use another shell, you may need to use different quoting and escaping
conventions.
The Windows examples that include wildcards or quoting are written for
use in cleartool interactive mode. If you use cleartool single-command
mode, you may need to change the wildcards and quoting to make your command
interpreter process the command appropriately.
In cleartool single-command mode, cmd-context represents
the UNIX shell or Windows command interpreter prompt, followed by the cleartool command.
In cleartool interactive mode, cmd-context represents
the interactive cleartool prompt.
- Change
all elements using the c_source_pool to use the default
source pool (sdft) instead. Then, delete c_source_pool.