PI24692: THE WOLA THREE-PART NAME ALLOWS MIXED CASE WHILE THE CBIND CLASS PROFILE THEY MUST MATCH REQUIRES UPPER-CASE

8.5.5.4: WebSphere Application Server V8.5.5 Fix Pack 4
8.5.5.5: WebSphere Application Server V8.5.5 Fix Pack 5
8.5.5.6: WebSphere Application Server V8.5.5 Fix Pack 6
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.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.5.5.12: WebSphere Application Server V8.5.5 Fix Pack 12
8.5.5.13: WebSphere Application Server V8.5.5 Fix Pack 13
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.14: WebSphere Application Server V8.5.5 Fix Pack 14
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

• WOLA support provides the ability to code a three-part name in
  the Liberty server's server.xml file that will serve as the
  unique WOLA server name for use with the BBOA1REG API.  This
  three-part name is allowed to be mixed case, such as:
  
  <zosLocalAdapters
           wolaGroup="group"
           wolaName2="name2"
           wolaName3="name3" />
  
  However, the required CBIND class profile that protects access
  to the server and controls who may register in with BBOA1REG is
  upper-case only.  So the above WOLA server name would not match
  the CBIND class since, when stored in RACF, it automatically be
  upper-cased to:
  
  BBG.WOLA.GROUP.NAME2.NAME3
  
  If a user attempts to use this mismatched configuration, they
  will get a RC=12 or RC=14 on BBOA1SRV (if hosting a service) or
  BBOA1INV (if sending a request).
  

Local fix

• 1) Define the WOLA three-part server name values in upper-case
  in the server.xml
  2) Create the CBIND profile as BBG.WOLA.*
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:  Users of IBM WebSphere Application Server   *
  *                  Liberty Profile with WebSphere Optimized    *
  *                  Local Adapters on z/OS                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: WebSphere Optimized Local Adapters      *
  *                      server name does not match the CBIND    *
  *                      class. RC=12 or RC=14 returned from     *
  *                      BBOA1SRV (if hosting a service) or      *
  *                      BBOA1INV (if sending a request).        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  WebSphere Optimized Local Adapters support provides the ability
  to code a three-part name in the Liberty server's server.xml
  file that will serve as the unique WebSphere Optimized Local
  Adapters server name for use with the BBOA1REG API. This three-
  part name is allowed to be mixed case, such
  as:  <zosLocalAdapters          wolaGroup="group"
  wolaName2="name2"          wolaName3="name3" />  However, the
  required CBIND class profile that protects access to the server
  and controls who may register in with BBOA1REG is upper-case
  only. So the above WebSphere Optimized Local Adapters server
  name would not match the CBIND class since, when stored in RACF,
  it automatically be upper-cased
  to:  BBG.WOLA.GROUP.NAME2.NAME3  If a user attempts to use this
  mismatched configuration, they will get a RC=12 or RC=14 on
  BBOA1SRV (if hosting a service) or BBOA1INV (if sending a
  request).
  

Problem conclusion

• The WebSphere Optimized Local Adapter service has been updated
  to check the case of the name. When lowercase letters are found,
  the service now forces the lowercase letters to uppercase, and
  issues the newly-created warning message, CWWKB0502W.   The fix
  for this APAR is currently targeted for inclusion in fix pack
  8.5.5.4.  Please refer to the Recommended Updates page for
  delivery information:
  http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
  

Temporary fix

• 1) Define the WOLA three-part server name values in upper-
  case in the server.xml 2) Create the CBIND profile as
  BBG.WOLA.*
  

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

  WEBSPHERE FOR Z

• Fixed component ID

  5655I3500

Applicable component levels

• R850 PSY

     UP