PK19530: ABENDAEIP FOR EXEC CICS INVOKE-WEBSERVICE RETURNING INVREQ

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A receive was completed by the sockets domain and the ECB
  CICS was waiting on was posted.  CICS then takes the
  length of data out of the AIOCB that was used for the
  receive.  It appears CICS read this before it was updated
  by USS so CICS got a data length value of 0 instead of
  x'50' (80 bytes).  The zero length gets passed back to
  DFHWBCL and this causes the OPTIONS toleration code to be
  bypassed and for DFHWBCL to issue further receives to get
  a valid HTTP response even though it already has all the data
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: EXEC CICS INVOKE WEBSERVICE returns     *
  *                      unexpected INVREQ.                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A CICS service requester application uses EXEC CICS INVOKE
  WEBSERVICE to send a SOAP request over HTTP to a remote
  webservice.  DFHWBCL is used to perform the outbound HTTP
  connection.  After the connection is established an HTTP/1.1
  OPTIONS request is sent to the server.  Sockets domain is called
  to receive the response to the OPTIONS request.  The data being
  received is PEEKed allowing it to be examined but remain in
  sockets domain for subsequent receives to obtain it.  This
  receive returns data in the callers buffer, but invalidly
  indicates 0 bytes was returned.
  
  If the response to the OPTIONS request was not a valid HTTP
  response (i.e. was just HTML data) then this causes DFHWBCL to
  issue further receives to wait for more data. CICS has already
  received all of the data from the remote server so the receive
  waits until the connection is eventually closed by the remote
  server. This leads to INVREQ being returned to the service
  requester application and results in an abend AEIP if not
  handled.
  
  A similar problem will occur on EXEC CICS WEB OPEN if the remote
  server does not return a valid HTTP response to the OPTIONS
  request that was sent to it.
  

Problem conclusion

• DFHSOS07 has been altered to return the correct length of data
  (instead of zero) when a RECEIVE with the PEEK_BUFFER option is
  issued.
  

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:

  UK11916

Modules/Macros

•    DESSOSO  DFHSOSOC DFHSOS00 DFHSOS01 DFHSOS02
  DFHSOS03 DFHSOS04 DFHSOS05 DFHSOS06 DFHSOS07 DFHSOS08 DFHSOS09
  DFHSOS10 DFHSOS11 DFHSOS12 DFHSOS13 DFHSOS14 DFHSOS15 DFHSOS16
  DFHSOS17 DFHSOS18 DFHSOS19 DFHSOS20 DFHSOS21 DFHSOS22 DFHSOS23
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK11916

     UP06/02/22 P F602

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.