rmtag

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

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

• Remove a view-tag:

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

• Remove a VOB-tag:

  rmtag -vob [ -reg·ion network-region | -a·ll ]

  
  

  [ -pas·sword tag-registry-password ] vob-tag ...

DESCRIPTION

The rmtag command removes one or more entries from the network's view_tag registry file or vob_tag registry file. See the registry_ccase reference page for a discussion of registry files.

Restrictions

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 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.

When deleting a public VOB-tag, you must supply the network's VOB-tag password; if you don't use the -password option, you are prompted for the password. See the rgy_passwd and registry_ccase reference pages for information on the VOB-tag password.

PERMISSIONS AND LOCKS

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

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 registry_ccase reference page 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

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 the view-tag R2alpha from the view registry.

cmd-context rmtag -view R2alpha

• Remove the VOB-tag \tests from all network regions.

cmd-context rmtag -vob -all -password mypassword \tests

SEE ALSO

mktag, mkview, mkvob, registry_ccase, rgy_passwd, rmview, rmvob