OA56234: IDEMPOTENT REQUEST RETRY AND EMPTY RSN PHRASE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• HTTP method retry correction and support for empty rsn phrase.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Users of the z/OS HTTP/HTTPS protocol                        *
  * enabler portion of the z/OS client web                       *
  * enablement toolkit.                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * The z/OS HTTP/HTTPS protocol enabler                         *
  * did not correctly handle requests that                       *
  * encountered an immediate receive                             *
  * failure. In addition, the enabler                            *
  * did not correctly handle the scenario                        *
  * where the status line returned from                          *
  * the web server did not contain a                             *
  * reason-phrase.                                               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The z/OS HTTP/HTTPS protocol enabler did not correctly handle
  requests that encountered an immediate receive failure.
  The web standards indicate in the above situation HTTP methods
  GET,HEAD,PUT,DELETE should be automatically retried one more
  time.
  
  In z/OS V2R2, all method types were retried automatically:
                              GET, HEAD, PUT, DELETE, and POST.
  In z/OS V2R3, only GET and HEAD were retried automatically.
  
  The enabler mistook the first response header for a
  reason-phrase when the status line returned from the web server
  did not contain a reason-phrase.
  

Problem conclusion

• After this PTF is applied, if an immediate receive fails and a
  connection is reestablished, the send and receive operation is
  automatically retried one time for the the following types of
  HTTP request methods, which are made through the HWTHRQST
  service: GET, HEAD, PUT, DELETE. No retry attempt is made for a
  POST request.
  
  In addition, if the status line returned from the web server
  does not contain a reason-phrase, the phrase "(empty)" will be
  returned HWTH_reason field associated with the
  HWTH_STATUS_LINE_TYPE struct.
  

Temporary fix

• ***********
  * HIPER *
  ***********
  Y BA56234
  

Comments

• ×**** PE19/04/30 PTF IN ERROR. SEE APAR OA57447  FOR DESCRIPTION
  ×**** AE19/04/30 PTF IN ERROR. SEE APAR OA57447  FOR DESCRIPTION
  ×**** PE19/05/10 FIX IN ERROR. SEE APAR OA57447  FOR DESCRIPTION
  

APAR Information

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

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

  UA98665 UA98666

Modules/Macros

• HWTHICOB HWTHIC   HWTHIPLI HWTHMRXB HWTHIASM HWTHTTP  HWTTMREX
  

Fix information

• Fixed component name

  WEB ENABLMNT TL

• Fixed component ID

  5752SCHWT

Applicable component levels

• R7B0 PSY UA98665

     UP19/03/13 P F903 ¢

• R7A0 PSY UA98666

     UP19/03/13 P F903 Ž

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.