About creating UCM activities in a project enabled for Rational ClearQuest

In a project that is enabled for Rational® ClearQuest®, an activity usually refers to two objects that are linked together: a UCM activity object and a record in a Rational ClearQuest user database whose record type is enabled for UCM. The process of creating an activity in a project that is enabled for Rational ClearQuest entails the creation of two objects in a specific order:

1. You create records (based on a record type that is enabled for UCM) in a Rational ClearQuest user database.
   • On Windows, you can create records from the Rational ClearQuest client or, if policy permits, from Rational ClearCase® windows (Check Out, Check In, or Add to Source Control).
   • On UNIX, you can create records only from the Rational ClearQuest client.
2. When you set an activity in a view (which you can do by clicking Actions > WorkOn for a Rational ClearQuest user database record), the following occurs:
   • An activity object is created in the stream to which the view is attached.
   • The activity object is linked to the record in the Rational ClearQuest user database whose record type is enabled for UCM.
   • The name of the Rational ClearCase activity is set to match the Rational ClearQuest record's ID.

     You do not create UCM activity objects directly.

Because the name of the Rational ClearCase activity matches the Rational ClearQuest record's ID, you can access the corresponding activity when you are working on a defect by using the current defect number. For example, you can use the following command: cleartool setactivity ClearQuest-record-ID.

Do not change the name of a Rational ClearCase activity, although it is not prevented. If you change an activity name, you cannot use the setactivity command as described.

Note that the Headline field for a Rational ClearCase activity is synchronized with the corresponding field in a Rational ClearQuest record. That is, if you change this field from within either a Rational ClearCase GUI or Rational ClearQuest, the corresponding field in the Rational ClearQuest record or Rational ClearCase activity is modified as well.