Rational ClearCase Fundamentals for

Windows


ClearCase
ClearCase

WindowsClearCase
ClearCase
ClearCase



ClearCase
ClearCase

ClearCase

ClearCase
ClearCase


ClearCase


Build

ClearCase
ClearCase

ClearCase
build

ClearCase
ClearCase

ClearCase
ClearCase


Build

ClearCase
ClearCase

SCM
SCM

ClearCase

ClearCase

ClearCase

FOO

BAR

Release
5.0

report

Software
Development
Engineering

ClearCase
ClearCase

ClearCase
ClearCase


Build

ClearCase
ClearCase

(Workspace management)
View
VOB

ClearCase
ClearCase

ClearCase Explorer(Dynamic View) nc_view

foo.c
src

foo.h

test.txt
ClearCase

ClearCase
ClearCase

View
config specs

ClearCase
ClearCase

ClearCase
ClearCase


(Snapshot
(Snapshot View)
View)

( Dynamic View)
VOB

Local Machine

VOB

Hijack
Hijack

Copy

ClearCase
ClearCase

Dynamic Views



build

VOB
foo.c

src

foo.h

bar.c

checkout
src

foo.c
foo.c

foo.c

test.txt

foo.h
foo.h

bar.c
bar.c

test.txt
test.txt

ClearCase
ClearCase

Dynamic Views
(load rules)

build
te
c
e
n
n
o
C

foo.h

foo.c

foo.h

src

bar.c

ed
t
c
ne
n
o
c
Dis

src
foo.c

VOB

bar.c

ClearCase
ClearCase

ClearCase
ClearCase


Build

ClearCase
ClearCase

Versioned Object
Base(VOB)

checkoutedit-checkin

Versioned Object Base

(VOB)
dir 1
\main

ELEMENTS

file101.c

\main

VERSIONS

BETA_01

RLS1.0

RLS2.0

LABELS

VERSIONS

ClearCase
ClearCase

Versioned Object Base

(VOB)
file101.c
\main

BRANCHES

\rls2_bugfix
0

2
1

\special
0

3
2

MERGE

ClearCase
ClearCase

ClearCase
ClearCase


Build

ClearCase
ClearCase


ClearCaseclearmakeomake
build
makefile

build

ClearCase
ClearCase

ClearCase
ClearCase


Trigger

Tools

E-mail

Lock

report

RelNote

Test#7

Hyperlink
ClearCase
ClearCase

ClearCase
ClearCase

ClearCase Objects

ClearCase
ClearCase


VOB
View
Pathnames

ClearCase
ClearCase

ClearCase

ClearCase
ClearCase

ClearCase Objects
VOB
View
Pathnames

ClearCase
ClearCase

Element
An element is an object that consists of a set of
versions, organized into a version tree.
Windows
elementClearCase

file101.c
Elements
\main
0

Source files
Directories
Binary files
Objects libraries
Documents

0
0

\special

BETA_01

RLS1.0

RLS2.0

\rls2_bugfix 0

\enhance

RLS3.0

6
7

ClearCase
ClearCase

VOB

ClearCase elements

Windows NT
Windows 2000
UNIXRed Hat Linux

ClearCase
ClearCase

Projects and VOBs

P
r
o
j
e
c
t
X

Versioned Object
Base 1
parse.c

Versioned Object
Base 3

lex.c

bar.c

Versioned Object
Base 2
msg.h

units.h

foo.c

P
r
o
j
e
c
t
Y

projectVOB
projectVOB
ClearCase
ClearCase

VOBView
VOBMount
Dynamic View
Snapshot View
VOBDynamic ViewVOB

VOBSnapshot View

ClearCase
ClearCase

Mounting a VOB
VOB
VOB(tag)
VOB

ClearCase
ClearCase

Mounting a VOB
GUI
ClearCase Explorer > Mount VOB
Windows Explorer > Mount VOB
CLI
c:\> cleartool mount \test_vob

ClearCase
ClearCase

ViewVOB
View
VOB
src
hello.c

foo.c
foo.c

hello.h

src

util.c

foo.h
foo.h

ClearCase
ClearCase

ClearCase
ClearCase

ClearCase Objects
VOB
View
Pathnames

ClearCase
ClearCase

Views

config specsVOB

ClearCase
ClearCase

View
config specsVOB

ClearCase
ClearCase

View
VOB

foo.c

src

foo.h

bar.c

checkout
src

foo.c
foo.c

foo.c

test.txt

foo.h
foo.h

test.tx
test.tx
t
t

bar.c
bar.c

VOB

Co

foo.h

e
ct

Di

src
foo.c

nn

VOB

sc

foo.c

e
nn

ct

foo.h

src

bar.c

ed

bar.c

ClearCase
ClearCase

Version
element version

version
view

version
VOB
element
ClearCase
ClearCase

Directory Versions
directory version

Directory version

ClearCase
ClearCase

View-tag

View database files

db

Symbolic name
used to reference
the view

ClearCase internal
information

.s
Admin

View-private files
(checked-out files,unshared
derived objects,temporary
files)

Administrative files
Administrative files that
manage connections to
other ClearCase objects

ClearCase
ClearCase

View-tag
Symbolic name
used to reference
the view

db

Admin

View database files

ClearCase internal
information

.s

Administrative files
Administrative files that
manage connections to
other ClearCase objects

View-private files
(checked-out files,unshared
derived objects,temporary
files)

ClearCase
ClearCase

