Before removing a view

Removing a view permanently deletes the view and its related records from a VOB. Complete removal of a view entails:

  • Removing the view storage directory
  • Killing its associated view_server process, if the view is currently active
  • Removing the view information from the view registry
  • Deleting all view-private files and directories
  • For a UCM view, removing view-related records from all accessible VOBs
  • For a dynamic view, removing derived objects (DOs) and the entry for the view in the view root directory (by default, /view (on Linux and UNIX systems) or drive M (on Windows® systems))
  • For a snapshot view, removing the snapshot view root directory and its contents

Because of these actions, you must be sure that the current working directory is not within the view context or view storage area that you are deleting. By default, a view is not removed if any element is checked out to that view. For more information about removing a view, see the rmview reference page in the VersionVault Command Reference.

Before you remove a view, follow this procedure:

  • On Linux® and the UNIX system
    1. Access the view to be removed.
    2. Check in or cancel all checkouts in the view to be removed.
    3. For a UCM view, unset activities that are set in the view.
    4. Check for view-private files that are to be kept.
      1. Perform one of the following actions:

        If the view is dynamic, use this command:

        cleartool lsprivate

        If the view is snapshot, use this command:

        cleartool ls -recurse -view_only

      2. Transfer the files to be kept to a directory outside the view that is being removed.
    5. End the view context by performing one of these actions:
      • For a dynamic view, exit all processes set to or associated with the view and use the command cleartool endview -server view-tag to stop the view. This makes the view inaccessible from other network hosts.
      • For a snapshot view, change to another directory.
  • On Windows® systems
    1. In HCL VersionVault Windows Explorer, access the view to be removed.
    2. Check in or cancel all checkouts in the view to be removed.
    3. For a UCM view, unset activities that are set in the view.
    4. Check for view-private files that are to be kept.
      1. In VersionVault Windows Explorer, under the Kind column in the Details pane, inspect the elements labeled View-private.
      2. Transfer the files to be kept to a folder outside the view that is being removed.

You are now prepared to remove the view.