PM96605: DFHSO0002 ERROR CODE X'0325' IN MODULE DFHWBAP AFTER GSK_ERR_UNKNOWN_CA ERROR MESSAGES USING CICS WEB SERVICES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Message DFHSO0002 with error code x'0325' in module DFHWBAP
  after GSK_ERR_UNKNOWN_CA error messages using CICS Web Services.
  
  A HTTP requests a response must be returned so DFHWBEP is
  executed to produce a response back to the client.  The DFHWBEP
  code is loaded from hlq.SDFHLOAD and executes the following API
  commands:
  
  ADDRESS
  GETMAIN
  ASSIGN
  WEB READ HTTPHEADER
  
  The WEB READ HTTPHEADER is looking for header ﾜWSRA. DFHWBAP
  has to find the header from all headers that have been received,
  to do this it creates a local buffer using the size of the
  headers.
  
  Due to the SSL error in the receive the header size is 0
  because no headers were received.  This leads to the GETMAIN
  getting the INVALID_GET_LENGTH response returned from SMGF and
  causes DFHWBAP to call the severe_error.
  
  DFHSMGF was tightened up at 5.1 to return INVALID_GET_LENGTH if
  the length was 0 for variable size subpools. DFHWBAP was missed
  handling this exception returned.
  

Local fix

• No local fix.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHSO0002 Severe error x'0325' within   *
  *                      DFHWBAP when using custom DFHWBEP URM.  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  DFHWBEP URM is called by the WEB domain when an error occurs
  to ensure a response is returned to the client web application.
  Dependent on when the error occurs it's possible that the HTTP
  headers have not been received by CICS.
  
  In this case a customised DFHWBEP was being used which issued
  EXEC CICS WEB READ HTTPHEADER. DFHWBAP attempted to getmain
  an area of storage for the headers but this resulted in a
  getmain for a length of 0, causing storage manager to return
  an EXCEPTION response. DFHWBAP failed to handle the EXCEPTION
  response resulting in the reported msgDFHSO0002 for code x'0325'
  and a system dump.
  

Problem conclusion

• DFHWBAP has been altered to check the length of the headers
  and to return an error if the length is 0.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI12012

Modules/Macros

• DFHWBAPF DFHWBAP
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UI12012

     UP13/11/07 P F311

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.