Troubleshooting
Problem
This technote details how to change the name of an IBM® Rational® ClearCase® UCM activity from the graphical user interface (GUI) or command line interface (CLI).
Resolving The Problem
Every activity has a Headline and an ID. The Headline is the visible description (or name) you see when performing a checkout or checkin of a file within a UCM view, whereas the ID is an internal field that holds the name of the object in the VOB database. These can be identical, but that is not required.
From GUI, both the Headline and ID can be changed from Project Explorer > right-click the activity > select Properties:
From command line (CLI), the Headline can be changed using cleartool chactivity:
cleartool chactivity -headline <new_headline> activity-id
The ID can be changed with cleartool rename:
cleartool rename activity:<old_activity-id> activity:<new_activity-id>
Example:
There are two activities with the same headline, test1, but this can occur because each has an ID that is unique, test1_24942 and test1_27032, respectively:
Y:\Projvob> cleartool lsactivity
29-Nov-99.13:48:56 test1_24942 cpostma "test1"
29-Nov-99.13:59:36 test1_27032 cpostma "test1"
Change the ID of the first activity, from test1_24942 to bugfix:
Y:\Projvob>cleartool rename activity:test1_24942 activity:bugfix
Renamed activity from "test1_24942" to "bugfix".
Y:\Projvob>cleartool lsactivity
29-Nov-99.13:48:56 bugfix cpostma "test1"
29-Nov-99.13:59:36 test1_27032 cpostma "test1"
Change the Headline of the first activity from test1 to bugfix:
Y:\Projvob>cleartool chactivity -headline bugfix bugfix
Changed activity "bugfix".
Y:\Projvob>cleartool lsactivity
29-Nov-99.13:48:56 bugfix cpostma "bugfix"
29-Nov-99.13:59:36 test1_27032 cpostma "test
For more information on cleartool sub-commands used in this technote, refer to IBM Rational ClearCase Command Reference, or run cleartool man <sub-command>.
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21123180