PI61046: ZWAS: BATCH JOB USING WOLA SERVICE HUNG AFTER SERVER RECYCLE DUE TO WAIT IN BBOCLSCC IN LOCAL COMM CONNECT()

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A Cobol batch job using WOLA service hung indefinitely. A dump
  of the job shows that there is a thread hung waiting for a
  response from a zWAS server that has already been recycled.
  The thread native and linkage stacks show the flow of control
  between the following modules leading up to the wait in BBOCLSCC
  for Comm Local Connect() processing.
  BBOAINV -> BBOAAPI -> BBOATRUP -> BBODPCN8 -> bbodpcrt ->
  BBOCLSCC.
  The root cause is a narrow window between server shutdown and
  application startup.
  This APAR was taken to improve product reliability by augmenting
  the WOLA client to take advantage of the local comm timeout
  introduced by PM61861.
  With this code change the WOLA batch job thread will timeout
  allowing the job to terminate gracefully.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:  Users of WebSphere Application Server       *
  *                  using Optimized local Adapters for          *
  *                  WebSphere V7.0                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: WebSphere Optimized Local Adapter       *
  *                      WOLA) cllents hang when connecting to   *
  *                      a Websphere server that is being        *
  *                      shut down.                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  WebSphere Optimized Local Adapter
  (WOLA) cllents hang when connecting to
  a Websphere server that is being
  shut down.
  

Problem conclusion

• The wait time parameter defined on the WOLA API's BBOA1CNG,
  BBOA1RCA, BBOA1INV and BBOA1SRV is now honored when
  connecting to the server. In addition, a default wait time
  of 60 seconds is used by the BBOA1REG API when establishing
  new connections for the connection pool.
  
  APAR PI61046 is currently targeted for inclusion in Fix Pack
  7.0.0.43 of WebSphere Application Server.
  
  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:

  PI49306

• 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

• R700 PSY UI46199

     UP17/04/24 P F704

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.