Changes the storage pool to which an element is assigned
Product | Command Type |
---|---|
ClearCase | cleartool subcommand |
Attache | command |
Platform |
---|
UNIX |
Windows |
The chpool command changes the source storage pool, derived object storage pool, or cleartext storage pool to which one or more elements are assigned.
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.
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.
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@@
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.
USER INTERACTION. Default: Prompts for confirmation before moving data containers.
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.
SPECIFYING THE POOL. Default: None.
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.
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".
lspool, mkdir, mkelem, mkpool, profile_ccase, promote_server, scrubber
Feedback on the documentation in this site? We welcome any comments!
Copyright © 2001 by Rational Software Corporation. All rights reserved. |