PM51701: Example code in the API reference results in an error

Rational ClearQuest Fix Pack 03 (8.0.0.3) for 8.0
Rational ClearQuest Fix Pack 11 (8.0.0.11) for 8.0
Rational ClearQuest Fix Pack 12 (8.0.0.12) for 8.0
Rational ClearQuest Fix Pack 13 (8.0.0.13) for 8.0
Rational ClearQuest Fix Pack 14 (8.0.0.14) for 8.0
Rational ClearQuest Fix Pack 15 (8.0.0.15) for 8.0
Rational ClearQuest Fix Pack 16 (8.0.0.16) for 8.0
Rational ClearQuest Fix Pack 17 (8.0.0.17) for 8.0
Rational ClearQuest Fix Pack 18 (8.0.0.18) for 8.0
Rational ClearQuest Fix Pack 19 (8.0.0.19) for 8.0
Rational ClearQuest Fix Pack 20 (8.0.0.20) for 8.0
Rational ClearQuest Fix Pack 21 (8.0.0.21) for 8.0

APAR status

• Closed as documentation error.

Error description

• Example code in the ClearQuest API Command Reference help for
  the GetInstalledMasters method results in an error.
  
  The code example:
  
  set sessionObj = GetSession
  Dim dbSets, masterDBs
  set dbSets = sessionObj.GetInstalledMasters (dbSets, masterDBs)
  For Each db in dbSets
    ? ...
  Next
  
  results in the error: Object
  required:?sessionObj.GetInstalledMasters (...)?
  
  To get it working, change the 3rd line to:
  sessionObj.GetInstalledMasters dbSets, masterDBs
  

Local fix

Problem summary

• Example code in the ClearQuest API Command Reference help of the
  GetInstalledMasters method results in an error.  Here is the
  corrected example; note that the parentheses have been removed
  in line 3:
  
  set sessionObj = GetSession
  Dim dbSets, masterDBs
  set dbSets = sessionObj.GetInstalledMasters dbSets, masterDBs
  For Each db in dbSets
    ? ...
  Next
  
  results in the error: Object
  required:`sessionObj.GetInstalledMasters (...)
  

Problem conclusion

• In the ClearQuest API Command Reference help for the
  GetInstalledMasters method, fixed line 3 in the code example to
  remove the embedded parentheses.
  
  The fix will appear in the next release in which the ClearQuest
  API Command Reference help is updated.
  

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

Applicable component levels