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 DevOps Code ClearCase® windows (Check Out, Check In, or Add to Source Control).
    • On UNIX® and Linux, 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 DevOps Code 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 DevOps Code 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 DevOps Code 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 DevOps Code ClearCase® activity is synchronized with the corresponding field in a Rational® ClearQuest® record. That is, if you change this field from within either a DevOps Code ClearCase® GUI or Rational® ClearQuest®, the corresponding field in the Rational® ClearQuest® record or DevOps Code ClearCase® activity is modified as well.