rmregion
Unregisters a ClearCase® network region
Applicability
Product |
Command type |
---|---|
ClearCase |
cleartool subcommand |
Platform |
---|
UNIX |
Linux |
Windows |
Synopsis
- rmregion –tag region-tag [ –rma/ll [ –pas/sword tag-registry-password ] ]
Description
The rmregion command removes a region entry from the ClearCase registry's regions file.
rmregion modifies the ClearCase registry only. It does not affect client host region assignments. If you remove a region to which ClearCase client hosts are assigned, those clients receive error messages.
To reassign a client host to a new region:
- On UNIX or Linux, run a command like the following on the
client host:
echo "region2" > /var/adm/devops/clearcase/rgy/rgy_region.conf
- On Windows, open the ClearCase Control Panel on the client, click the Registry tab, and type the new region name in the Windows Region field
Restrictions
None.
Options and arguments
Specifying the region tags
- Default
- None. You must specify the name of the region to unregister.
- –tag region-tag
- Specifies a region to unregister.
- –rma/ll [ –pas/sword tag-registry-password ]
- Removes the region specified with –tag, along with any view tags and VOB tags in that region. If the region contains VOB tags, you must supply the VOB tag registry password (either with the –password option or at the prompt).
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 region devel3 from the ClearCase registry.
cmd-context rmregion –tag devel3
- Remove all tags for the test1 region.
cmd-context rmregion –tag test1 –rmall
UNIX and Linux files
- /var/adm/devops/clearcase/rgy/regions
- /var/adm/devops/clearcase/config/rgy_region.conf
Windows files
- ccase-home-dir\var\rgy\regions