ClearCase Objects
VOB
View
Pathnames

ClearCase
ClearCase

Pathnames
View
\main\3
z:\test> type hello.c
int main() {
printf (Hello, this is the latest version.\n);
return 0;
}
View
z:\test> type hello.c@@\main\1
main() {
printf(Hello there, world!\n);
}
ClearCase
ClearCase

Version Extended Name

z:\test\hello.c@@ \main\1
z:\test\hello.c
@@
\main\1

ClearCase
ClearCase

ClearCase
ClearCase

ClearCase
ClearCase

ClearCase
ClearCase

ClearCase
ClearCase

Registry Location
License
License Location
Location
Local
Local Storage
Storage
View Server

Remote Server
VOB Storage

ClearCase
ClearCase

The View Creation Process

view_server

ClearCase
ClearCase

Accessing Create View

->->Rational ClearCase->Create View
ClearCase Explorer
1. Toolbox tab
2. Base ClearCase tab
3. Create View icon
Command Prompt
c:\> cleartool mkview

ClearCase
ClearCase

The View Creation Wizard

Dynamic ViewsSnapshot Views

ClearCase
ClearCase

Creating a Dynamic View

ClearCase
ClearCase

Creating a Snapshot View

ClearCase
ClearCase

Load Rules for Snapshot Views

checkins,updates

ClearCase

Single
Single element
element
All
All elements
elements in
in aa VOB
VOB

ClearCase
ClearCase

Load the Elements

Choose
Elements to Load

VOB
element

ClearCase
ClearCase

Creating a Dynamic View: Syntax

cleartool
cleartool mkview
mkview -tag
-tag dynamic-view-tag
dynamic-view-tag
[-region
[-region network-region]
network-region]
[-shareable_dos
[-shareable_dos || -nshareable_dos]
-nshareable_dos]
[-host
[-host hostname
hostname -hpath
-hpath host-stg-pname]
host-stg-pname]
dynamic-view-storage-pname
dynamic-view-storage-pname

Rational ClearCase Command Reference

ClearCase
ClearCase


C:\>cleartool mkview tag user_view
\\scmserver\views\user_view.vws
Created view.
Host-local path: scmserver:D:\Views\user_view.vws
Global path: \\scmserver\views\user_view.vws
\\scmserver\views user_view.vws

ClearCase
ClearCase

Creating a Snapshot View

cleartool
cleartool mkview
mkview -snapshot
-snapshot
[-tag
[-tag dynamic-view-tag]
dynamic-view-tag]
[-tcomment
[-tcomment tag-comment]
tag-comment]
[-cachesize
[-cachesize size]
size] [-ptime]
[-ptime]
[-stgloc
[-stgloc view-stgloc-name
view-stgloc-name
|colocated_server
|colocated_server [-host
[-host hostname
hostname
-hpath
-hpath host-snapshot-view-pname
host-snapshot-view-pname
-gpath
-gpath global-snapshot-view-pname]]
global-snapshot-view-pname]]
snapshot-view-pname
snapshot-view-pname

Rational ClearCase Command Reference

ClearCase
ClearCase


C:\>cleartool mkview -tag zhangyong_sv1 -snapshot stgloc Views F:\MySnapshotViews\zhangyong_sv1.vws
Created view.
Host-local path:
scmserver:D:\Views\PDOMAIN\zhangyong\zhangyong_
sv1.vws.vws
Global path:
\\scmserver\Views\PDOMAIN\zhangyong\zhangyong_s
v1.vws.vws
Created snapshot view directory
"F:\MySnapshotViews\zhangyong_sv1.vws".
ClearCase
ClearCase



cleartool: Error: Attempt to get location information on "
\\scmserver\views\sv" failed:
No such file or directory

cleartool: Error: Unable to create directory
"\scmserver\views\sv\user_view.vws": File exists
cleartool: Error: Unable to create view
"\scmserver\views\sv\user_view.vws"

cleartool: Error: A registry entry already exists for
"user_view"
ClearCase
ClearCase

ClearCase
ClearCase


View

ClearCase
ClearCase




Create View Wizard
ClearCase ExplorerViews tab
Windows Explorer
ClearCase ExplorerMVFSCLInet
use
cleartool startview

ClearCase
ClearCase


ClearCase Explorer
1. Toolbox tab
2. Base ClearCase tab
3. Start View icon

Command Prompt
c:\> cleartool startview MRP_view
ClearCase
ClearCase

Dynamic Views Drive

Dynamic View

ClearCase
ClearCase


F:
F:
(view1)
(view1)

M:
M:

view1

VOB1

VOB2

VOB1

VOB2

view2

VOB1

VOB2

MVFSM:

VOB
ClearCase
ClearCase


cleartool pwv
cleartool
cleartool pwv
pwv [-short]
[-short]
[-wdview
[-wdview || -setview
-setview || -root]
-root]
Z:\>
Z:\> cleartool
cleartool pwv
pwv
Working
Working directory
directory view:
view: MRP_view
MRP_view
Set
Set view:
view: MRP_view
MRP_view

ClearCase
ClearCase

ClearCase
ClearCase

Removing a View
View
VOB

VOBViewcheckouts
DO
View
Kill view server processes
WindowsView

ClearCase
ClearCase

Remove a View

ClearCase Explorer
1. Toolbox tab
2. Base ClearCase tab
3. Remove View icon
Command Prompt
c:\> cleartool rmview tag MRP_view

