PM68302: ClearQuest Web does not return error when link is failed to update in DOORS

Rational ClearQuest Fix Pack 3 (9.0.1.3) for 9.0.1
Rational ClearQuest Fix Pack 4 (9.0.1.4) for 9.0.1
Rational ClearQuest Fix Pack 5 (9.0.1.5) for 9.0.1

APAR status

• Closed as program error.

Error description

• IBM Rational ClearQuest Web does not return error when link is
  failed to update in IBM Rational DOORS due to the following
  limitation with ClearQuest DOORS integration:
  
  -There is an exclusive lock is on the requirement module. Users
  should close the module in DOORS client when adding/removing
  links from the ClearQuest Web client. Otherwise, the backlink on
  the requirement module won?t be created or removed.
  
  -Users should have an ?modify? permission on the requirement
  module. Otherwise, the backlink on the requirement module won?t
  be created or removed when adding/removing links from the
  ClearQuest Web client.
  
  Steps to reproduce:
  
  Adding a link from ClearQuest Web
  1. Open a module in a DOORS client.
  2. Modify a record in a ClearQuest Web client.
  3. Go to Links tab and add Implements Request and select an
  object in the DOORS module in step 1.
  4. Save the record.
  5. Open the DOORS module. Notice link to a ClearQuest is not
  created.
  
  Removing a link from ClearQuest Web
  1. Make sure a module is not opened in a DOORS client.
  2. Modify a record in a ClearQuest Web client and add Implements
  Request in Links tab.
  3. Open the module in a DOORS client and make sure link is
  created.
  4. Keep the module open.
  5. Modify the same record in a ClearQuest Web client and remove
  the link added in the step 2.
  6. Check the module in a DOORS client. The link is not removed.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * ClearQuest Web                                               *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * When saving a ClearQuest Web record that creates an OSLC     *
  * link to a DOORS record, if the back link creation in DOORS   *
  * fails, there is no indication seen by the user.              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• A fix is available in ClearQuest 9.0.1.3
  To prohibit ClearQuest Web from saving a record unless the OSLC
  back link creation is successful, the following option can be
  set in cqSiteConfig.pref:
  appOpt$failCommitIfBacklinkCreationFails": "yes",
  When this option is set, ClearQuest will wait for a positive or
  negative response from the OSLC friend before a record will be
  saved.  This can negatively impact performance.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  CLEARQUEST WIN

• Fixed component ID

  5724G3600

Applicable component levels

• R712 PSN

     UP