Change the name of an activity from GUI or CLI

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 activity-id

The ID can be changed with cleartool rename:

cleartool rename activity: activity:

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