rmstgloc

Removes registry entries for server storage locations

Applicability

Product

Command type

VersionVault

cleartool subcommand

Platform

UNIX

Linux

Windows

Synopsis

rmstgloc [ –all] [ –reg/ion network-region ]
{ 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.

Once a storage location is unregistered, you cannot create views or VOBs using mkview –stgloc or mkvob –stgloc. However, you can create views and VOBs at that storage location using the –host, –hpath and –gpath options.

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

Restrictions

None.

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 Help.
–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 might 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 might 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 VersionVault registry. You must manually remove the physical
    storage location directory.