endview

Deactivates a ClearCase view

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

endview [ -ser·ver ] view-tag

DESCRIPTION

Deactivates the specified ClearCase view. The exact behavior varies according to the kind of view.

We recommend against deactivating a view for the purpose of backing it up.

Dynamic View

The endview command deactivates the dynamic view. It removes all references to the view from the ClearCase MVFS on the current host. The view-tag disappears from the MVFS directory (by default, M:\). The -server option terminates the view's view_server process. Without -server, endview does not affect the view's availability from computers other than the current one.

If a Windows drive was assigned to the view, the drive is marked unavailable in the drive table (see the net use command) and can be reused.

In a mixed UNIX/Windows environment, any NFS drive that was mounted to support access to the view storage directory gets unmounted (assuming no other active views or VOBs require it).

In Attache, if you execute endview for a view associated with the current workspace, the command fails with the message

Cannot stop the view associated with the current workspace.

CAUTION: Processes set to or associated with a view are stranded if you deactivate that view without exiting the processes. This can cause MVFS activities to fail. To recover from this situation, use startview to restart the view on all computers that were using it, or kill the processes manually with the Task Manager. To avoid this situation, follow these guidelines:

• Before running endview (without -server) on your computer, exit all processes on your computer that are set to or associated with the view. This includes any processes started by other users. If the processes are running when you deactivate the view, they will be stranded.
• Before running endview -server, exit all processes set to or associated with the view. This includes processes on other computers and/or processes started by other users.

Snapshot View

When issued with the -server option, endview ends the view's view_server process on the host where the view-storage directory resides. Any ClearCase command issued from the view-storage directory restarts the snapshot view's view_server process.

endview used without the -server option has no effect on a snapshot view.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions are required unless you specify the -server option, in which case you must have permission to modify the view. Locks: No locks apply.

OPTIONS AND ARGUMENTS

STOPPING THE VIEW SERVER.   Default: endview does not stop the view's view_server process; the view remains accessible from other network hosts.

-ser·ver

Terminates the view's view_server process.

SPECIFYING THE VIEW TO DEACTIVATE.   Default: None. You must supply a view-tag.

view-tag

Deactivates view view-tag if view-tag specifies a dynamic view. If view-tag specifies a snapshot view, -server must also be specified to deactivate the view.

EXAMPLES

Examples including wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.

In cleartool single-command mode, cmd-context represents the command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

• Deactivate the dynamic view r3_main on the local host. Do not terminate the view_server process.

cmd-context endview r3_main

• Same as previous example, but terminate the view_server process, making the view termporarily unavailable to all hosts.

cmd-context endview -server r3_main

• Stop and restart the dynamic view alh_main, which is currently assigned to drive w:.

cmd-context endview alh_main

cmd-context startview alh_main

net use
...
Unavailable W:    \\view\alh_main       ClearCase Dynamic Views
...

net use w: \\view\alh_main
Command completed successfully.

• Deactivate the snapshot view r4_main.

cmd-context endview -server r4_main

SEE ALSO

startview, view, view_server