ClearCase Reference Manual, Release 4.0, Windows

chpool

Changes the storage pool to which an element is assigned

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

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; he 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@@

PERMISSIONS AND LOCKS

Permissions Checking: For each object processed, you must be one of the following: VOB owner, member of the ClearCase group. See the permissions reference page.

Locks: An error occurs if any of the following objects are locked: VOB, element type, element, pool.

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 CUSTOMIZING COMMENT HANDLING in 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]

pool-name

Name of the storage pool

See the Object Names section in 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. 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

Examples including 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 command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace 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".