chpool

Changes the storage pool to which an element is assigned

Applicability

Product

Command type

VersionVault

cleartool subcommand

Platform

UNIX

Linux

Windows

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 path names 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 path name:

cmd-context describe msg.c@@

Restrictions

Identities

You must have one of the following identities:

  • VOB owner
  • root (UNIX and Linux)
  • Member of the VersionVault administrators group (VersionVault 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 .versionvault_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-selector

pool-name

Name of the storage pool. For rules about composing names, see the cleartool reference page.

vob-selector

VOB specifier. Specify vob-selector in the form [vob:]pname-in-vob

pname-in-vob

Path name 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 path names, each of which specifies a file or directory element. A standard path name 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 system and Linux examples in this section are written for use in csh. If you use another shell, you might 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 might 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 system and Linux shells 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".