How checkouts from snapshot views are done

Checkouts from snapshot views are performed differently on the UNIX® system or Linux® than they are on Windows® systems.

Checkouts from snapshot views on Linux or the UNIX systems

When you check out a file or directory from a snapshot view, the request is handled as follows:

  1. The following information is gathered:
    • The version currently loaded in the view
    • The version selected by the config spec (base Rational® ClearQuest®) or stream (UCM)
    • The latest version in the VOB
  2. If the version in your view is not the latest in the VOB, you are notified. If you use the -query option when checking out a file, you are asked to specify which version to check out. If you use the -query option when checking out a directory, you are notified, but you are required to check out the version of the directory currently loaded in your view. The version in your view will not be the latest in the VOB if either of these conditions exist:
    • Someone else has checked in a new version since you last updated your view.
    • Your view config spec selects versions based on a label or a time rule, and the latest version in the VOB falls outside those parameters.
  3. If you check out a version other than the one currently loaded in your view, the checked-out version is loaded into your view.
  4. The VOB is notified which version of the element you checked out.
  5. Files are made writable. For directories, you are allowed to use the mkelem command to add new elements to source control.

Checkouts from snapshot views on Windows systems

When you use the graphical user interface (not the command-line interface) to check out a file or directory from a snapshot view, the request is handled as follows:

  1. The following information is gathered:
    • The version currently loaded in the view
    • The version selected by the config spec (base Rational ClearQuest) or stream (UCM)
    • The latest version in the VOB
  2. If the version of a file in your view is not the latest in the VOB, you are asked to specify which version to check out. For directory elements, you are required to check out the version of the directory currently loaded in your view. The version in your view will not be the latest in the VOB if either of these conditions exist:
    • Someone else has checked in a new version since you last updated your view.
    • Your view config spec selects versions based on a label or a time rule, and the latest version in the VOB falls outside those parameters.
  3. If you check out a version other than the one currently loaded in your view, the checked-out version is loaded into your view.
  4. The VOB is notified which version of the element you checked out.
  5. For files, the Read-Only attribute is removed. For directories, you are allowed to add new elements to source control.