ClearCase
ClearCase

Remove a View
ClearCase ExplorerViews tabRemove View

ClearCase
ClearCase

WindowsClearCase

ClearCase
ClearCase


ClearCase
ClearCase
ClearCase

ClearCase
ClearCase

ClearCase
ClearCase
ClearCase
ClearCase

ClearCase
ClearCase

WindowsClearCase
ClearCase
ClearCase
ClearCase

ClearCase
ClearCase

ClearCase
ClearCase

Windows Explorer

ClearCase

ClearCase
ClearCase

ClearCase Explorer

ClearCase
ClearCase

ClearCase Explorer(Toolbox View)

ClearCase
ClearCase

WindowsClearCase
ClearCase
ClearCase
ClearCase

ClearCase
ClearCase

ClearCase
Cleartool
viewsVOBs



viewsVOBs

ClearCase
ClearCase

ClearCase
ClearCase


Single
Single Command
Command Mode
Mode

Interactive
Interactive Command
Command Mode
Mode

quitexitcleartool
quitexitcleartool interactive
interactive
cleartool
cleartool interactive
interactive mode!
mode!
Windows
Windows command
command
ClearCase
ClearCase

cleartool

cleartool
cleartool ls
ls
Z:\test\zy\1>cleartool
Z:\test\zy\1>cleartool lsls
1.txt@@\main\1
1.txt@@\main\1

Rule:
Rule: \main\LATEST
\main\LATEST

test@@\main\1
test@@\main\1

Rule:
Rule: \main\LATEST
\main\LATEST

Z:\test\zy\1>cleartool
Z:\test\zy\1>cleartool
cleartool>
cleartool> lsls
1.txt@@\main\1
1.txt@@\main\1

Rule:
Rule: \main\LATEST
\main\LATEST

test@@\main\1
test@@\main\1

Rule:
Rule: \main\LATEST
\main\LATEST

cleartool>
cleartool> quit
quit
Z:\test\zy\1>
Z:\test\zy\1>

ClearCase
ClearCase

CLI

-c
-c comment
comment string
string

-cq
-cq

-cqe
-cqe

-nc
-nc

-cfile
-cfile pname
pname

ClearCase
ClearCase


Check
Check inProperties
inProperties of
of Version
Version

ClearCase
ClearCase

WindowsClearCase
ClearCase
ClearCase
ClearCase

ClearCase
ClearCase

ClearCase Explorer

ClearCase
ClearCase

ClearCase
ClearCase

CLI
Cleartool lshistory

VOBClearCase
(elements)
(branches)(version)(links)

ClearCase
ClearCase

CLI

ClearCase
ClearCase


Cleartool
Cleartool lsprivate
lsprivate [-tag
[-tag view-tag]
view-tag]
[-invob
[-invob vob-selector]
vob-selector] [-long
[-long || -short]
-short] [-co]
[-co]
[-size]
[-size] [-age]
[-age] [-co]
[-co] [-do]
[-do] [-other]
[-other]
VOB

derived objects
checked-out
cleartool> lsprivate -invob \test -co
\test\1\1.txt [checkedout]

Snapshot views
ClearCase
ClearCase


cleartool lsview full properties
view




derived objects

ClearCase
ClearCase

WindowsClearCase
ClearCase
ClearCase
ClearCase

ClearCase
ClearCase


F1Help

Help
ClearCaseClearCase Help
ClearCase Explorer Help

ClearCase
ClearCase

ClearCase
ClearCase

ClearCase

ClearCase
ClearCase


Version Trees

ClearCase
ClearCase

ClearCase


ClearCase

ClearCase
ClearCase

ClearCase
Version Trees

ClearCase
ClearCase

Version Tree
Hello.c
\main

1
\v1.1_bugs
V1.1
2

\critical
0

1
\zy_test

1
0

2
2

4
1

hello.c@@\main\v1.1_bugs\critical\2
hello.c@@\main\v1.1_bugs\critical\2

ClearCase
ClearCase


Windows

J:\project_hw\src>dir
Makefile
hello.c
hello.h
util.c

ClearCase

J:\project_hw\src>cleartool ls
Makefile@@\main\2
Rule:\main\LATEST
hello.c@@\main\3
Rule:\main\LATEST
hello.h @@\main\1
Rule:\main\LATEST
util.c @@\main\3
Rule:\main\LATEST

ClearCase
ClearCase

CLI
cleartool
cleartool lsvtree
lsvtree -graphical
-graphical [-all]
[-all] [-nmerge]
[-nmerge]
[-nco]
[-nco] [-options
[-options pass-through-opts]
pass-through-opts] pname
pname

(merges)

J:\project_hw\src\cleartool lsvtree -graphical hello.c

ClearCase
ClearCase

View

Tools>Options
/

ClearCase
ClearCase

lsvtree
lsvtree
lsvtree [-nrecurse]
[-nrecurse] [-short]
[-short] [-all]
[-all] [-merge]
[-merge]
[-nco]
[-nco] [-obsolete]
[-obsolete] [-branch
[-branch branch-pname]
branch-pname] pname
pname

,lsvtree
,
,:

Label

hyperlink
Merge

\main
0
\rel2_bugfix
REL2

REL3

ClearCase
ClearCase

