rmregion

Unregisters a ClearCase network region

APPLICABILITY

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,

• UNIX-Run a command like the following on the client host:

echo "region2" > /var/adm/atria/rgy/rgy_region.conf

• Windows-Open the ClearCase Control Panel on the client, click the Registry tab, and enter the new region name in the Windows NT 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 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. In Attache, cmd-context represents the workspace 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 FILES

/var/adm/atria/rgy/regions
/var/adm/atria/rgy/rgy_region.conf

WINDOWS FILES

ccase-home-dir\var\rgy\regions

SEE ALSO

mkregion, Administrator's Guide