Developing Software, Release 2002.05.00, Windows
1. ClearCase Concepts
1.1 Recommended Reading Paths
1.2 ClearCase Views
Snapshot Views and Dynamic Views
1.3 Versions, Elements, and VOBs
Selecting Elements and Versions
Config Specs for Snapshot Views
Config Specs for Dynamic Views
Criteria for Selecting Versions
Version Labels in Version-Extended Pathnames
Learning the Config Spec Syntax
View-Private Objects
1.4 Parallel Development
1.5 About Rational ClearCase Explorer
The ClearCase Explorer Window
ClearCase Explorer Tool Organization
Toolbox Tab
Shortcut Menu Support
Tool Context
ClearCase Explorer Navigation
View Access
History of Visited Locations
Access to ClearCase Information
Display of ClearCase Information
Initial Use and Appearance
Ongoing Use and Appearance
Features for a New User
1.6 Extended Namespace for Elements, Branches, and Versions
Dynamic View Access Model
1.7 The Base ClearCase-ClearQuest Integration
The Base ClearCase-ClearQuest Schema and User Databases
ClearCase Triggers and ClearQuest Change Requests
Uses of the Base ClearCase-ClearQuest Integration
2. Setting Up a View
2.1 Starting the View Creation Wizard
To Start the View Creation Wizard
2.2 Choosing a Snapshot View or a Dynamic View
2.3 Choosing a Location and Name
Snapshot View: Choosing a Directory
Under the Hood: A Snapshot View Storage Directory
Locations for Snapshot View Storage Directories
To Override the Default Value for a Snapshot View Storage Location
Choosing a View Name
Dynamic View: Choosing a Drive Letter
Pathname Differences
Dynamic View Storage Directories
Choosing Locations for Dynamic View Storage Directories
To Choose a Location for a Dynamic View Storage Directory
2.4 Adding Version-Selection Rules
To Paste or Include Version-Selection Rules
2.5 Snapshot View: Selecting and Loading Elements
To Choose Elements
Case-Sensitivity
Setting Up for a New Development Project
Loading Versions of Elements into a View
Under the Hood: VOB Links
Symbolic Links and Hard Links in Dynamic Views
Symbolic Links in Snapshot Views
Hard Links in Snapshot Views
Caution: Losing Data Because of VOB Hard Links
3. Working in a View
3.1 Accessing Files
Starting Dynamic Views
To Start Dynamic Views
To Activate VOBs
Accessing Snapshot Views
Accessing Views from Windows Explorer
Accessing Snapshot Views from Windows Explorer
Accessing Someone Else's Snapshot View from Windows Explorer
Accessing Dynamic Views from Windows Explorer
3.2 Checking Out Files
To Check Out Files
Using the Open Dialog Box
Checking Out Directories
Reserved and Unreserved Checkouts
To Change the Status of a Checked-Out Version
Setting the Default for Reserved or Unreserved Checkouts
Under the Hood: What Happens When You Check Out a File or Directory
From a Snapshot View
From a Dynamic View
Checking Out Files in a VOB Enabled for ClearQuest
Logging on to a ClearQuest User Database
Using the Base ClearCase-ClearQuest Integration Interface
Associating a Checkout with a ClearQuest Entity
3.3 Working with Checkouts
Viewing an Element's History
To View an Element's History
Comparing Versions of Elements
To Compare with a Predecessor
To Compare with a Version Other Than the Predecessor
To Compare Any Two Files
Tracking Checked-Out Versions
Prototype Builds
3.4 Canceling Checkouts
Under the Hood: Canceling Checkouts
Canceling Directory Checkouts
To Move and Delete Orphaned Elements
To Cancel the Checkout of a Deleted File
3.5 Checking In Files
To Check In Files
Merging with the Latest Version
To Merge with the Latest Version
Under the Hood: Checking In Files
From a Snapshot View
From a Dynamic View
Checking In Files in a VOB Enabled for ClearQuest
View the Versions for a Change Request from ClearQuest
4. Updating a Snapshot View
4.1 Starting an Update Operation
Updating the View
Updating Files and Directory Trees
Tip: Finding a Set of Files
4.2 Under the Hood: What Happens When You Update a View
4.3 Unloading Elements
Unloading Files
Unloading Directories
5. Working On a Team
5.1 The Version Tree
Under the Hood: The Initial Version on a Subbranch
5.2 Working on Branches
The Version-Extended Pathname
5.3 Merging
Under the Hood: How ClearCase Merges Files and Directories
File Merge Algorithm
Determination of the Base Contributor
Recording of Merge Arrows
Locating Versions with Merge Hyperlinks
Directory Merge Algorithm
Merging Directories
Using ln and rmname in Diff Merge
Scenario: Merging All Changes Made on a Subbranch
Task Overview
Getting More Information
Scenario: Selective Merge from a Subbranch
Merging a Range of Versions
Task Overview
Getting More Information
Scenario: Removing the Contributions of Some Versions
Task Overview
Getting More Information
Recording Merges That Occur Outside ClearCase
Getting More Information
5.4 Sharing Control of a Branch with Developers at Other Sites
To Request Mastership of a Branch and Wait for the Transfer
To Check Out the Branch Before Mastership Is Transferred
Requesting Mastership After the Checkout
Setting the Default for Nonmastered Checkouts
Troubleshooting
6. Other Tasks
6.1 Adding Files and Directories to Source Control
To Add Elements to Source Control
Under the Hood: What Happens When You Add a File or Directory to Source Control
File Types and Element Types
Access Mode
Conversion of View-Private Files to Elements
Conversion of Nonshareable Derived Objects to Elements
Creation of Directory Elements
Auto-Make-Branch During Element Creation
Creation of Elements in Replicated VOBs
Element Object and Version References
Storage Pools
Group Membership Restriction
To Add Elements for a New Development Task
Importing Files
6.2 Moving, Removing, and Renaming Elements
Moving and Removing Elements
To Move an Element Within a VOB
To Move an Element to Another VOB
To Remove an Element Name from a Directory
Other Methods for Removing Elements
Renaming Elements
To Rename an Element
6.3 Accessing Elements Not Loaded into a Snapshot View
Listing All Elements in the VOB Namespace
To See Nonloaded Elements from ClearCase Explorer
To See Metadata for Nonloaded Versions
Viewing the Contents of a Nonloaded Version
To Copy a Nonloaded Version with cleartool get
6.4 Adjusting the Scope of a View
To Change Which Elements Are Loaded into a Snapshot View
Excluding Elements
To Load an Empty Version of an Element
Activating or Deactivating VOBs in Dynamic Views
To Deactivate VOBs
To Change the Versions the View Selects
6.5 Assigning Snapshot Views to Drive Letters
Making a Directory Shareable and Assigning a Drive Letter
To Enable Sharing on the Snapshot View Root Directory
To Assign the Snapshot View Shared Directory to a Drive Letter
Using the subst Command for Snapshot View Access
6.6 Registering a Snapshot View
To Access Another's Snapshot View from ClearCase Explorer
To Register Another's Snapshot View for Windows Explorer Use
6.7 Moving Views
Changing the Physical Location of a Snapshot View
To Find the Location of the View Storage Directory
Update After Moving
Moving a View Storage Directory
6.8 Regenerating a Snapshot View's view.dat File
To Regenerate the view.dat File
6.9 Accessing Views and VOBs Across Platform Types
Creating Views Across Platforms of Different Types
Snapshot View Characteristics and Operating-System Type
Accessing Views Across Platforms of Different Types
Accessing UNIX Snapshot Views from Windows Hosts
Accessing Windows Snapshot Views from UNIX Hosts
Accessing UNIX Dynamic Views from Windows Hosts
Accessing Windows Dynamic Views from UNIX Hosts
Accessing VOBs Across Platforms of Different Types
Developing Software Across Platforms of Different Types
A. Working in a Snapshot View While Disconnected from the Network
A.1 Setting Up a View for Your Hardware Configuration
Under the Hood: Location of the View Storage Directory in Disconnected-Use Configurations
A.2 Preparing the View
A.3 Disconnecting the View
Hardware Configuration: View on a Laptop
To Deactivate ClearCase Integrations
Hardware Configuration: View on a Removable Storage Device
Hardware Configuration: View Copied to a Storage Device
A.4 Working in the View
Hijacking a File
To Hijack a File
Finding Modified Files While Disconnected
A.5 Reconnecting to the Network
Hardware Configuration: View on a Laptop
Hardware Configuration: View on a Removable Storage Device
Hardware Configuration: View Copied to a Storage Device
A.6 Using the Update Tool
Determining How to Handle Hijacked Files
To Find Hijacked Files
To Compare a Hijacked File to the Version in the VOB
To Check Out a Hijacked File
Merging the Latest Version to a Hijacked File
To Undo a Hijack
Under the Hood: How ClearCase Determines Whether a File is Hijacked
Other Ways to Handle Hijacked Files
Updating the View
