PH63742: INCREASE THE LENGTH OF THE REDIRECT URI THAT CICS HANDLES FROM 1024 CHARACTERS TO 4096

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• If an INVOKE-SERVICE call receives a redirect response (http
  302) then the returned location header value that is populated
  in the DFHWS-LOCATION container is truncated at 1024 characters.
  This APAR will increase this to 4096 characters.
  
  In addition, via an opt-in (a new attribute or element in the
  requester pipeline configuration file), CICS will automatically
  follow the redirect. The number of redirects that CICS will
  follow will be limited to avoid the possibility of indefinite
  redirects.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: INVOKE SERVICE receives a HTTP          *
  *                      redirect response and the location in   *
  *                      DFHWS-LOCATION is truncated to 1024     *
  *                      characters.                             *
  ****************************************************************
  A CICS transaction has issued INVOKE SERVICE and receives a
  HTTP 302 redirect response.
  
  CICS places the value of the location HTTP header into the
  DFHWS-LOCATION container. However this is limited to 1024
  characters so if the redirect location is longer than that it is
  impossible for the user program to issue another INVOKE SERVICE
  request to the new location.
  
  Keywords: 303 307
  

Problem conclusion

• CICS has been changed to support a redirect location of up to
  4096 bytes in the DFHWS-LOCATION container.
  
  CICS has been changed to automatically follow redirects if the
  pipeline XML has follow_redirects="true" set on the
  default_http_transport_handler_list element.
  
  CICS will follow up to three redirects.
  
  The CICS documentation will be updated to describe the
  follow_redirects attribute.
  

Temporary fix

Comments

APAR Information

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

  PH61670

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

  UO02517 UO02518

Modules/Macros

• DFHPIPL  DFHPITH  DFJ@H263
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UO02518

     UP25/04/03 P F504

• R500 PSY UO02517

     UP25/03/22 P F503

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.