PM64348: DFHPI0002 A SEVERE ERROR (CODE X'0507') HAS OCCURRED IN MODULE DFHPITH. HTTP STATUS CODE 302 REDIRECT 13/04/08 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Your CICS is acting as a Web Service Requester and your task
  issues an EXEC CICS INVOKE SERVICE command. The Service Provider
  returns an HTTP status code 302 (redirect).
  
  The status code 302 means the requested resource resides
  temporarily under a different URI. The HTTP header provides
  the temporary URI Location.
  
  The DFHPI0002 x'0507' is produced when DFHPITH calls DFHWBCL for
  READ_RESPONSE and is returned an exception with wbcl_reason
  WBCL_HEADER_NOT_FOUND. This is an unexpected response from
  DFHWBCL. DFHPITH sets pitg_response to PIT_DISASTER and invokes
  routine dfhpith_severe_error with tid_pith_wbcl_failure x'0507'
  and issues message DFHPI0002.
  
  
  Additional Symptoms and Keywords. KIXREVSWM SOA severe error
                                    tid pith wbcl failure
  CICS trace:
  PI 0507 PITH *EXC* WB_CLIENT_SUPPORT_FAILURE FUNCTION(CONVERSE)
  PI 0A27 PIIS *EXC* TRANSPORT_FAILED
  
  Message:
  DFHPI0504 applid tranid The CICS Pipeline Manager has failed to
  communicate with a remote server due to an error in the
  underlying transport. TRANSPORT: transport, PIPELINE: pipeline.
  
  INVOKE SERVICE
  RESP  16 INVREQ
  RESP2 23 transport or link failure occurred
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS does not handle the HTTP 302       *
  *                      response when it acts as a              *
  *                      Webservice requester.                   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  CICS is acting as a Web Service Requester and issuing an EXEC
  CICS INVOKE SERVICE command.
  The Web Service Provider returns an HTTP 302 response with a
  Location HTTP header.
  The CICS pipeline code in DFHPITH does not handle the 302
  response in a way to allow the applications to redirect the
  request.
  

Problem conclusion

• CICS has been changed to handle the HTTP 302 ,303 and 307
  response,and puts the supplied Location header into the
  DFHWS-LOCATION container.
  
  The CICS Transaction Server for z/OS Version 4 Release 1
  Application Programming Reference,SC34-7023-02 has been altered
  to add a new RESP2 value 109 for INVEREQ for command INVOKE
  SERVICE.
  The following has been added to say:
  
  "109 HTTP redirect(302,303 or 307) response was returned.The
  Location header is available in the DFHWS-LOCATION container."
  
  Same update applies to V4.2.
  
  CICS Transaction Server for z/OS Version 4 Release 1 Web
  Services Guide,SC34-7020-00 has been altered in Chapter 7
  ('Creating the Web services infrastructure') under the heading
  of 'Context containers' to add a new container DFHWS-LOCATION
  to context containers.
  The following has been added to say:
  
  "DFHWS-LOCATION container
   DFHWS-LOCATION is a container of DATATYPE(CHAR) that contains
   the supplied Location header when the HTTP response was 302,303
   or 307."
  
  Same update applies to V4.2.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PM61111

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

  UK79458 UK79459

Modules/Macros

•    DESEIPI  DESPISN  DESPITH  DFHEIPI  DFHPISN
  DFHPISNA DFHPISNC DFHPISND DFHPISNM DFHPISNT DFHPISN1 DFHPISN2
  DFHPITH
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK79458

     UP12/06/19 P F206

• R700 PSY UK79459

     UP12/06/19 P F206

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.