Command Reference, Release 2002.05.00, All Platforms

rmstgloc

Removes registry entries for server storage locations.

APPLICABILITY


Product	Command Type
ClearCase	cleartool subcommand
ClearCase LT	cleartool subcommand


Platform
UNIX
Windows

SYNOPSIS

ClearCase:

rmstgloc [ -all ] [ -reg·ion network-region ] { stgloc-name | -sto·rage stgloc-pname }

ClearCase LT:

rmstgloc { stgloc-name | -sto·rage stgloc-pname }

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.

RESTRICTIONS

The specified server storage locations must not contain any views or VOBs.

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.) See the Administrator's Guide for a discussion of network regions.

-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 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 shell or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace 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.