lspool

Lists VOB storage pools

APPLICABILITY

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

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.

• 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