CLI
J:\test\src>cleartool lsvtree hello.c
hello.c@@\main
hello.c@@\main\1 (REL2)
hello.c@@\main\rel2_bugfix
hello.c@@\main\rel2_bugfix\1
hello.c@@\main\3 (REL3)
J:\test\src>cleartool lsvtree all hello.c
hello.c@@\main
hello.c@@\main\0
hello.c@@\main\1 (REL2)
hello.c@@\main\rel2_bugfix
hello.c@@\main\rel2_bugfix\0
hello.c@@\main\rel2_bugfix\1
hello.c@@\main\2
hello.c@@\main\3 (REL3)
ClearCase
ClearCase

Element Types

(HTML/XML)

ClearCase

ClearCase
ClearCase

ClearCase
ClearCase

ClearCase
Version Trees

ClearCase
ClearCase

ClearCase
ClearCase


J:\test\src>cleartool co -c "Adding readme file." .
Checked out "." from version "\main\3".
J:\test\src>cleartool mkelem -c "Documentation for
hello" readme.txt
Created element "readme.txt" (type "text_file").
Checked out "readme.txt " from version "\main\0".
J:\test\src>cleartool ci -nc .
Checked in "." from version "\main\4".

ClearCase
ClearCase

Adding Existing Files to Source Control

Cleartool mkelem
J:\test\src>cleartool mkelem -c "Adding files to source
control" foo.c foo.h bar.c
Created element "foo.c" (type "text_file").
Checked out "foo.c " from version "\main\0".
Created element "foo.h" (type "text_file").
Checked out "foo.h" from version "\main\0".
Created element "bar.c" (type "text_file").
Checked out "bar.c" from version "\main\0".

ClearCase
ClearCase

Adding Existing Files to Source Control ()

Clearfsimport
ClearCase

Clearexport_ffileclearimport

J:\test>clearfsimport -recurse d:\code\src .

ClearCase
ClearCase

ClearCase
Version Trees

ClearCase
ClearCase

@@()

hello.h@@\main\rel2_bugfix\9

util.c@@REL3
ClearCase
chap1.doc@@\main\LATEST
ClearCase
ClearCase

Pathnames
View
z:\test> type hello.c
int main() {
printf (Hello, this is the version of your view.\n);
return 0;
}
View
z:\test> type hello.c@@\main\1
main() {
printf(Hello there, world!\n);
}
ClearCase
ClearCase

ClearCase
Version Trees

ClearCase
ClearCase


VOB

checked-outDO
src

foo.c

foo.h

Config Spec

src

foo.c

foo.h
bar.c

bar.c
test.txt

test.txt

ClearCase
ClearCase


cleartool
cleartool lsprivate
lsprivate [-tag
[-tag view-tag]
view-tag]
[-invob
[-invob vob-selector]
vob-selector] [-l\ong
[-l\ong || -s\hort]
-s\hort] [-co]
[-co]
[-size]
[-size] [-age]
[-age] [-co]
[-co] [-do]
[-do] [-oth\er]
[-oth\er]
VOB

DO
checked-out
Z:\test\src>cleartool lsprivate
\test\src\1
\test\src\test.txt
\test\src\foo.c [checkedout]

ClearCase
ClearCase

ClearCase

ClearCase
ClearCase


Checking Out Versions

Checkout

Checking In Versions

ClearCase
ClearCase

Checking Out Versions

Checkout

Checking In Versions

ClearCase
ClearCase

ClearCase
Checking Out Versions

Checkout

Checking In Versions

ClearCase
ClearCase


checked out

ClearCaseVOB
Administrator

Z:\test\src>attrib foo.c
R Z:\test\src\foo.c
Z:\test\src>del foo.c
Z:\test\src\foo.c

Z:\test\src>attrib -r foo.c - Z:\test\src\foo.c

ClearCase
ClearCase

Checking Out

GUI
CLI
check out

ClearCase
ClearCase

Checkout

src

foo.c

foo.h

read only

Config Spec

src

foo.c

foo.h
bar.c

read only

bar.c
read only

ClearCase
ClearCase

Checkout

checkedout

ClearCase
ClearCase

Check Out

ClearCase
ClearCase

Reserved Check Out

Check

ClearCase
ClearCase

checkout

ClearCase
ClearCase

CLIcheckout
Z:\test\src>cleartool checkout bar.c
Checkout comments for "bar.c":
Bug fixing
.
Checked out "bar.c" from version "\main\3".

ClearCase
ClearCase

Checkout

src

src
foo.c

foo.h

read only

read only

bar.c
read\write

bar.c

Config Spec

foo.c

foo.h

View Storage
bar.c

ClearCase
ClearCase

Finding Checkouts
Find Checkout
checkouts

ClearCase
ClearCase

Finding Checkouts
checked out

ClearCase
ClearCase

Checkouts
-me | -user

Z:\test\src>cleartool lsco -me

-cview

-all
VOB checkouts

-long
checkout
ClearCase
ClearCase

Checkouts
Z:\test\src>cleartool lsco -long
07--03.15:42:27 zhangyong.nc_qm@zhangyong
checkout version "bar.c" from \main\3 (reserved)
by view: MRP_view
("scmserver:D:\MRP_View\PDOMAIN\zhangyong\MRP_view.vws")
"Bug fixing"
07--03.16:05:36 zhangyong.nc_qm@zhangyong
checkout version "foo.c" from \main\2 (reserved)
by view: MRP_view
("scmserver:D:\MRP_View\PDOMAIN\zhangyong\MRP_view.vws")
ClearCase
ClearCase

