PI37762: CQ-DNG INTEGRATION. BACKLINKS IN CQ ARE NOT CREATED IF THE CQ RECORD HAS ANY NON-EMPTY READ-ONLY MULTILINE FIELD

Rational ClearQuest Fix Pack 10 (8.0.1.10) for 8.0.1
Rational ClearQuest Fix Pack 11 (8.0.1.11) for 8.0.1
Rational ClearQuest Fix Pack 12 (8.0.1.12) for 8.0.1
Rational ClearQuest Fix Pack 13 (8.0.1.13) for 8.0.1
Rational ClearQuest Fix Pack 14 (8.0.1.14) for 8.0.1
Rational ClearQuest Fix Pack 15 (8.0.1.15) for 8.0.1
Rational ClearQuest Fix Pack 16 (8.0.1.16) for 8.0.1
Rational ClearQuest Fix Pack 17 (8.0.1.17) for 8.0.1
Rational ClearQuest Fix Pack 18 (8.0.1.18) for 8.0.1
Rational ClearQuest Fix Pack 19 (8.0.1.19) for 8.0.1
Rational ClearQuest Fix Pack 20 (8.0.1.20) for 8.0.1
Rational ClearQuest Fix Pack 21 (8.0.1.21) for 8.0.1
Rational ClearQuest Fix Pack 22 (8.0.1.22) for 8.0.1
Rational ClearQuest Fix Pack 23 (8.0.1.23) for 8.0.1
Rational ClearQuest Fix Pack 24 (8.0.1.24) for 8.0.1
Rational ClearQuest Fix Pack 25 (8.0.1.25) for 8.0.1

APAR status

• Closed as program error.

Error description

• On the CQ-DNG integration, creating a link from a DNG
  requirement to a CQ record fails to create the backlink to the
  requirement in CQ if the record contains any multiline read-only
  field that is not empty.
  
  This can be reproduced with the OOB DefectTracking schema, with
  OSLCLinks package applied and setting the Description field as
  read-only for specific states. Core trace captures the error:
  "The field "Description" cannot be modified because it is
  currently read-only."
  

Local fix

• Modifying the schema to make the field optional resolves the
  problem. A suitable workaround  consisting in setting the
  behavior of the field using hook code. The code would be
  checking the value of the session variable "_OSLC_LINK_UPDATE"
  and it would be setting the behavior of the field to OPTIONAL if
  the value is "true". Otherwise it would set it to READONLY. This
  would be the code, in VBASIC:
  
  Function description_Permission(fieldname, username)
    ' fieldname As String
    ' username As String
    ' description_Permission As Long
    ' record type name is Defect
    ' field name is Description
  
      set session = GetSession
      OSLCLinkUpdate = session.NameValue("_OSLC_LINK_UPDATE")
      If OSLCLinkUpdate = "true" Then
          description_Permission = AD_OPTIONAL
      Else
          description_Permission = AD_READONLY
      End If
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * ClearQuest Web                                               *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * When using the ClearQuest - DOORs Next Genertaion            *
  * integration, creating a link from a DNG requirement to a CQ  *
  * record fails to create the backlink to the requirement in CQ *
  * if the record contains any multiline read-only field that is *
  * not empty.                                                   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• A fix is available in ClearQuest 8.0.1.10.
  ClearQuest no longer tries to update read-only multiline data
  that has not changed when linking from DOORs.
  

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

• R801 PSY

     UP