IPnom Home • Manuals • ClearCase

 Rational ClearCase Commands Reference

ClearCase Stuff:ClearCase LinksClearCase BooksClearCase Commands ReferenceClearCase ForumsClearCase News
Keyword Live Search (10 results max):
 Type in part of a ClearCase command in the search box.
Commands Index:


Changes the storage pool to which an element is assigned


ProductCommand type
ClearCasecleartool subcommand



chpool [ –f·orce ] [ –c·omment comment | –cfi·le comment-file-pname
| –cq·uery | –cqe·ach | –nc·omment ]
pool-selector pname ...


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:

cmd-context describe msg.c@@ 



You must have one of the following identities:

  • VOB owner
  • root (UNIX)
  • Member of the ClearCase administrators group (ClearCase on Windows)


An error occurs if one or more of these objects are locked: VOB, element type, element, pool.


(Replicated VOBs only) No mastership restrictions.


User Interaction

Prompts for confirmation before moving data containers.

Suppresses the confirmation step.

Event Records and Comments

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


An existing storage pool. Specify pool-selector in the form [pool:]pool-name[@vob-selector]
pool-name Name of the storage pool. See the cleartool reference page for rules about composing names.
vob-selector VOB specifier. Specify vob-selector in the form [vob:]pname-in-vob
 pname-in-vob Pathname of the VOB-tag (whether or not the VOB is mounted) or of any file-system object within the VOB (if the VOB is mounted).

Specifying the Elements


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.)


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.

    cmd-context chpool –force cltxt2 *.c 
    Changed pool for "cm_add.c" to "cltxt2".
    Changed pool for "cm_fill.c" to "cltxt2".
    Changed pool for "convolution.c" to "cltxt2".
    Changed pool for "msg.c" to "cltxt2".
    Changed pool for "test_cmd.c" to "cltxt2".
    Changed pool for "util.c" to "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.

    cmd-context chpool c_pool src 
    Changed pool for "src" to "c_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.)

    cmd-context chpool sdft hello.c 
    Move all versions of element "hello.c"? [no] yes
    Changed pool for "hello.c" to "sdft".



ClearCase Links • ClearCase Books • ClearCase Commands Reference • ClearCase Forums • ClearCase News