chpool

Changes the storage pool to which an element is assigned

APPLICABILITY

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

RESTRICTIONS

Identities: You must have one of the following identities:

• VOB owner

• root (UNIX)

• Member of the ClearCase 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]

pool-name	Name of the storage pool See the 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

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

SEE ALSO

lspool, mkdir, mkelem, mkpool, profile_ccase, promote_server, scrubber