chpool
Changes
the storage pool to which an element is assigned
SYNOPSIS
- chpool [ –f·orce ]
[ –c·omment comment | –cfi·le comment-file-pname
- | –cq·uery | –cqe·ach | –nc·omment ]
pool-selector pname ...
DESCRIPTION
The chpool command changes
the source storage pool, derived object storage pool, or cleartext storage
pool to which one or more elements are assigned.
For a file element:
- Changing
the source pool moves the data containers that store all existing versions
from the current pool to the specified pool.
- Changing
the cleartext pool designates a different location for new cleartext versions.
Existing cleartext versions remain where they are and are eventually scrubbed.
(See the scrubber reference page.)
- An
error occurs if you attempt to assign a file element to a derived object pool;
file elements have source and cleartext pools only.
For a directory element:
- Changing
the source pool or the cleartext pool affects pool inheritance by new elements.
Elements created within the directory are assigned to the new pool; the pool
assignments of existing elements do not change.
- Changing
the derived object pool designates a new location for shared derived objects
with pathnames in that directory. The promote_server program
copies data containers to the new pool; the existing contents of the old pool
do not change, and are eventually deleted by scrubber.
Commands for Listing Pools
The lspool command
lists a VOB's storage pools. The describe command
includes storage pool assignments in its listing for an element. To reference
an element (rather than one of its versions), append the extended naming symbol
to the element's standard pathname:
RESTRICTIONS
Identities
You must have one
of the following identities:
- VOB
owner
- root (UNIX)
- Member
of the ClearCase administrators group (ClearCase on Windows)
Locks
An error occurs if one
or more of these objects are locked: VOB, element type, element, pool.
Mastership
(Replicated VOBs
only) No mastership restrictions.
OPTIONS AND ARGUMENTS
User Interaction
- Default
- Prompts for confirmation before moving data
containers.
- –f·orce
- Suppresses the confirmation step.
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 Pool
- Default
- None.
- pool-selector
- An existing storage pool. Specify pool-selector in
the form [pool:]pool-name[@vob-selector]
Specifying the Elements
- Default
- None.
- pname ...
- One or more pathnames, each of which specifies
a file or directory element. A standard pathname is valid; you do not need
to append the extended naming symbol. (Specifying a version or a branch is
generally equivalent to specifying its element.)
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.
- Reassign
all elements in the current directory that have a .c extension
to cleartext pool cltxt2.
- Change
the default source pool for the src directory, so that
new elements created in this directory are assigned to the c_pool pool.
- Change
the source pool for hello.c to sdft,
the VOB's default source pool. (Assumes the element had been assigned to a
different pool.)