Thursday, December 11, 2008

How file/directory checkouts are canceled

 
How file/directory checkouts are canceled
How file checkouts are canceled
  • When you cancel the checkout of a file element, the request is handled as follows:
  • You have prompted to rename the fie in your view to filename.keep
  • The VOB is notified that you no longer have the version checked out in your view
  • In a snapshot view, the version that was in your view when you performed the checkout operation is copied from the VOB
  • In a dynamic view, the version-selection rules in the config spec are used to select a version.
 
How directory checkouts are canceled
  • When you cancel a directory checkout, the VOB is notified that you no longer have the version of the directory checked out to your view. But you are not prompted to rename a canceled directory checkout to directory-name.keep.
  • If you cancel a directory checkout after any changes you made to rename,move, create link will lost. Any new elements you created (with mkelem or mkdir) become orphaned. But pls note that if you just only modify the content (add/remove/update lines) in the file and check in the file, the file version and its content is still there although you undo check out against that folder.
 
Orphaned elements are moved to the VOB lost+found directory under names of this form:
element-anme.UUID
 
In a snapshot view, view-private objects are not removed nor is the update operation for the directory in the view started. To return the directory in your view to its state before you checked it out, you must start the Update Tool.
Action Result after undo checkout its parent directory Input into lost+found
rename element stay in the view but the Kind is view-private No
create dir and add to source control stay in the view but the Kind is view-private Yes
create element and add to source control stay in the view but the Kind is view-private Yes
create link and add to source control stay in the view but the Kind is view-private No
delete element can not show again until you update the view No
 
 
In a dynamic view, view-private objects are not removed, but the view does revert to its previous state.
Action Result after undo checkout its parent directory Input into lost+found
rename element recover the name to its previous one No
create dir and add to source control dispear Yes
create element and add to source control dispear Yes
create link and add to source control dispare No
delete element show again No
 
To move the elements from the lost+found directory
  • To move an element from the lost+found directory to another dirctory within the VOB, use the cleartool mv command.
  • To move an element from the lost+found directory to another VOB, use the relocate command.
 
To delete an element in the lost+found directory
  • To delete an element in the lost+found directory permanently, use rmelem command.
 

No comments: