rmstgloc

Removes registry entries for server storage locations.

APPLICABILITY

ProductCommand type
ClearCasecleartool subcommand
ClearCase LTcleartool 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.) For a discussion of network regions, see the 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 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.

  • 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.

SEE ALSO

cleartool, hostinfo, lsstgloc, mkstgloc, mkview, mkvob, rmview, rmvob



Copyright© 2003 Rational Software. All Rights Reserved.