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