Rational ClearCase Commands Referenceannotate
apropos
catcr
catcs
cc.icon
cc.magic
cd
chactivity
chbl
checkin
checkout
checkvob
chevent
chflevel
chfolder
chmaster
chpool
chproject
chstream
chtype
chview
clearaudit
clearbug
cleardescribe
cleardiffbl
cleardiff
clearexport_ccase
clearexport_cvs
clearexport_pvcs
clearexport_rcs
clearexport_sccs
clearexport_ssafe
clearfsimport
cleargetlog
clearhistory
clearimport
clearjoinproj
clearlicense
clearmake
clearmake.options
clearmrgman
clearprojexp
clearprompt
cleartool
clearviewupdate
clearvobadmin
comments
config_ccase
config_spec
cptype
credmap
creds
deliver
describe
diffbl
diffcr
diff
dospace
edcs
endview
env_ccase
events_ccase
export_mvfs
exports_ccase
file
find
findmerge
fmt_ccase
getcache
get
getlog
help
hostinfo
init_ccase
ln
lock
lsactivity
lsbl
lscheckout
lsclients
lscomp
lsdo
lsfolder
lshistory
ls
lslock
lsmaster
lspool
lsprivate
lsproject
lsregion
lsreplica
lssite
lsstgloc
lsstream
lstype
lsview
lsvob
lsvtree
makefile_aix
makefile_ccase
makefile_gnu
makefile_pmake
makefile_smake
makefile_sun
man
merge
mkactivity
mkattr
mkattype
mkbl
mkbranch
mkbrtype
mkcomp
mkdir
mkelem
mkeltype
mkfolder
mkhlink
mkhltype
mklabel
mklbtype
mkpool
mkproject
mkregion
mkstgloc
mkstream
mktag
mktrigger
mktrtype
mkview
mkvob
mount_ccase
mount
msdostext_mode
mvfslog
mvfsstorage
mvfstime
mvfsversion
mv
omake
pathnames_ccase
permissions
profile_ccase
promote_server
protect
protectvob
pwd
pwv
query_language
quit
rebase
recoverview
reformatview
reformatvob
register
relocate
rename
reqmaster
reserve
rgy_backup
rgy_check
rgy_passwd
rgy_switchover
rmactivity
rmattr
rmbl
rmbranch
rmcomp
rmdo
rmelem
rmfolder
rmhlink
rmlabel
rmmerge
rmname
rmpool
rmproject
rmregion
rmstgloc
rmstream
rmtag
rmtrigger
rmtype
rmver
rmview
rmvob
schedule
schemes
scrubber
setactivity
setcache
setcs
setplevel
setsite
setview
shell
snapshot.conf
softbench_ccase
space
startview
type_manager
umount
uncheckout
unlock
unregister
unreserve
update
version_selector
view_scrubber
vob_restore
vob_scrubber
vob_sidwalk
vob_snapshot
vob_snapshot_setup
wildcards_ccase
winkin
xclearcase
xcleardiff
xmldiffmrg
DESCRIPTION
The view_scrubber program cleans a view's private storage area by removing data containers for derived objects (DOs). On Windows systems, view_scrubber scrubs only the files that are piped to its stdin stream. On UNIX systems, the most common way to run the view_scrubber is indirectly, by running the view_scrubber.sh script supplied with ClearCase.
Note: This command does not apply to snapshot views.
Warning: This command modifies the way in which view-resident objects are combined with VOB-resident objects to produce a virtual workspace. To avoid errors, make sure that no application or development tool is using the view's files when this command is executed.
Scrubbing is useful in the situations described in the following sections.
Cleaning Up After a Winkin
When a clearmake or omake build winks in a shareable DO for the first time, the DO's data container is copied from the private storage area of the view in which it was built to the VOB storage pool. At this point:
- The view where the DO was originally built continues to use the data container in view storage.
- Any other view to which the DO is subsequently winked in uses the data container in VOB storage.
Running view_scrubber in the view where the DO was built simplifies the situation. view_scrubber performs the following steps:
- Removes the DO with an operating system command. This deletes the data container from view storage.
- Winks in the DO to the view, which establishes a link to the data container in VOB storage.
Now, all views that share the DO access the data container in VOB storage, which eliminates the redundant, space-consuming data container in view storage.
Self-Winkin
By default, the data container for a nonshareable DO or an unshared DO remains in view storage until the DO is deleted or overwritten. view_scrubber –p transfers the data container to VOB storage, thus freeing space in the view storage area. In essence, this involves winking in the DO to the same view. view_scrubber –p performs the following steps:
- (Nonshareable
DO only) Converts the DO to a shareable DO by writing information about the
DO into the VOB.
If the DO has any sub-DOs or siblings, view_scrubber –p or view_scrubber –a makes them shareable. view_scrubber –a stops after this step is complete. view_scrubber –p executes the following additional steps:
- Promotes the data container from view storage to VOB storage.
- Removes the DO with an operating system command, which deletes the data container from view storage.
- Winks in the DO to the view, which establishes a link to the data container in VOB storage.
You can also use the winkin command to accomplish this scenario.
Note: When a nonshareable DO is converted to a shareable DO, its DO ID changes. For more information, see Building Software.
OPTIONS AND ARGUMENTS
Advertising and Promotion
- Default
- view_scrubber removes
view-resident data containers, then restores the derived objects to the view
through winkin. Requirement: The derived objects' data
containers must already be in VOB storage.
- –a
- Before performing the default processing
described above, writes information about the DO to the VOB to advertise its
availability for winkin, but does not copy the DO to the VOB.
- –p
- Before performing the default processing
described earlier, writes information about the DO to the VOB to advertise
its availability for winkin, then promotes (copies) the derived objects' data
containers from view storage to VOB storage. This removes the requirement
that the data containers be in VOB storage. (view_scrubber –p implies
execution of view_scrubber –a.)
Error Recovery
No-Execute Option
EXAMPLES
- On a UNIX system, make the view to be scrubbed the current working view, and move to the directory of interest. Then scrub DO containers for the entire directory tree, using the script ccase-home-dir/etc/view_scrubber.sh (which invokes the view_scrubber program).
- On a Windows system, make the view to be scrubbed the current working view, and move to the directory of interest. Then scrub DO containers for the entire directory tree, using a pipe.
- Scrub two DOs, promoting the data containers to VOB storage.