PI38918: VMM API NOT RETURNING VALUE IF ATTRIBUTE NAME CONTAINS SEMICOLON ;

8.0.0.11: WebSphere Application Server V8.0 Fix Pack 11
8.5.5.7: WebSphere Application Server V8.5.5 Fix Pack 7
8.5.5.8: WebSphere Application Server V8.5.5 Fix Pack 8
8.0.0.12: WebSphere Application Server V8.0 Fix Pack 12
8.5.5.9: WebSphere Application Server V8.5.5 Fix Pack 9
8.5.5.10: WebSphere Application Server V8.5.5 Fix Pack 10
8.5.5.11: WebSphere Application Server V8.5.5 Fix Pack 11
8.0.0.13: WebSphere Application Server V8.0 Fix Pack 13
8.5.5.12: WebSphere Application Server V8.5.5 Fix Pack 12
8.0.0.14: WebSphere Application Server V8.0 Fix Pack 14
8.5.5.13: WebSphere Application Server V8.5.5 Fix Pack 13
8.0.0.15: WebSphere Application Server V8.0 Fix Pack 15
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.15: WebSphere Application Server V8.5.5 Fix Pack 15
8.5.5.17: WebSphere Application Server V8.5.5 Fix Pack 17
8.5.5.20: WebSphere Application Server V8.5.5.20
8.5.5.18: WebSphere Application Server V8.5.5 Fix Pack 18
8.5.5.19: WebSphere Application Server V8.5.5 Fix Pack 19
8.5.5.16: WebSphere Application Server V8.5.5 Fix Pack 16
8.5.5.21: WebSphere Application Server V8.5.5.21

APAR status

• Closed as program error.

Error description

• VMM is not returning property values in GET API, if property
  to return is mapped to LDAP attribute subtype which contains a
  semicolon ; in the name.
  
  For example abcd;xyz
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:  All users of IBM WebSphere Application      *
  *                  Server V8.0 and V8.5 virtual member         *
  *                  manager (VMM)                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: VMM is not returning property values    *
  *                      in GET API, if the LDAP attribute       *
  *                      subtype contains a semicolon ; in       *
  *                      name                                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  If an LDAP attribute subtype which contains a semicolon ; in
  the name is mapped to a VMM property, VMM is not returning
  this property's values in GET API.
  For example, the attribute name in LDAP server is abcd;xyz
  The GET API is used internally by WebSphere Application Server
  and could be used by other applications. However, this problem
  only occurs when the name contains a semicolon  ;
  

Problem conclusion

• To fix this, you need to set a new custom property
  "com.ibm.ws.wim.adapter.ldap.returnSubTypeAttrName" with value
  "true". This will return property values in VMM GET API which
  are mapped to an LDAP attribute which contains a semicolon ;
  in the name.
  
  In order to set this property, use the following command:
  
  $AdminTask setIdMgrCustomProperty {-id <LDAP_repos_ID> -name
  com.ibm.ws.wim.adapter.ldap.returnSubTypeAttrName -value true}
  
  Here "LDAP_repos_ID" is the repository id of the LDAP
  configured in VMM. Also save the configuration after running
  the previous command using:
  
  $AdminConfig save
  
  Restart the server
  
  The fix for this APAR is currently targeted for inclusion in
  fix packs 8.0.0.11 and 8.5.5.7.  Please refer to the
  Recommended Updates page for delivery information:
  http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
  

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

  WEBS APP SERV N

• Fixed component ID

  5724H8800

Applicable component levels

• R800 PSY

     UP

• R850 PSY

     UP