Before accessing files not loaded into snapshot views

Tip: If you are working in a UCM project that uses multiple streams, to access the versions of files in a team member's development stream, attach a new view to the development stream.

A snapshot view contains only the set of elements that you specify in the load rules of your view. (In UCM, by default, your view loads all of your project source files.)

When you restrict the scope of a view, it contains only a subset of elements in the VOB. During the course of a development cycle, you may need to see a version of an element that is not loaded into your snapshot view.

You can view nonloaded files or copy them into your view for build purposes, but you cannot check them out. Only file elements that are loaded into your view can be checked out.

Listing all elements in the VOB namespace

You can use the cleartool ls command to see all elements in the VOB namespace, even if they are not loaded into your snapshot view. This command lists the names of elements cataloged in the VOB namespace that your view config spec selects. The output of cleartool ls includes this information:
  • The version ID of the particular version that the view selects
  • The version selection rule in the config spec that selects this version
Windows tip: If you are using a Windows system, you can also set up HCL VersionVault Windows Explorer to provide a directory listing of nonloaded file and directory elements. When the Show nonloaded snapshot view elements option is set, the version of the element that would be selected if the element were loaded in your view is displayed. The Version column in the Details pane indicates which version the view is selecting. Then, you can display the nonloaded element history, version tree, and property sheet, and compare versions of the element.

Viewing the contents of a nonloaded versions

To access a version of a file not loaded into your view, use the cleartool get command, which copies the version you specify into your view.

Windows tip: To see the contents of a version of a nonloaded element, you can use the Send To command from the version pop-up menu in the Version Tree Browser. The Send To command uses the set of shortcuts in your Send To folder, which is a function that the Windows® operating system provides.

You cannot use cleartool get or the Send To command for directory elements.

Seeing metada for nonloaded versions

To see HCL VersionVault information about the element that is not loaded into your snapshot view, use the following browsers:
  • Version Tree Browser: displays the version tree of an element.
  • History Browser: displays event records related to versions of an element.
  • HCL VersionVault property sheet of an element: displays its name, creator and creation date, and any labels attached to the version currently selected by the config spec.
Windows tip: You can use the VersionVault Windows Explorer to view metadata for nonloaded versions if the Show nonloaded snapshot view elements option is set, as indicated in Listing all elements in the VOB namespace.