rmregion

Unregisters a VersionVault network region

Applicability

Product

Command type

VersionVault

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 VersionVault registry's regions file.

rmregion modifies the VersionVault registry only. It does not affect client host region assignments. If you remove a region to which VersionVault 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/hcl/versionvault/rgy/rgy_region.conf

  • On Windows®, open the VersionVault 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 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 region devel3 from the VersionVault 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/hcl/versionvault/rgy/regions
  • /var/adm/hcl/versionvault/config/rgy_region.conf

Windows® files

  • versionvault-home-dir\var\rgy\regions