PI13341: [wi 107844]session.getAsset through GUID makes customer confusing by whether to include curly brackets

Rational Asset Manager Fix Pack 1 (7.5.2.1) for 7.5.2
Rational Asset Manager Fix Pack 2 (7.5.2.2) for 7.5.2
Rational Asset Manager Fix Pack 3 (7.5.2.3) for 7.5.2
Rational Asset Manager Fix Pack 4 (7.5.2.4) for 7.5.2
Rational Asset Manager 7.5.3
Rational Asset Manager 7.5.3.1
Rational Asset Manager 7.5.3.2
Rational Asset Manager 7.5.3.3
Rational Asset Manager 7.5.4
Rational Asset Manager 7.5.4.1
Rational Asset Manager 7.5.4.2
Rational Asset Manager 7.5.4.3
Rational Asset Manager 7.5.4.4
Rational Asset Manager 7.5.4.5
Rational Asset Manager 7.5.4.6
Rational Asset Manager 7.5.4.7
Rational Asset Manager 7.5.4.9
Rational Asset Manager 7.5.4.8
Rational Asset Manager 7.5.4.10

APAR status

• Closed as documentation error.

Error description

• http://pic.dhe.ibm.com/infocenter/ramhelp/v7r5m1/topic/com.ibm.r
  am.doc/topics/r_api_fetchanexistingasset.html
  
  // Fetch an asset by GUID and version (this just pulls down the
  asset's metadata)
    RAMAsset asset = session.getAsset(new
  AssetIdentification('{AC0D54C1-E349-69EC-030F-E51CB557B0D7}',
  '7.1'));
  
  User reported the curly brackets should not be included in GUID,
  else it will cause exception. Yet there are some default assets'
  GUID containing curly brackets. So when user fetch those assets,
  they have to add curly brackets.
  
  Indeed, the Infocenter document would make some confusing, so we
  should add some notes to remind user that GUID has different
  ways.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * RAM                                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * http://pic.dhe.ibm.com/infocenter/ramhelp/v7r5m1/topic/com.i *
  * bm.ram.doc/topics/r_api_fetchanexistingasset.html            *
  *                                                              *
  * // Fetch an asset by GUID and version (this just pulls down  *
  * the asset's metadata)                                        *
  * ¶  RAMAsset asset = session.getAsset(new                     *
  * AssetIdentification("{AC0D54C1-E349-69EC-030F-E51CB557B0D7}" *
  * , "7.1"));                                                   *
  *                                                              *
  * seems the GUID has to contain curly brackets. That is        *
  * confusing.                                                   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• Fixed in
  https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.
  WorkItem/107844
  

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