rmstgloc

Removes registry entries for server storage locations

Applicability

Product	Command type
ClearCase®	cleartool subcommand

Platform
UNIX®
Linux®
Windows®

Description

The rmstgloc command deletes registrations for view and VOB server storage locations. The associated physical storage is not deleted, and views and VOBs residing at the server storage location continue to be accessible. However, no views or VOBs may be created at the server storage location after you have removed its registry entries.

To remove view or VOB physical storage (and their registrations), always use rmview or rmvob, never an operating system command.

Options and arguments

Specifying all qualifying server storage locations

Default: None.
–all: Deletes all server storage locations that are selected by other options and arguments you specify. For example, rmstgloc –all stgloc-name deletes all server storage locations with names that match stgloc-name, regardless of region.

Specifying the network region

Default: The local host's network region. (Use the hostinfo –long command to display the network region.) For a discussion of network regions, see the IBM Rational ClearCase Administrator's Guide.
–reg/ion network-region: Specifies a network region where a server storage location that is to be deleted resides. An error occurs if the region does not already exist.

Specifying the server storage location

Default: None.
stgloc-name: Unregisters the server storage location with the specified name.
–sto/rage stgloc-pname: Unregisters the server storage location specified by the given path.

Examples

The UNIX system and Linux examples in this section are written for use in csh. If you use another shell, you may need to use different quoting and escaping conventions.

The Windows examples that include 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 UNIX system and Linux shells or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt.

Remove the server storage location named stgloc_vob1.
cmd-context rmstgloc stgloc_vob1
cleartool: Warning: The storage location has only been removed from the ClearCase registry. You must manually remove the physical storage location directory.