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