Checkout
Reserved checkout:
reserved checkoutcheckin(
Undo checkout)checkin
reserved checkout

Unreserved checkout
checkout
reserved checkout
unreserved checkoutchecked in
checked in
checkin

ClearCase
ClearCase

Checkout
RESERVED
RESERVED Checkout
Checkout

UNRESERVED
UNRESERVED Checkout
Checkout
Checkout
Checkout (2)
(2)
3

Checkout
Checkout
(1)
(1)

Checkout
Checkout
(1)
(1)

Checkout
Checkout (2)
(2)
3
U
3

Checkin
Checkin
(2)
(2)

Checkin
Checkin
(3)
(3)

Merge
Merge
(4)
(4)
Checkin
Checkin (5)
(5)

4
5

ClearCase
ClearCase

Unreserved Checkout
checked out reserved
check out

ClearCase
ClearCase


reserved
unreserved checkouts

ClearCase
ClearCase

Checkout
Check Out
Unreserved if already reserved checkbox

ClearCase
ClearCase

ClearCase
Checking Out Versions

Checkout

Checking In Versions

ClearCase
ClearCase

ClearCase
ClearCase

 CLI
Z:\test>cleartool co -c "Add include directory" .
Checked out ". " from version "\main\2".
Z:\test>cleartool mkdir -c "Directory for include files
" include
Created directory element "include".
Checked out "include" from version "\main\0".
CLI
check in

ClearCase
ClearCase

checkout/checkin

checked out

ClearCase
ClearCase







VOB links

ClearCase
ClearCase

ClearCase
ClearCase

Cleartool mkdir
cleartool
cleartool mkdir
mkdir [-nco]
[-nco] [-c
[-c comment
comment || -cfile
-cfile
comment-file-pname
comment-file-pname || -cq
-cq || -cqe
-cqe || -nc]
-nc]
dir-pname
dir-pname

-ncocleartoolcheck out
Z:\test>cleartool mkdir doc
Creation comments for "doc":
New directory for documentation files
.
Created directory element "doc".
Checked out "doc" from version "\main\0".
ClearCase
ClearCase

Orphaned Elements
orphaned elementClearCase

ClearCase
ClearCase


ClearCase Explorer
drag and drop

ClearCase
ClearCase

 CLI
Z:\test>cleartool co -nc src
Checked out "src" from version "\main\3".
Z:\test>cleartool co -nc doc
Checked out "doc" from version "\main\1".
Z:\test>cd src
Z:\test\src>cleartool mv query.doc ..\doc
Moved "query.doc" to "..\doc\query.doc".

ClearCase
ClearCase


src

query.doc

ClearCase
ClearCase

ClearCase
Checking Out Versions

Checkout

Checking In Versions

ClearCase
ClearCase

Checkout

ClearCase
ClearCase

Checkout
cleartool
cleartool reserve
reserve [-c
[-c comment
comment || -cfile
-cfile comment-file-pname
comment-file-pname || -cq
-cq || -cqe
-cqe
|| -nc]
-nc] [-cact
[-cact || -cwork]
-cwork] pname
pname

