IBM Support

Change the name of an activity from GUI or CLI

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



[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM: Activity","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF015","label":"IRIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"2002.05.00;2003.06.00","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM: Activity","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21123180