07/12/2015
ClearcaseCommands:
ClearcaseClientCommands:
ThistutorialcoverstheIBM/RationalClearcasecommandsusedfortheClearcasechangemanagementsystem.
ForinstallationoftheIBM/RationalClearcaseClientonLinuxseeYoLinuxClearcaseClientInstallationTutorial
ForInstallationoftheIBM/RationalClearcaseServeronLinuxseeYoLinuxClearcaseServerInstallationTutorial
search
Search
|HomePage|LinuxTutorials|Terms|PrivacyPolicy|Advertising|Contact|
ClearcaseUserCommands:
Configureuseraliases:
File:$HOME/.bashrc
File:$HOME/.cshrc
aliasct=/usr/atria/bin/cleartool
aliassv='/usr/atria/bin/cleartoolsetview'
umask022
aliasct/usr/atria/bin/cleartool
aliassv'/usr/atria/bin/cleartoolsetview'
umask022
Thisumaskwillsetthedefaultprivilegesonnewfilesanddirecotries.Defaultprotectionwillbesetsothattheusermaywritedatabut
otherscanread.
Commands:
ClearCaseCommand
ctver
Description
DisplayClearcase,cleartool,db_serverandVOBdatabaseschemaversion.
ctlsvob
Listvobmounttable:
*/vob/VOBNAME.vbt/hosts/hostname/r1vob/vobs/vobstore/VOBNAME.vbspublic
*/vob/practice_vob.vbt/hosts/hostname/viewname/Vobs/vobstore/practice_vob.vbspublic
ctdumpelementorDO
ctlsview
PrintinternalClearcaseinfo.
Listallviews:
millesc_view/hosts/hostname/viewname/Views/millesc_view.vws
*username/hosts/hostname/viewname/Views/reg_view.vws
ctlsviewviewtag
ctmktagviewtagdynamicviewname
nstart/hosts/node
name/home/cleardata/views/dynamic
viewname
Listviewpath.
CreateaviewtagorVOBtag.
or
ctmktagvobvobtag...
ctmkviewtaguser1_viewstgloc
viewstore
Createanewviewin"viewstore"Clearcaseserverviewmountpoint(seeYoLinuxclientor
serverinstallationtutorial).
Listviewstoragelocations:ctlsstgloc
ctmkviewtagtmpA_view/hosts/node
name/home/cleardata/views/tmpA_view
Createanewview.
ctsetviewusername_view
ctstartviewcommon_view
Setcurrentviewtousername_view.
Setcurrentviewtocommon_viewwithoutstartingaClearcaseshellenvironent.Itallowsoneto
view(only)thefiles.Path:/view/common_view/vob/vobname/...
ctendviewcommon_view
ctendviewserverusername_view
DeactivateaClearcaseview.(Firstexitview)
UsefulifyougetstaleNFShandles.
ctrmviewtagtemp_view
or
ctrmviewtemp_view
Removeviewtemp_view.
cleartoolsetviewusername_view
svusername_view
SetClearcaseview.Seealiasdefinedabove.
ctpwv
Printworkingview/currentview:
Workingdirectoryview:username_view
Setview:username_view
echo$CLEARCASE_ROOT
ctlsl
ctlsvob_only
Printcurrentviewpath.
Usingcurrentview,showfiles,privatefiles,fileversionandrule.
vob_only:Listelementsandnotderivedobjects
Format:
...
versionfile.ext@@/main/2Rule:element*/main/LATEST
directoryversionDirectoyname@@/main/2Rule:element*/main/LATEST
viewprivateobjectfile2.c
...
ctlstypekindlbtypelistlabels
http://www.yolinux.com/TUTORIALS/ClearcaseCommands.html
1/11
07/12/2015
ctlsvtreeallfilename.ext
ClearcaseCommands:
Listlabels
Listfileversionlabelandbuildlabel:(versiontree)
filename.ext@@/main
filename.ext@@/main/0
filename.ext@@/main/1(BUILD_1_0)
filename.ext@@/main/2(BUILD_1_1)
Listfileversionlabelandbuildlabelforfilesbeginningwith"pref"
Listfileordirectoryversionhistory.
Listeventrocordsforagivenfile.
ctcheventc'newcommentgoeshere' Changethecommentonaversionofanelement.
replaceeventeventid
Lookupeventid:ctlsheventfileorelement
ctlsvtreeallpref*
ctlshistory[all]fileordirectory
ctlshistoryfilename
ctcheventc'newcommentgoeshere'
replacelbtypelabel
Changethecommentonalabel.
ctlsco
ctlscor
ctlscoavobsme
ctlscoavobscview
Listallcheckedoutfilesincurrentdirectory.
Flag"r"recusivlylooksinsubdirectories.
Listallfilescheckedouttoallviews.
Listcheckoutsinview.
Listcheckedoutfiles.
(same)
Listfilesincurrentdirectoryandsubdirectoriescheckedouttoyouincurrentview.Omitcview
tagtogetall.
Listconfigurationrecordforafile.
ctlscheckoutl
ctlscol
ctlscorecursivemecview
ctcatcrfilename
ctfind./branch'brtype(branch
name)'print
ctfind./version(main/LATEST)&&\!
version(LABEL_X)'print
Listfilesinbranchwithsearchnameorattribute.
Listfileswithlabel"LATEST"butnotLABEL_X.
ctlsprivate
ctlspco
Listallprivatefilesincurrentview.ViewprivatefilesarefilesresidingintheClearcase
filesystembutnotunderthecontrolofClearcase.i.e.objectfilesasaresultofacompile.May
notbeviewablebyothers.
Listfilescheckedouttocurrentview.
Createalabeltobeusedlater.
ctfindavobsnxnameelement
'brtype(view_name)'print
ctmklbtypencLABEL_NAME
ctmklbtypec"comment"LABEL_NAME
ctlstypekindlbtypeshort|sort
ctdescribelfile.ext
ctdescribefileordirectory
Listlabels.
DescribeobjectinVOB.Listsbranchandversionoffileandconfigspecusedinview.
Listfileordirectoryinformation.
ctdescribelongelement:fileor
directory
Listfileordirectoryinformation.
ctdescribelongvob:/vob
Listvobinformation.
Applylabeltoafile.
Labelelementsindirectorytree.
ctmklabelLABEL_NAMEfilename.ext
ctmklabelrLABEL_NAME
ctmklabelreplaceNEW_LABEL_NAME
filename.ext@@/main/4
Applylabeltoanewerversionofthefile.
ctrmtypermallforce
lbtype:LABEL_NAME
ctrmtypelbtypermallLABEL_NAME
Removealabelofthenamegiven.Theoption"rmall"causestheremovalofallinstancesof
thelabelonallfiles/directories.Removelabeltypeandalloccurrencesofthelabel.
ctrmtypelbtype:LABEL_NAME
ctrmtypermallbrtypebranchtype
ctfindavobsversion"lbtype
(BuildLabel)"print
ctfind.name'*.[hc]'element
'lbtype_sub(LABEL_NAME)'print
ctconcfilename
ctmkdirdirectoryname
RemovelabelfromClearcase.Itwillnotberemovediflabelhasbeenapplied.Useoption"
rmall"toremovelabelandallinstancesofitsapplication.
Removebranchandallfiles/directoriesinbranchfromClearcase.Datadisposedin"lost
found".
Printallfilesandfileversionsgoingintobuildspecified.
listall.hand.cfileswhiththegivenlabel.
CheckOutfile(RCScommand)NoComment
Createadirectory.Checkoutparentdirectoryfirst.
ctlnssourcedirectorynamelocal
directoryname
Createasymboliclinktoadirectory.Checkoutparentdirectoryfirst.
ctmkelemcincfilename
AddfiletoClearcasecontrol.
ctrmelemfilename
RemovefilefromClearcasecontrol.Allhistoryandknowledgeoftheelementiscompletely
removed.Bycontrast,the"ctrm"commandwillremovethefileandnotthehistoryandthe
directorymustbecheckedoutinordertomakethischange.
RemovefilefromClearcasecontrolandremoveprivateviewfile.
Removedirectory,revisionhistoryanditscontentsfromClearcasecontrol.
ctrmelemrmfilename
ctrmelemdirectoryname/*
ctrmverfilename@@/main/LATEST
or
ctrmverfilename
or
RemovelatestversioncheckedinofthefilefromClearcase.Secondexampleremovesversion
22fromtheClearcasechangemanagementsystem.Previousversionswillbeavailablefrom
thearchive.
ctrmverfilename@@/main/22
orremovespecifedversiononmain
branch:
ctrmverforcexlabelver/main/22
fileorelementname
ctrmfilename
RemovefilefromClearcaseview.Firstperformacheckout("ctco")ofthefileanddirectory.
Pastversionswillbeavailablefromthearchivealthoughnotvisibleincurrentview.Saferthan
http://www.yolinux.com/TUTORIALS/ClearcaseCommands.html
2/11
07/12/2015
ctreservefilename
ctuncofilename
ctuncormfilename
ctuncheckoutfilename
ctcounrncfilename
ctcheckoutunreservedfilename
ctcifilename
ctdiffgraprefilename&
ctdiffpredfilename
ctxdiffpredfilename
ctmvfilename_Afilename_B
ctprotectrchmod775directoryor
filename
ClearcaseCommands:
"ctrmelem"whichremovesallknowledgeofthefileoldandnew.
Lockfile.Convertunreservedcheckouttoreserved.
UNCheckOutfile.Cancelacheckoutofafile.
Cancelacheckoutofafileandremovefilewhichwascheckedout.Notremovedfrom
Clearcase,justviewprivatethecheckedoutfileisdeleted/cleanedup.
Checkoutfileeventhoughfileischeckedoutbyanother.Checkout"unreserved",mustbe
mergedatalatertime.
Notlocked.Checkouttoread,print,etc.Sameasabovecommand.
CheckInfile.(alsoctcheckinfilename)Entercomment,enter"."assolecharacteronlineand
enter.
GraphicalDiff/Mergetool.
Clearcasediffbetweencurrentfileandpredecessor.
Xwindowsdiffwithpredecessor.
Renameafile.Besuretocheckouttheparentdirectoryfirst.Ifmovingfiletoanewdirectory,
checkoutthetargetdirectoryaswell.
Setdirectory/file/elementprotection.
Configspeccommands
ctcatcs
Printrulesofcurrentview(configspec):
ctcatcstagview_tag
element*CHECKEDOUT
element*/main/LATEST
ctedcs
Lookattheconfigspecassociatedwithanotherview.
Editcurrentrulesofview(configspec):
Changefrom:
element*CHECKEDOUT
element*/main/LATEST
To:
element*BuildLabel
elementdirectory*/main/Latest
Closevi:wq
Setconfigspecforview"username_view"?[yes]
ctsetcsdefault
ctsetcscur
ctupdateadd_loadrules
Resettodefaultviewrules.
Reevaluatecurrentconfigspec.
Updateselemetsinsnapshotview.GUItool.ReevaluatesconfigspecandreselectsVOB
elementstoshow.Theoption"add_loadrules"allowsyoutoloadrulestoyourconfigspecand
loadelementswhichsatisfytherules.
HelpandInformationcommands
ctmanclearcasecommand
ctmanenv_ccase
ctapropossearchword
cthelp
cthelpclearcasecommand
ManpageforClearcasecommand.
ListClearcaseenvironmentvariables.
ListcommandsandmanpagesummariesforrelatedClearcasecommand.
Helpfacility(simple).Listspossiblecommandarguments.
Tree/Branchcommands
ctlstypekindbrtype
ctlstypekindbrtypeinvob
/vob/vobname
Listallbranches.
Listallbranchesinthevobspecified.
ctfindavobsversion
'brtype(branchtype)'print
FindallfilesofthespecifiedbranchnameinallmountedVOB's.Findbranchnamewiththect
lstypecommand..
ctlsvtreeall*
ctlsvtreefilename
ctlsvtreegfilename
Listversiontrees(labelsandbranches)offiles(eventhosewithoutlabelsorbranches).
Listallbranchesofspecifiedfile.
LaunchGUIdisplayandshowversiontree(labelsandbranches)foragivenfile.
([PotentialPitfall]:YoumayhavetoissuethecommandexportLANG=CpriortolaunchingGUI.)
ctchtype
Changeelementtypeorrenamebranch.
Createanewbranchinversiontree.Usethecommandmkbrtypetocreatethebranchtype
(name)first.Thiscommandalsochecksoutthefile.Theconfigspecneedstoincludethis
branchsofilecanbeviewed.
ctmkbranch
ctmkbranchncbranchnamefileto
branch.cpp
ctrmbranch
ctmkbrtype
mkbrtypec"Commentgoeshere"
branch_name
Removeabranchinversiontree.
Createanewbranchtypeobject.
ctmerge
Mergechanges/differencesofafilefromanotherbranch.
ctfindmerge
ctfindmerge./ftagVIEWTAGprint
Determineswhetheramergeisrequiredforafileinyourview.
Findfilesincurrentdirectorytreewhichneedtobemerged.Usethedescribecommandtosee
ifbranchhasbeenmerged.Ifsoitwilbestatedassuch.
DerivedObjectscommands
ctrmdo
Listderivedobjects.
Removeaderivedobject.
ctwinkin*.o*.aexecutables
Winkinaderivedobject.
ctlsdol
Admincommands
http://www.yolinux.com/TUTORIALS/ClearcaseCommands.html
3/11
07/12/2015
ClearcaseCommands:
clearexport_ffilerdirectoryname
Createfilecvt_datawhichistheresultofarecursiveexportoffilesfromgivendirectoryname..
clearlicense
Listnumberofallowableclientconnectionsandlistwhoisholdingalicense.
Releaselicensefromuserwhoisholdingalicense.
clearlicensereluser
getcache
ctgetcachemvfs
DisplayClearcasevieworMVFScacheparameters.
Troubleshootbylistingcachemisses(Cachemissesarebad).Performthiscommandonthe
serveritself.
getlog
ExamineClearcaselogfiles.
hostinfo
DisplayconfigurationdataforaClearcasehost.
lock
ctlockvob:/vob/project
ctlockbrtypeobsolete
branchtype
ctlocklbtype:LABEL_NAME
ctlockfilename.cpp
ctlocknusersuser1,user2
brtype:branchX
CommandtolockaVOB,element,branch,typeobjectorstoragepool.
Lockvobforreadonlyaccess.Disablewrite,create,delete,modify
Hidebranchpermanently.
Lockcodewithgivenlabel.
Lockafilefromuse.
Lockallusersexceptuser1anduser2onbranchX
unlock
ctunlockbrtypebranchtype
UnlockaVOBobject.
lslock
Listlocks.
lsclients
lsreplica
Listclientlistforlisenceorregistryhostserver.
ListreplicasofaVOB.
mkpool
CreateormodifyVOBstoragepool.
rmpool
RemoveastoragepoolfromaVOB.
Liststoragepools.
lspool
chpool
mkregion
rmregion
lsregion
mktrigger
rmtrigger
mktrtype
mkvob
ctmkvobtagVOBtagc"comment"
/vobpath
Changethestoragepooltowhichanelementisassigned.
RegisteranewClearcasenetworkregion.
UnregisteraClearcasenetworkregion.
ListClearcasenetworkregion.
Attachatriggertoanelement.
Removetriggerfromanelement.
Createatriggerobject.
Createandregisteraversionedobjectbase.
rmvob
ctrmvob/vobpath
RemoveaVOB.
lsvob
ListofmountedVOBs.
checkvob
FixinconsistanciesbetweenVOBdatabaseandstoragepools.
protectvob
ChangeownerorgroupofaVOB.
UpdatetheformatofaVOB.Usecommand"ctver"tofindthecurrentVOBdatabaseschema
version.
RemoveaVOBtagfromastorageregistry.
reformatvob
rmtag
complete_migration
mount
ctmountVOBtag
TakeVOBoutofmigrationmode.
ActivateaVOB.
unmount
ctumountVOBtag
DeactivateaVOB.
("ctdescribevob"toshowVOBinfo/owner)
register
CreateanentryintheVOB/viewstorageregistry.
unregister
RemoveaVOB/viewfromstorageregistry.
MoveelementsanddirectorytreesfromoneVOBtoanother.
relocate
rename
AsignanewnametoaClearcaseobject(i.e.pool,replica,label).Usemvtochangethename
ofafileordirectory.
setcache
ctsetcacheviewhostcachesize
1024k
ctsetcacheviewsitecachesize2m
ctsetcacheviewcachesize5m
view_tag
SetClearcasevieworMVFScacheparameters.
Setcachesizeforallviewsonserverto1024Kb.
Setcachesizeforallviewssitewideto2Mb.
setcachesizeforasinglespecifiedview.
Viewwithctlssiteinquire
mvfscache
ControlsandmonitorsMVFScaches(dynamicviewsonly).
Listsitewidepropertiesinthesiteconfigregistry.
ctlssiteinquire
setsite
Setsorunsetssitewidepropertiesinthesiteconfigregistry.
Viewcachesize
defaultsforWindowsclients
defaultsforchechinandcheckoutpreserve
space
ReportVOBdiskspaceusage.
GUItools:
/usr/atria/bin/xclearcase&
/usr/atria/bin/xcleardiff&
/usr/atria/bin/xlsvtree&(Sameasxclearcasevtree)
http://www.yolinux.com/TUTORIALS/ClearcaseCommands.html
4/11
07/12/2015
ClearcaseCommands:
[PotentialPitfall]:YoumayhavetoissuethecommandexportLANG=CpriortolaunchingGUI.
EnvironmentConfiguration:
FreeInformation
Technology
Magazinesand
Document
Downloads
Advertisements
Getshellconfigfilesamplefromnodename:/home/vobadm/config/.bashrc,.cshrc,.kshrc.
Sample$HOME/.bashrc
exportCLEARCASE=/usr/atria
...
exportPATH=$CLEARCASE/bin:$PATH
...
aliasct='cleartool'
aliassv='cleartoolsetview'
aliassvg='cleartoolsetviewusername_view'
...
MACH=`unamen`
ID=`/usr/bin/id|/usr/bin/sede's/^uid=[09]*(//'e's/).*$//'`
PS1='$MACH:($ID)$PWD>'
if[$PS1]
then
if[$CLEARCASE_ROOT]
then
exportPS1='[`basename$CLEARCASE_ROOT`]\h:(\u)\W>'
fi
fi
SampleUnixClearcasesessions:
Makechangestoafile:
nodename:(username)/home/username>cleartoolsetviewusername_view
nodename:(username)/home/username>cd/vob/vobname/src/subdirectory
[username_view]nodename:(username)subdirectory>ctconcfilename.cpp
editfile
[username_view]nodename:(username)Directorynamectcifilename.cpp
Addcommentshere.
.
exit
Commentsterminatedwithadot(.).UseexittogetoutofClearcaseviewandreturntoUnixshell.
AddnewfiletoClearcasecontrol:
[username_view]nodename:(username)subdirectory>ctconc.
[username_view]nodename:(username)subdirectory>cp/..../newfile./
[username_view]nodename:(username)subdirectory>ctmkelemcincnewfile
[username_view]nodename:(username)subdirectory>ctcinc.
Checkoutdirectory(.),copyfileandaddittoclearcasecontrol.Thencheckindirectory.Directoryneededupdatingto
reflectchangetoitscontents.Notethatnewfilesaddedtothedirectorycannotbeviewedbyothersuntilthe
directoryischeckedin.ExampleofaddingallfilestoClearcasecontrol:ctmkelemcinc*
AddnewDirectorytoClearcasecontrol:
[username_view]nodename:(username)subdirectory>ctconc.
[username_view]nodename:(username)subdirectory>ctmkdirDIRECTORYNAME
[username_view]nodename:(username)subdirectory>ctcinc.
...
Addfilestodirectory.
...
[username_view]nodename:(username)subdirectory>ctcincDIRECTORYNAME
ClearcaseLabels:
[username_view]nodename:(username)subdirectory>ctmklbtypencRELEASE_NAME_#.#.#
(or:ctmklbtypeordinaryRELEASE_NAME_#.#.#)
[username_view]nodename:(username)subdirectory>ctmklabelrecurseRELEASE_NAME_#.#.#.
Firstcommandcreatesthelabel.Thesecondappliesthelabeltothecurrentdirectory"."recursivelyondownthe
directorystructure.Anotherexample:ctmklabelrecursefollowncRELEASE_NAME_#.#.#directoryname
Wheretheoption"follow"allowsmklabeltofollowsymboliclinks.
Note:MustperformthecommandfromadirectorywithintheVOB.
Updateafileandapplytheexistinglabeltothenewfile:
[username_view]nodename:(username)subdirectory>ctmklabelreplacencRELEASE_NAME_#.#.#filename@@/main/4
Movelabelfromversion3andnowapplyittoversion4.
Removeoldlabel:
http://www.yolinux.com/TUTORIALS/ClearcaseCommands.html
5/11
07/12/2015
ClearcaseCommands:
[username_view]nodename:(username)subdirectory>ctrmtypermalllbtype:OLD_RELEASE_NAME_#.#.#
Listalllabels:
[username_view]nodename:(username)subdirectory>ctlstypekindlbtype
OR
[username_view]nodename:(username)subdirectory>ctlstypekindlbtypeshort|sort
OR
[username_view]nodename:(username)subdirectory>ctlstypekindlbtypeshort|grepiapi|sort
Secondversionlistsall"API"labels.
Listalllabelsonafile:
[username_view]nodename:(username)subdirectory>ctlsvtreeallfilename
Secondcommanddoesnotquitework(??)
Labelformats:RELEASE_NAME_#.#.#
DefaultlabelscreatedbyClearcase:
BACKSTOP:Nochangesallowed.Nonewversionsallowedwhenlabelapplied.Alsosee"lock"command.
CHECKEDOUT:Currentlycheckedoutversions.
LATEST:Latestversionofabranch.
Createaview:
Tofindthedirectoryusedforstoringviewsissuethefollowingcommand:
[prompt]>ctlsview
greg_view/net/hostname/views/viewstore/greg_view.vws
steve_view/net/hostname/views/viewstore/steve_view.vws
...
Createviewfromviewsdirectory.Filesthereareviewname.vws
[prompt]>cd/net/hostname/views/viewstore/
[prompt]>ctmkviewtagdave_view./dave_view.vws
[prompt]>ctlsview|grepdave_view
dave_view/net/hostname/views/viewstore/dave_view.vws
[prompt]>ctdescribel/net/hostname/views/viewstore/dave_view.vws
...
Moveaview:
Assumingthemoveisonasingleserverandtherearenocheckedoutfiles.Stopviewserver.
cd/net/hostname/views/viewstore/
findviewtag.vws|cpiopmd/destinationviewstore
ctrmtagviewallviewtag
ctunregisterview/net/hostname/views/viewstore/viewtag.vws
mvviewtag.vwsviewtag.vwsbackup
ctregisterview/destinationviewstore/viewtag.vws
ctmktagviewtagviewtag/destinationviewstore/viewtag.vws
ctstartviewviewtag
rmviewtag.vwsbackup
ClearcaseClearmake:
[username_view]nodename:(username)subdirectory>ctlsco
[username_view]nodename:(username)subdirectory>clearmakeCgnufMakefile
[username_view]nodename:(username)subdirectory>ctcatcrfile.o
Onemayalsosettheenvironmentvariable:exportCCASE_MAKE_COMPAT=gnu
Checkfirstifthereareanyfilescheckedout.Runmakefile.Listconfigurationrecord.Theadvantageofclearmakeis
thatderivedobjects(objectfilesgeneratedbycompilingsource,hencederivedfromthesource)arestoredwith
extendednames.i.e.filename.o@@26Feb.14:28:9621
ViewdefaultgrouponWindowsPC:
OpenaDOScommandpromptwindow.
cdProgramFiles\Rational\Clearcase\etc\utils
Executethe"creds"command
Readthe"PrimaryGroup"domain.
PCConfigspec:rightclickonXX:drive+clearcase+properties.
Clearcaseexplorer:C:\ProgramFiles\Rational\ClearCase\bin\clearexplorer.exe
http://www.yolinux.com/TUTORIALS/ClearcaseCommands.html
6/11
07/12/2015
ClearcaseCommands:
Clearcasefindcommand:
Tag"all"referstoallfilesinVOB.
FindallfileswithgivenlabelintheVOB:
ctfindalltypefileversion'lbtype(LABELNAME)'print
Findallneworchangedfilessincethatwithaspecifiedlabel:
ctfindallversion'\!lbtype(LABELNAME)&&version(/main/LATEST)'print
Findallfilesattheendofabranchincurrentdirectory:
ctfind./version'version(.../branchname/LATEST)'print
ExplanationofClearcaseviewsandfilestructurewithinaview:
ViewsarerequiredinordertouseClearcase.Auniqueviewassignedtoauserwill:
allowadeveloperaccesstotheVOBdata(sourcecodestorage)
provideaworkspacearewhereuserscanprivatelymodifyVOBdatawithoutdisturbingtheviewoftheVOBdata
heldbyotherdevelopers.ChangesareonlyaccessiblebyotherswhenafileischeckedintotheVOBfromtheusers
privatespace.
Therearethreetypesofviews:
Snapshotview:Changesandupdatesbyothersarenotavailabletoasnapshotviewuntilanew"snapshot"istaken.
Webview:accessiblefromClearcaseWebinterface.Similartoasnapshotview.
Dynamicview:accesstoallversionsofVOBelementsandviewprivateobjectsastheyarecheckedintotheVOB.
DirectoryStructurewithinview:
TheClearcaseviewandversioningsystemisbasedonadirectorystructurebeneathwhatatfirstappearstobeastandard
setoffilesinadirectorystructure.
Example:(setviewfirst:ctsetviewxxxxxx)
Clearcasepresentation
Unixpresentation
ctls
ls
filename1.ext@@/main/3Rule:/main/LATEST
filename2.ext@@/main/6Rule:/main/LATEST
filename1.ext
filename2.ext
Notethattherearethreeversionsofthefileinthemainbranch.
ActualDirectorypathrepresentation:
filename1.ext@@/Actuallyadirectorynamenotafilename
LABEL1Actualyafilewiththefullcontents.
LABEL2
main/Directoryofmainbranch.
LABEL1Actualfilewithfullcontentsoffile.
LABEL2Actualfilewithfullcontentsoffile.
0Actualfilecontainingversionzero.
1Actualfilecontainingversion1
2Actualfilecontainingversion2
3Actualfilecontainingversion3
LATESTActualfilewithfullcontentsoffile.
Note:
ClearcasestoresthefullcontentsofthefilesavedandnotadiffbetweenversionslikeRCSorSCCSwhich
buildsversionsofthefilewhenneccessary.
Thefile"3"and"LATEST"areidentical.
cdfilename.ext@@/main
diff3LATEST
Thiswillshownochangebetweenthefiles.
Searchallarchivedfilesforastring:
findfilename.ext@@printgrep'wordToFind'{}\;
Thisknowledgecanfacilitatesearchesinpreviousversionsofsourcecode.
Relationshipbetweenviewsanddirectorystructure:
Eachviewwillhavethedirectorystructuredescribedabovewithinitsview.
/view/...Viewrootdirectory
/view/viewname1/
bin/...EntireOSfilesystemviewedfromhereforviewname1
etc/..
.../...
http://www.yolinux.com/TUTORIALS/ClearcaseCommands.html
7/11
07/12/2015
ClearcaseCommands:
vob/vobname/src/filename1.extUnixpresentationorfilename1.ext@@for"ctls"
.../...ContentsofClearcaseVOB
/view/viewname2/
bin/...EntireOSfilesystemviewedfromhereforviewname1
etc/..
.../...
vob/vobname/src/filename1.ext
.../...ContentsofClearcaseVOB
Thispath/view/...isviewablebytheregularUNIXuser,withorwithoutsettingtheview.
Whenyousetyourview("ctsetviewviewname1"),itallowsonetoviewtheClearcasearchivefrom/vob/vob
name/....
Theabovepathisfor/view/viewname1/
Thepath/view/viewname1@@/willshowalltherevisionbranches.i.e.
/view/viewname1@@/vob/vobname/main/LATEST/directoryname/main/LATEST/...
0/...
0/...
1/...
2/...
1/...
Configspec:
Configspecspecifiesrulesofviewingspecifiedelementswhichwillbeshowninagivenview.Thesystemdefault
configspeccanbefoundin$ATRIAHOME/default_config_spec(Typically:/usr/atria/default_config_spec)
Basicconfigspec:
(/destinationviewstore/viewtag.vws/config_spec)
element*CHECKEDOUT
element*/main/LATEST
Patternmatching:
Pattern
*
*.h
src/Makefile
Description
Matchesallelementsinthepathbutnotrecursively.
Matchesallelementsinthepathwhichmatchthesuffix".h",butnotrecursively.
Matchesallelementsinthepathinadirectorynamed"src"whichmatchthisfilename.
src/.../Makefile Matchesallelementsinthedirectory/subdirectorytreenamed"src"whichmatchthisfilename.
src/.../*.[ch]
Matchesallelementswiththesuffic".h"and".c"inthedirectory/subdirectorytreenamed"src".
src/...
Matchesallelements(filesanddirectories)inthedirectory/subdirectorytreenamed"src".
ConfigRule
element*CHECKEDOUT
elementdirectory*/main/LATEST
Description
Thisruleismandatory.Withoutthisrule,anyfilethatischeckedoutwillnotbeseen
inaview.
Lookatlatestversionofthedirectoryonthemainbranch.
elementdirectory*/branch
name/LATEST
Lookatlatestversionofthedirectoryonthedefinedbranch.
elementfile*/main/version
number
Showthisparticularversionnumberofallfilesinview.
element*LABEL
element*rulenametimetime
Showelementswiththislabel.(i.e.element*/main/LABEL3)
Showelementswhichcomplywiththisruleandlastmodifiedpriortotime
element*rulenametimetime
Showelementswhichcomplywiththisruleandlastmodifiedpriortotime
element*/vob/vobname/AppName/*
LABEL
Showelementsinthespecifieddirectorywiththegivenlabel.
element/vob/projectA/...
/main/LATEST
Ruleappliesonlytospecifieddirectoryhierarchy.
element*rulenametime26
Oct.14:32
Branching:
Branchingcanbeperformedto:
Allowparalleldevelopmentbetweentwodevelopersandlatermergethecode.
Createanewversionofthesoftwarewithdifferentfeaturesforaspecificpurpose.
Addfeaturesinaseparatebranchtobemergedinlaterafteritisproven.Thebenefitistoallowthemainbranchto
continuewithoutbeingdisturbed.
Configspectoviewbranch:
http://www.yolinux.com/TUTORIALS/ClearcaseCommands.html
8/11
07/12/2015
ClearcaseCommands:
element*CHECKEDOUT
element*.../branchx/LATEST
element*/main/LATESTmkbranchbranchx
Thisconfigspecwillcreateanewbranchfornewfilesaddedorforfilescheckedout.Iffileischeckedoutfrom
/main/LATEST,thentrigger(mkbranchbranchx)executestocreateanewbranchforthefilecheckedout.
Thebranchtypemustfirstbecreatedwiththecommand:mkbrtypec"Commentgoeshere"branchx
Createthebranchtypebeforecreatingtheactualbranch.Onlyonebranchtypeofagivennamewillexist.Manyfilesmay
existwiththebranchesofthesamebranchtype.
Exampleofcreatingabranch:
ctmkbrtypec"Commentgoeshere"BugFix_branch_Y
ctsetviewviewname
ctmkbranchncBugFix_branch_Yfiletobranch.cpp
Thiswillcreateversion"0"offiletobranch.cppinthebranchnamedBugFix_branch_Y.
Createabranchoffofversion5offiletobranch.cppinbranchmain.
ctmkbranchncBugFix_branch_Yfiletobranch.cpp@@/main/5
Createbranchusingallsource:ctmkbranchncoc"BugfixpatchB"patch_B*.cpp*.h
GUI:ctlsvtreegfilename
Merging:Ifonewishestoincludethechangesmadeinabranchintothe"latest"versioninthe"main"branch,onewould
performa"merge".
Mergeversion5onthebranchintothe"latest"versioninthe"main"branch:
ctmergetofiletomerge.cppinsertversion/main/BugFix_branch_Y/5
Specifyconsecutiveversions2through5:
ctmergetfiletomerge.cppinsertversion/main/BugFix_branch_Y/2/main/BugFix_branch_Y/5
Mergeallchangesinabranchintothe"main"branch:
ctfindmergefiletomerge.cppfversions.../BugFix_branch_Y/LATESTmerge
Listallbranches:ctlstypekindbrtype
GUITools:
Tools:
xclearcase:
Command:/usr/atria/bin/xclearcase
xcleardiff:
Command:/usr/atria/bin/xcleardiff
Motifresourcefile:(Addto$HOME/.Xdefaults)
xcleardiff*promptBrightColor:yellow
xcleardiff*changeColor:blue
xcleardiff*deleteColor:red
xcleardiff*insertColor:green
xlsvtree:
Command:/usr/atria/bin/xlsvtree
[PotentialPitfall]:YoumayhavetoissuethecommandexportLANG=CpriortolaunchingGUI.
Commonresources:
Motifresourcefile:(Addto$HOME/.Xdefaults)
*scheme:Monet
*XmText*marginHeight:4
*foreground:blackTextcolor
*background:white
VersionStringGeneration:
Makefile:
...
target:version.h$(OTHER_OBJS)
ccotargetDDATE="\"@(#)`date`\""$(OTHER_OBJS)
...
SourceCode:(.hfile)
...
http://www.yolinux.com/TUTORIALS/ClearcaseCommands.html
9/11
07/12/2015
ClearcaseCommands:
char*version="@(#)targetR3.0";
char*version_time=DATAE;
...
ThisisusedinconjunctionwiththeUNIXwhatcommand.(NotavailableonLinux)
Notes:
UsersofUNIXsysVsystemsmayfindthattheycan'tprintusingthe"lp"commandasthespoolercan'tlocatethefile
ifitdoesnotoperatewiththeusersview.Usethecommand"lpcfilename"whichcreatesacopywhichthe
spoolercanread.
ApplicationsspawnedfromscriptsarenotabletoprocessClearcasecontrolledfiles.Rawexecutablescan.When
workingwithHTMLfilesIcanusethekonquerorbrowserbutIhavenothadanyluckrunningMozillawhichis
spawnedfromashellscript.
Links:
SGI:ClearcaseConceptsGuide
VCClearcase:Emacs/ClearcaseIntegrationEmacsextensionandkeybindings
ApacheANTandClearcase(Javabuildtool)
PERL/CPAN:
CtCmd:CtCmd1.11
Argv:Argv
ClearCaseArgv:ClearCaseArgv
ClearCaseClearPrompt:ClearCaseClearPrompt
ClearCaseCRDB:ClearCaseCRDB
ClearCaseSyncTree:ClearCaseSyncTree
ClearCaseWrapper:ClearCaseWrapper
ClearCaseWrapperDSB:ClearCaseWrapperDSB
EnvPath:EnvPath
IBMClearcaseManuals
GettingStartedwithRationalClearQuestIBMWebtraining
Books:
SoftwareConfigurationManagementStrategiesandIBM(R)Rational(R)
ClearCase(R):APracticalIntroduction
byDavidE.Bellagio,TomJ.Milligan
ISBN#0321200195,IBMPressMay232005
TheArtofClearCase(R)Deployment:TheSecretstoSuccessful
Implementation
byChristianD.Buckley,DarrenW.Pulsipher
ISBN#0321262204,AddisonWesleyProfessional(July13,2004)
SoftwareConfigurationManagementStrategiesandRationalClearCase:A
PracticalIntroduction
byBrianWhite
ISBN#0201604787,AddisonWesleyProfessional1stedition(August25,
2000)
YoLinux.comHomePage
http://www.yolinux.com/TUTORIALS/ClearcaseCommands.html
totopofpage
10/11
07/12/2015
YoLinuxTutorialIndex|Terms
PrivacyPolicy|Advertisewithus|FeedbackForm|
Unauthorizedcopyingorredistributionprohibited.
ClearcaseCommands:
9
StumbleUpon
281
Copyright2004,2005,2006YoLinux.com
http://www.yolinux.com/TUTORIALS/ClearcaseCommands.html
11/11
