IBM Support

Renaming the VOB tag of a UCM Component

Question & Answer


Question

How can I rename the VOB tag of a IBM® Rational® ClearCase® UCM component and how does this affect the UCM component object?

Answer

Components are the UCM mechanism for simplifying the organization of your files and directories.
The directory and file elements of a component reside in a single VOB, the top directory of the directory tree is referred to as the Component Root Directory (CRD).

If the VOB is a single Component VOB then the CRD is the VOB tag. If the VOB contains multiple components, then the CRD of each component is a sub directory under the VOB tag.

  • A CRD that is located within a Multiple Component VOB cannot be renamed
  • Renaming the component (as detailed in Document 330047 "Renaming a UCM Component") does rename the UCM Object, but does not rename its CRD

The VOB tag of a Single Component VOB can only be changed (renamed) using the cleartool sub-commands, rmtag and mktag, as detailed in Document 75327 "Renaming a ClearCase VOB or View".
The following Example has been provided to illustrate how the VOB tag of a component VOB can be renamed, but still point to the same component object that has not been renamed.


Example:

Changing VOB Tag for UCM Component
These steps only illustrate how to rename the \VOB-tag to match the name of the UCM component.

If you are interested in renaming both the \VOB-tag and the VOB storage directory refer to Document 75327 "Renaming a ClearCase VOB or View" for those directions.

  1. A cleartool lscomp -long will show the current root directory of the component:
    %>cleartool lscomp -long Comp1@\PVOB
    "Comp1"
    21-Mar-03.12:08:19 by jdoe.user@host1
     root directory: "\test_vob"

      owner: jdoe
     group: user

     
  2. A cleartool lsvob returns the \VOB-tag and its global path:
    %>cleartool lsvob \test_vob
      \test_vob           \\Host1\vobs\test_vob.vbs        private
    Note: The VOB should not be mounted. If it is, use cleartool umount to unmount it before proceeding with the following steps.
     
  3. Use cleartool rmtag to remove the VOB-tag:
    %>cleartool rmtag -vob \test_vob
     
  4. Use cleartool mktag to create a new VOB-tag:
    %>cleartool mktag -vob -tag \Comp1 \\host1\vobs\test_vob.vbs
     
  5. A cleartool lscomp now shows the updated VOB root directory:
    %>cleartool lscomp -long Comp1@\PVOB
    "Comp1"
    21-Mar-03.12:08:19 by jdoe.user@host1
     root directory: "\Comp1"
     owner: jdoe
     group: user

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSSH27","label":"Rational ClearCase"},"ARM Category":[{"code":"a8m0z000000bo3JAAQ","label":"ClearCase-\u003EUCM"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
16 March 2023

UID

swg21144219