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.
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.
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.
Copyright© 2003 Rational Software. All Rights Reserved.