manually removing a ClearCase Web view

Note: The ClearCase Remote Client (CCRC) uses web views, thus these steps apply to CCRC as well.

The proper way to remove a ClearCase Web view is through the web interface or CCRC interface.

If this method is not possible, use the following steps to clean up the view from the RWP server.

1. Open a command prompt and list the view tag you wish to remove:

cleartool lsview -long

C:\>cleartool lsview -long ccweb_view
Tag: ccweb_view
Global path:
Server host: HOST1
Region: dev
Active: NO
View tag uuid:d4487104.e69d4a07.9994.34:50:e0:23:37:97
View on host: HOST1
View server access path: C:\ccweb\user\ccweb_view\view.stg
View uuid: d4487104.e69d4a07.9994.34:50:e0:23:37:97
View attributes: snapshot,webview
View owner: DOM\user

2. Using the View uuid line from the output above, remove the checkout references from the VOB:

cleartool rmview -uuid -all

C:\>cleartool rmview -uuid d4487104.e69d4a07.9994.34:50:e0:23:37:97 -all
Can't remove view "" from VOB while view still exists.

Remove view "" references from VOB anyway? [no] y
Removed references to view "d4487104.e69d4a07.9994.34:50:e0:23:37:97" from VOB host1:e:\ClearCase_Storage\VOBs\multisite_vob.vbs".
Removed references to view "d4487104.e69d4a07.9994.34:50:e0:23:37:97" from VOB "host1:e:\ClearCase_Storage\VOBs\test.vbs".
Removed references to view "d4487104.e69d4a07.9994.34:50:e0:23:37:97" from VOB "host1:e:\ClearCase_Storage\VOBs\private.vbs".


Note: The view uuid can also be obtained from the second line of the ".view" file in the view storage, if that is still present.

3. Unregister the view:

cleartool unregister -view -uuid

C:\>cleartool unregister -view -uuid d4487104.e69d4a07.9994.34:50:e0:23:37:97

4. Remove the view tag

cleartool rmtag -view

C:\>cleartool rmtag -view ccweb_view

5. Remove references to the view in the user's session.dat file.

Note: Every CCWeb/CCRC user has their own session.dat file which contains references to their web views. The session.dat files is stored in the following directory (by default):

Windows®: C:\Program Files\Rational\ClearCase\var\ccweb\\session.dat
UNIX® / Linux®: /var/adm/rational/clearcase/ccweb//session.dat

Open session.dat in a text editor and remove the following lines:

a. For the first line in the file, if you removed the view that shows up after the "-lastview" argument, then delete everything on that first line after -domain .

Note: UNIX and Linux will not have a reference to -domain as it is Windows only. Delete everything after username.

b. If view that appears after the "-lastview" argument is not a view you are removing, then ignore this line.

c. Remove each of the lines in which any views that you removed appears.

Save the modified session.dat file.

Example session.dat file when removing Administrator_web_test5 (before edit):

#########################
-session 4491 -username "Administrator" -domain "CCSUPWEST" -lastpvob "/pvob1" -lastview "Administrator_web_test5"
-session 4847 -viewtag "Administrator_web_dev" -workroot "C:/web_dev" -viewroot "C:\ccweb\Administrator\Administrator_web_dev" -stream "Administrator_testProj_2@\pvob1"
-session 8995 -viewtag "Administrator_web_dev2" -workroot "c:/web_dev2" -viewroot "C:\ccweb\Administrator\Administrator_web_dev2" -stream "Administrator_project3_2@\pvob1"
-session 18484 -viewtag "Administrator_web_test5" -workroot "c:/web_test5" -viewroot "C:\ccweb\Administrator\Administrator_web_test5"

Example Session.dat file (after edit):

##########################
-session 4491 -username "Administrator" -domain "CCSUPWEST"
-session 4847 -viewtag "Administrator_web_dev" -workroot "C:/web_dev" -viewroot "C:\ccweb\Administrator\Administrator_web_dev" -stream "Administrator_testProj_2@\pvob1"
-session 8995 -viewtag "Administrator_web_dev2" -workroot "c:/web_dev2" -viewroot "C:\ccweb\Administrator\Administrator_web_dev2" -stream "Administrator_project3_2@\pvob1"