rmregion

Unregisters a ClearCase network region

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

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, open the ClearCase Control Panel on the client, click the Registry tab, and enter the new region name in the Windows NT Region field.

See registry_ccase and Administering ClearCase for more information on ClearCase network regions.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions required. Locks: No locks apply.

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

Examples including 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 command interpreter prompt. 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

FILES

ccase-home-dir\var\rgy\regions

SEE ALSO

mkregion, registry_ccase