ClearCase Reference Manual, Release 4.0, Windows

lspool

Lists VOB storage pools

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

lspool [ -l·ong | -s·hort | -fmt format-string ] [ -obs·olete ]: [ -inv·ob vob-selector | pool-selector ... ]

DESCRIPTION

The lspool command lists information about one or more VOB storage pools. This listing does not include the elements assigned to the pool; use the find command for this purpose. For example:

cmd-context find M:\view1\vob1\include -element 'pool(src_pool_2)' -print

Obsolete Storage Pools

Storage pools can be rendered obsolete with the lock -obsolete command. The obsolete/nonobsolete status of a pool affects some forms of this command.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions required. Locks: No locks apply.

OPTIONS AND ARGUMENTS

LISTING FORMAT. Default: A storage pool listing looks like this:

20-Nov-1999 drp pool "cdft"

-l·ong: Expands the listing to pool parameters and pathnames.

-s·hort: Restricts the listing to pool names only.

-fmt format-string: Lists information using the specified format string. See the fmt_ccase reference page for details on using this report-writing facility.

LISTING OBSOLETE POOLS. Default: If you don't specify any pool-name argument, a VOB's obsolete pools are suppressed from the listing.

-obs·olete: Includes obsolete pools in the listing when you don't specify any pool-name argument. Has no effect if you specify one or more pool-name arguments.

SPECIFYING THE POOLS. Default: Lists all storage pools in the VOB containing the current working directory.

-inv·ob vob-selector: The VOB whose storage pools are to be listed. 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).

pool-selector ...: One or more names of storage pools to be listed. A pool is listed whether or not it is obsolete. Specify pool-selector in the form [pool:]pool-name[@vob-selector]

`pool-name`	Name of the storage pool
`vob-selector`	Object-selector for a VOB, in the same format as -invob.

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.

List all storage pools for the VOB containing the current working directory.

cmd-context lspool

08-Dec.12:1 jackson pool "c_pool" "pool for c source files" 15-Dec.09:34 jenny pool "cdft" "Predefined pool used to store cleartext versions." 08-Dec.12:21 jackson pool "cltxt2" 15-Dec.09:34 jenny pool "ddft" "Predefined pool used to store derived objects." 08-Dec.12:21 jackson pool "do1" 08-Dec.12:21 jackson pool "my_ctpool" "alternate cleartext pool" 15-Dec.09:34 jenny pool "sdft" "Predefined pool used to store versions." 08-Dec.12:19 jackson pool "staged"

List information about a particular storage pool, in long format.

cmd-context lspool -long do1

pool "do1" 08-Dec-99.12:21:13 by jackson.dvt@oxygen owner: jackson group: dvt kind: derived pool pool storage global pathname "P:\vbstore\tut\tut.vbs\d\do1" maximum size: 10000 reclaim size: 8000 age: 168

List a particular storage pool, verifying that it is obsolete.

cmd-context lspool -short cltxt2

cltxt2 (obsolete)