rmtag

Removes a view tag or a VOB tag from the networkwide storage registry

APPLICABILITY

ProductCommand type
ClearCasecleartool subcommand
ClearCase LTcleartool subcommand

Platform
UNIX
Windows

SYNOPSIS

  • ClearCase—Remove a view tag:
    rmtag –vie·w [ –reg·ion network-region | –a·ll ] view-tag ...

  • ClearCase—Remove a VOB tag:
    rmtag –vob [ –reg·ion network-region | –a·ll ]
    [ –pas·sword tag-registry-password ] vob-tag ...

  • ClearCase LT—Remove a view or VOB tag:
    rmtag { –vie·w view-tag ... | –vob vob-tag ... }

DESCRIPTION

The rmtag command removes one or more entries from the network's view tag registry or VOB tag registry. For a discussion of the registries, see the Administrator's Guide. You cannot remove a tag that is currently in use.

ClearCase—Using rmtag

A VOB tag is in use if the VOB is active on any host in the network region. Use the cleartool umount command to deactivate a VOB on all hosts in the region before removing its tag.

A view tag for a dynamic view is in use if any user process is set to the view specified by this tag, or if any user process has a current working directory that is a view-extended pathname based on this tag.

A VOB or view must always have a tag in its home region: the network region of the host where the VOB or view storage directory physically resides. If you remove a home-region tag, create a new one immediately.

You must supply the network's VOB tag password when deleting a public VOB tag; if you don't use the –password option, you are prompted for the password. For information on the VOB tag password, see the rgy_passwd reference page.

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.

Note: In the UNIX examples that follow, arguments and output that show multicomponent VOB tags are not applicable to ClearCase LT, which recognizes only single-component VOB tags. In this manual, a multicomponent VOB tag is by convention a two-component VOB tag of the form /vobs/vob-tag-leaf—for example, /vobs/src. A single-component VOB tag consists of a leaf only—for example, /src. In all other respects, the examples are valid for ClearCase LT.

  • Remove the view tag R2alpha from the view registry.

    cmd-context  rmtag –view R2alpha

  • Remove the VOB tag /vobs/tests from all network regions.

    cmd-context rmtag –vob –all /vobs/tests

SEE ALSO

cleartool, hostinfo, mktag, mkview, mkvob, rgy_passwd, rmview, rmvob



Copyright© 2003 Rational Software. All Rights Reserved.