rmtag

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

APPLICABILITY

SYNOPSIS

• ClearCase and Attache-Remove a view-tag:

rmtag -vie·w [ -reg·ion network-region | -a·ll ] view-tag ...

• ClearCase and Attache-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. See the Administrator's Guide for a discussion of the registries. You cannot remove a tag that is currently in use.

CleasrCase and Attache-Using rmtag

A VOB-tag is in use if the VOB is active on any host in the network region. Use the cleartool or Attache 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. See the rgy_passwd reference page for information on the VOB-tag password.

RESTRICTIONS

None.

OPTIONS AND ARGUMENTS

SPECIFYING THE KIND OF TAG.  Default: None.

-vie·w

Removes one or more view-tags.

-vob

Removes one or more VOB-tags.

SPECIFYING A NETWORK REGION.  Default: Removes tags that are defined for the local host's network region. (Use the hostinfo -long command to list a host's network region.) See the Administrator's Guide for a discussion of network regions.

-reg·ion network-region

Removes a tag defined for the specified network region. An error occurs if the region does not already exist.

-a·ll

Removes a tag from all network regions for which it is defined.

SPECIFYING THE VOB-TAG PASSWORD.  Default: If you attempt to remove a public VOB-tag, rmtag prompts you for the VOB-tag password. (See also rgy_passwd.)

-pas·sword tag-registry-password

Specifies the password on the command line.

CAUTION: This is a potential security breach, because the password remains visible on your display buffer.

SPECIFYING THE TAGS.  Default: None.

view-tag ..

One or more view-tags to be removed.

vob-tag ..

One or more VOB-tags to be removed.

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.

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

mktag, mkview, mkvob,rgy_passwd, rmview, rmvob