PI51777: ZWAS WOLA ABENDC78 RC5C IN CICS TRUE BBOATRUE ON PATH AFTER OLA UNREGISTER API

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.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

• The execution environment is CICS. WebSphere supplies a CICS
  Task Related User Exit named BBOATRUE. This code is used when
  OLA API calls are made in the CICS environment for connection
  to WebSphere servers.
  In the error event the message traffic shows:
  +DFHAP0707 AP06CC24 An abend (code C78/AKEB) has
  occurred in task related user exit program,BBOATRUE.
  BBOA8000I Processing UNREGISTER API request..
  
  BBOA8000I Invoking OLA Unregister API for AP40CC24NYO2..
  
  BBOA8100E An error occurred during Unregister with return code 8
  and
  reason code 76..
  
  Analysis of the dump shows
  * the abending thread was processing a WOLA receive
  request for register name AP40CC24NYO2 and service '*'.
  * there is an uncommon path taken after the call completes,
  which is coded to run in a zWAS address space; but which should
  also be valid for a client / WOLA address space like CICS
  * the code path calls BBOUSHQX which is unable to pick up
  the correct Cell Pool ID for VSM Cpool services because
  ASSBBCBA is not set. This results in the abendC78 rc5c.
  The problem is coincident with the normal stop of a zWAS server
  to which this CICS system had been making cross memory calls.
  (LOGREC or the dump will show abend0D6 for PC numbers that are
  no longer valid).
  APAR taken to fix this code path and prevent the abendC78 rc5c.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:  All users of IBM WebSphere Application      *
  *                  Server for z/OS V8.5                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: When BBOATRUE is invoked from CICS,     *
  *                      an ABENDC78/ABENDSC78 reason code 5C    *
  *                      can occur when BBOUSHQX attempts to     *
  *                      get                                     *
  *                      a cell from a CPOOL.                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The server was stopped while BBOATRUE was PCing to the server.
  The stop caused some pending cleanup to be driven from a
  client address space instead of a server address space.
  The cleanup code calls BBOUSHQX which is unable to pick up
  the correct CPOOL ID because ASSBBCBA is not set in a client
  address space. Calling CPOOL GET with a bad CPOOL ID results
  in a C78 abend with reason code 5C.
  

Problem conclusion

• Updated the code to handle being called from a client address
  space.
  
  APAR PI51777 is currently targeted for inclusion in Fix Pack
  8.5.5.9 of WebSphere Application Server V8.5.
  
  Please refer to the Recommended Updates page for delivery
  information:
  http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
  
  In addition, please refer to URL:
  http://www.ibm.com/support/docview.wss?rs=404&uid=swg27006970
  for Fix Pack PTF information.
  

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

  WEBSPHERE FOR Z

• Fixed component ID

  5655I3500

Applicable component levels

• R850 PSY

     UP