cleartool
cleartool unreserve
unreserve [-view
[-view
[hostname:]view-storage-dir-pname
[hostname:]view-storage-dir-pname
[-cact
[-cact || -cwork]
-cwork]
[-c
[-c comment
comment || -cfile
-cfile comment-file-pname
comment-file-pname || -cq
-cq || -cqe
-cqe || -nc]
-nc] pname
pname

checkout

ClearCase
ClearCase
VOB
VOB owner
owner
Element
Element owner
owner
Element
Element group
group member
member

checked out
unreserved-view
ClearCase
ClearCase

Checkout
Z:\test\src>cleartool
Z:\test\src>cleartool lsco
lsco -long
-long
08--03.10:24:10
08--03.10:24:10 zhangyong.nc_qm@zhangyong
zhangyong.nc_qm@zhangyong
checkout
checkout version
version "bar.c"
"bar.c" from
from \main\3
\main\3 (unreserved)
(unreserved)
by
by view:
view: zhangyong_view3
zhangyong_view3
("scmserver:D:\Views\PDOMAIN\zhangyong\zhangyong_view.vws")
("scmserver:D:\Views\PDOMAIN\zhangyong\zhangyong_view.vws")
09--03.13:29:01
09--03.13:29:01 zhangyong.nc_qm@zhangyong
zhangyong.nc_qm@zhangyong
checkout
checkout version
version "bar.c"
"bar.c" from
from \main\3
\main\3 (reserved)
(reserved)
by
by view:
view: MRP_view
MRP_view ("scmserver:D:\MRP_View\PDOMAIN\zhangyong\MRP_view.vws")
("scmserver:D:\MRP_View\PDOMAIN\zhangyong\MRP_view.vws")
Z:\test\src>cleartool
Z:\test\src>cleartool unreserve
unreserve bar.c
bar.c
Changed
Changed checkout
checkout to
to unreserved
unreserved for
for "bar.c"
"bar.c" branch
branch "\main".
"\main".
Z:\test\src>cleartool
Z:\test\src>cleartool reserve
reserve bar.c
bar.c
Changed
Changed checkout
checkout to
to reserved
reserved for
for "bar.c"
"bar.c" branch
branch "\main".
"\main".

ClearCase
ClearCase

Checkout
-view
Y:\test\src>cleartool unreserve -view
scmserver:D:\MRP_View\PDOMAIN\zhangyong\MRP_vie
w.vws bar.c
Changed checkout to unreserved for "bar.c" branch "\main".

ClearCase
ClearCase

Canceling a Checkout: Undo Checkout

checkout
checked-in

ClearCase
ClearCase

Checkout

src

foo.h

bar.c

Config Spec

foo.c

src
foo.c

foo.h
bar.c

bar.c.keep
View Storage
bar.c.keep

ClearCase
ClearCase

lost+found
VOB

ClearCase
ClearCase

Retrieving an Orphaned Element

Check out
lost+found

Z:\test>cleartool co nc doc
Z:\test>cd lost+found
Z:\test\lost+found>cleartool mv
query.doc.96c93d305a5111ceb0200080c880e47f
..\doc\query.doc
Moved "query.doc.96c93d305a5111ceb0200080c880e47f" to
"..\doc\query.doc".
ClearCase
ClearCase

Lost+found
Z:\test>cleartool co nc doc
Z:\test>cleartool mkelem nc doc\query.doc
<modify query.doc and check it in>
Z:\test>cleartool unco doc
cleartool: Warning: Object "query.doc" no longer referenced.
cleartool: Warning: Moving object to vob lost+found directory
as "query.doc.96c93d305a5111ceb0200080c880e47f".
Checkout cancelled for "src".

ClearCase
ClearCase

ClearCase
Checking Out Versions

Checkout

Checking In Versions

ClearCase
ClearCase

ClearCase

32

Rational Rose ModelsXML
HTML

ClearCase
ClearCase

ClearCase
ClearCase

Comparing with Previous Versions

Compare with Previous Version

ClearCase
ClearCase

CLI
Cleartool diff32

ClearCase
ClearCase

CLI
Cleartool diff-blank_ignore

cleartool diff -option

ClearCase
ClearCase

ClearCase
Checking Out Versions

Checkout

Checking In Versions

ClearCase
ClearCase

Checking in a New Version

Checked-in
update

Checkin
ClearCase Explorer, Windows Explorer, Version
Tree Browser, ClearCase supported IDEs, CLI

ClearCase
ClearCase

Checking in Versions

ClearCase
ClearCase

ClearCase checkin
cleartool
cleartool checkin
checkin || cici
[-nwarn]
[-nwarn] [-cr]
[-cr] [-ptime]
[-ptime] [-keep
[-keep || -rm]
-rm]
[-from
[-from source-pname]
source-pname] [-identical]
[-identical]

Checked-in
update

-identical
checked in

Z:\test\src>cleartool ci -c "fixed bug 209" foo.c

ClearCase
ClearCase

Object History
VOB

ClearCasecheck out

who, what,
when, where,

ClearCase
ClearCase

ClearCase
Checking Out Versions

Checkout

Checking In Versions

ClearCase
ClearCase


cleartool
cleartool rmver
rmver [-force]
[-force] [-xbranch]
[-xbranch] [-xlabel]
[-xlabel]
[-xattr]
[-xattr] [-xhlink]
[-xhlink] [-date]
[-date]
[-version
[-version version-selector
version-selector || -vrange
-vrange low-version
low-version high-version]
high-version]
[-c
[-c comment
comment || -cfile
-cfile comment-file-pname
comment-file-pname || -cq
-cq || -cqe
-cqe || -nc]
-nc] pname
pname

VOB
metadata

Z:\test\src>cleartool rmver foo.c@@\main\1

Removing these version of "foo.c": \main\1
Remove versions? [no] yes
Removed version of "foo.c"
ClearCase
ClearCase

Removing Reference to an Element

cleartool
cleartool rmname
rmname [-c
[-c comment
comment || -cq
-cq || -cqe
-cqe || -nc]
-nc]
[-nco
[-nco [[ -force]]
-force]] pname
pname

VOB symbolic
link
VOB
src

foo.c

bar.c

foo.h

\main

\main

\main

\main

foo.c
foo.h
bar.c

\bug
2

foo.c
foo.h

reference
removed

ClearCase
ClearCase


@
@ cleartool
cleartool rmelem
rmelem [-force]
[-force] [-c
[-c comment
comment || -cfile
-cfile comment-file-pname
comment-file-pname
|| -cq
-cq || -cqe
-cqe || -nc]
-nc] pname
pname

VOB
reference
checked-out
element owner, VOB owner, ClearCase

src

bar.c

0
0
bar.c
1
1
2

bar.c

ClearCase
ClearCase


Z:\test\doc>cleartool
Z:\test\doc>cleartool rmelem
rmelem query.doc
query.doc
CAUTION!
CAUTION! This
This will
will destroy
destroy the
the element,
element, all
all its
its branches
branches and
and versions,
versions,
including
including all
all data,
data, meta-data
meta-data and
and history,
history, and
and will
will remove
remove the
the element
element
from
from all
all directory
directory versions
versions that
that now
now contain
contain it.it. Once
Once you
you destroy
destroy the
the
element,
element, there
there will
will be
be no
no way
way to
to restore
restore itit to
to its
its current
current state.
state.
IfIf you
you want
want to
to preserve
preserve the
the element,
element, but
but remove
remove references
references to
to itit from
from
future
future directory
directory versions,
versions, use
use the
the "rmname"
"rmname" command.
command.
Element
Element "query.doc"
"query.doc" has
has 11 branches,
branches, 22 versions,
versions, and
and isis entered
entered
inin 11 directory
directory versions.
versions.
Destroy
Destroy element?
element? [no]
[no] yes
yes
Removed
Removed element
element "query.doc".
"query.doc".

ClearCase
ClearCase

ClearCase
ClearCase


Configuration Specifications

ClearCase
ClearCase

ClearCase
ClearCase


Configuration Specifications

ClearCase
ClearCase

Config Spec

VOB

view_server process

load rules

updateload
ClearCase
ClearCase

Config Spec Rules

Default config spec:

element
element

*
*

CHECKEDOUT
\main\LATEST
ClearCase
ClearCase


<scope>

element
element
element
element

<pattern>
**
**

<version-selector>
CHECKEDOUT
CHECKEDOUT
\main\LATEST
\main\LATEST

<scope> =
element, element -file, element -directory,
element eltype text_file
<pattern> =
*, *.c, \test\\*.c
<version-selector>
scopepattern
CHECKEDOUT, \main\LATEST
\main\4
ClearCase
ClearCase

element * CHECKEDOUT
element * \main\LATEST

element * REL2

element * CHECKEDOUT
element * \main\rel_bugfix\LATEST
element * REL2 mkbranch rel2_bugfix
ClearCase
ClearCase


LATEST

element *.h \main\LATEST -time now

element * \main\LATEST -time 22-Feb-01.9:00

element * \main\LATEST -time Friday

checkouts
element * REL1 nocheckout

element * REL2 -mkbranch rel2_bugfix
ClearCase
ClearCase

element * CHECKEDOUT
# the following rules were set up by user1
include \\user1\views\users\global\config_spec

LATEST

element * CHECKEDOUT
time Tuesday.9:00
element * \main\rel2_bugfix\LATEST
element * \main\LATEST

ClearCase
ClearCase


checked-out

src

src
foo.c

foo.c

foo.h
bar.c

foo.h

View

bar.c

bar.c.keep
View Storage
bar.c.keep

ClearCase
ClearCase


Configuration Specifications

ClearCase
ClearCase


cleartool catcs [-tag view-tag]

Z:\test\src>cleartool catcs
element * CHECKEDOUT
element * /main/LATEST

Z:\test\src>cleartool catcs -tag NC2_view
element * NC2.0
ClearCase
ClearCase

Cleartool catcs
Z:\test\src> cleartool catcs
element * CHECKEDOUT
element * /main/LATEST
src

src

foo.c

foo.h
bar.c

foo.c

bar.c

View

foo.h

View Storage
bar.c

ClearCase
ClearCase


Properties of View
Edit

ClearCase
ClearCase


ClearCase

ClearCase
ClearCase

ClearCase

ClearCase
ClearCase


Configuration Specifications

ClearCase
ClearCase


cleartool setcs

-default

-currentview_server

X:\>cleartool setcs cspec_REL2

X:\>cleartool setcs -default

ClearCase
ClearCase


cleartool edcs [-tag view-tag] [pname]
EDITOR

cleartool setcs [-tag view-tag] [pname]

{ -current | -default | pname }
ASCII

ClearCase
ClearCase

cleartool edcs
X:\> cleartool edcs

element * CHECKEDOUT
element * \main\rel2_bugfix\LATEST
element * REL2 mkbranch rel2_bugfix

Set config spec for view "test_view"? [yes] yes

X:\> cleartool catcs
element * CHECKEDOUT
element * \main\rel2_bugfix\LATEST
element * REL2 -mkbranch rel2_bugfix
ClearCase
ClearCase

View
cleartool lsREL2

X:\> cleartool ls
foo.c@@\main\4 Rule:
foo.h@@\main\3 Rule:
bar.c@@\main\5 Rule:

REL2
REL2
REL2

-rel2_bugfix
-rel2_bugfix
-rel2_bugfix

rel2_bugfix

ClearCase
ClearCase

ClearCase Element Options

ClearCase
ClearCase

ClearCase
ClearCase

ClearCase
ClearCase





Profile

ClearCase
ClearCase

ClearCase

View Profile

ClearCase
ClearCase





Profile

ClearCase
ClearCase

ClearCase
ClearCase

ClearCase
ClearCase





Profile

ClearCase
ClearCase

ClearCase
1
2

rel2_bugfix
zhangyong_exp
wizard_features

ClearCase
ClearCase



VOB

main

foo.c
\main

bar.c
\main
\bugfix

\pvt
\bugfix

bugfix

ClearCase
ClearCase

\main\bugs\bug404

branch_names,
LABEL_NAMES

main
0

\bugs
2

\bug404
0

\enh
0

1
\bug417

2
4

2
1

ClearCase
ClearCase


Type Explorer

ClearCase
ClearCase


Type Explorer

ClearCase
ClearCase


Type Details tab

ClearCase
ClearCase



VOB
-mkbranch

Profile

cleartool mkbranch

ClearCase
ClearCase





Profile

ClearCase
ClearCase

-mkbranch
-mkbranchcheckout

Rule 1: element * CHECKEDOUT

Rule 2: element * \main\rel2_bugfix\LATEST
Rule 3: element * REL2 -mkbranch rel2_bugfix
Rule #3

REL2
checkout REL2REL2
rel2_bugfix
Checkout rel2_bugfix0
ClearCase
ClearCase

check out
REL2

REL2

checkout

element
element ** CHECKEDOUT
CHECKEDOUT
element
element ** \main\rel2_bugfix\LATEST
\main\rel2_bugfix\LATEST
element
element ** REL2
REL2 -mkbranch
-mkbranch rel2_bugfix
rel2_bugfix

ClearCase
ClearCase


Check out
rel2_bugfix
CHECKEDOUT

ClearCase
ClearCase


checked-out

ClearCase
ClearCase


-mkbranch

Rule 1: element * CHECKEDOUT

Rule 2: element *
\main\rel2_bugfix\bug_404\LATEST
Rule 3: element * \main\rel2_bugfix\LATEST
-mkbranch bug_404
Rule 4: element * REL2 -mkbranch rel2_bugfix
Checkout
0-mkbranch
ClearCase
ClearCase

ClearCase
ClearCase





Profile

ClearCase
ClearCase

View Profiles
ClearCase

ClearCase

View
View Profiles
Profiles ClearCase
ClearCase LT
LT
ClearCase
ClearCase

View Profiles
View Profile
View
Profile

VOBs
View Profile

ClearCase
ClearCase

View Profile
View Profile

ClearCase
ClearCase

View Profile
View Creation Wizard
View Profiles
View Profile

ClearCase
ClearCase

ClearCase
ClearCase


ClearCase

ClearCase
ClearCase

ClearCase


Merge Manager

ClearCase
ClearCase


ClearCase

ClearCase
ClearCase

Merging

ClearCase

ClearCase
ClearCase

32
Merge Manager

ClearCase
ClearCase


Merge
basecontributor

ClearCase

ClearCase
ClearCase


base

contrib1

changed

inserted

deleted

contrib2

merge result

n/c

deleted

changed

changed

changed

conflict

inserted

ClearCase
ClearCase


ClearCase

ClearCase
ClearCase

Base Contributor
contributors
ClearCasebase contributor

contributors
base contributor

foo.c
\main

bar.c
\main

foo.c
\main

= contributor versions
= base
=

ClearCase
ClearCase

Base
foo.c@@\main\1
Contributors
foo.c@@\main\3

foo.c@@\main\rel2_bugfix\1

ClearCase
ClearCase

ClearCase
ClearCase

ClearCase
ClearCase

Merge
Merge result
result

Base
Base

From
From version
version

To
To version
version

ClearCase
ClearCase


ClearCase

file.contrib

checked-out
VOB

ClearCase
ClearCase



check in

ClearCase
ClearCase


ClearCase

ClearCase
ClearCase


ClearCase
VOB

contributor
src
include
.contrib

ClearCase
ClearCase


src
src

Z:\test>cleartool
Z:\test>cleartool ls
ls src
src
src@@\main\LATEST
src@@\main\LATEST
src@@\main\LATEST\date.c@@
src@@\main\LATEST\date.c@@
src@@\main\LATEST\hello.c@@
src@@\main\LATEST\hello.c@@
src@@\main\LATEST\hello.h@@
src@@\main\LATEST\hello.h@@
src@@\main\LATEST\util.c@@
src@@\main\LATEST\util.c@@
Z:\test>cleartool
Z:\test>cleartool ls
ls src
src
src@@\main\enhance\LATEST
src@@\main\enhance\LATEST
src@@\main\enhance\LATEST\clock.c@@
src@@\main\enhance\LATEST\clock.c@@
src@@\main\enhance\LATEST\hello.c@@
src@@\main\enhance\LATEST\hello.c@@
src@@\main\enhance\LATEST\hello.h@@
src@@\main\enhance\LATEST\hello.h@@
src@@\main\enhance\LATEST\util.c@@
src@@\main\enhance\LATEST\util.c@@

\main

\enhance

src@@\main\
LATEST
date.c
hello.c
hello.h
util.c

src@@\main\
enhance\LATEST
clock.c
hello.c
hello.h
util.c

ClearCase
ClearCase

contributorchecked in
Check out
checked-out

enhancemain
check in src@@\main\enhance\LATEST

element * CHECKEDOUT
element * \main\LATEST
check out src@@\main\LATEST

ClearCase
ClearCase


Diff Merge

ClearCase
ClearCase


Windows Explorercleartool ls

Z:\test>cleartool ls src
src@@\main\LATEST
src@@\main\LATEST\clock.c@@
src@@\main\LATEST\date.c@@
src@@\main\LATEST\hello.c@@
src@@\main\LATEST\hello.h@@
src@@\main\LATEST\util.c@@

\main

\enhance
src@@\main\
LATEST
clock.c
date.c
hello.c
hello.h
util.c

ClearCase
ClearCase


ClearCase

ClearCase
ClearCase

Merging an Unreserved Checkout

unreserved checkout
checked incheckin

unreserved checkoutchecked in

ClearCase
ClearCase

Merging an Unreserved Checkout

checkin
ClearCase
ClearCase


ClearCase

ClearCase
ClearCase

Merge Manager

Merge Manager
Merge Manager

ClearCase
ClearCase

Merge Manager

ClearCase
ClearCase

Merge Manager

ClearCase
ClearCase

Merge Manager

ClearCase
ClearCase

Merge Manager

ClearCase
ClearCase

FindWizard
Find

ClearCase
ClearCase

Merge
Properties of VersionCustom tab

ClearCase
ClearCase


ClearCase

ClearCase
ClearCase

text_filescompressed_text_files

filename.ann
cleartool annotate
-fmt

ClearCase
ClearCase

Cleartool annotate
Z:\test\src>cleartool annotate util.c
Annotated result written to "util.c.ann".

ClearCase
ClearCase