lspool

Lists VOB storage pools

APPLICABILITY

ProductCommand type
ClearCasecleartool subcommand

Platform
UNIX
Windows

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 /vobs/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.

RESTRICTIONS

None.

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

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.

  • 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
     owner: jackson
     group: dvt
     kind: derived pool
     pool storage link target pathname “/net/oxygen/usr1/vob_pools/tut/d/do1
     pool storage global pathname "/net/oxygen/usr/vobstore/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)

SEE ALSO

chpool, mkpool



Copyright© 2003 Rational Software. All Rights Reserved.