IBM Support

PK56688: DFHWBCL ADDS LEADING ZEROES TO THE PORT NUMBER ON A URI USED ON AN EXEC CICS INVOKE WEBSERVICE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as unreproducible.

Error description

  • When an EXEC CICS WEBSERVICE is invoked using a URI containing a
    port number other than the default CICS is padding the port
    number with leading zeroes.
    E.G. If a URI of http://www.aaa.com:88 is specified then CICS
    sends the URI as http://www.aaa.com:00088
    
    This can be rejected by some servers resulting in message
     DFHPI0602 31/10/2007 12:24:11 xxxxxxxx The CICS SOAP handler
    failed to parse a message. The parser error code is 0. The
    DFHPIEP return code is 8. The error was found at
    offset 1 into the message.
    

Local fix

  • No Local fix
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: When a non-default HTTP port number     *
    *                      is specified for a Web Service          *
    *                      request, the port number is padded      *
    *                      with leading zeros if less than         *
    *                      5 digits long.                          *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    A CICS application is issuing an EXEC CICS INVOKE WEBSERVICE
    command supplying a port number that is not a default HTTP
    port number (not 80, or 443 for HTTPS). In this particular
    case it was 88. As the port number is less than 5 digits long
    the port number in the HTTP HOST header was padded with
    leading zeros, appearing as 00088. This caused the Web Service
    provider to reject the request because it cannot handle leading
    zeros. The non-SOAP error response led to message DFHPI0602 when
    CICS tried to parse the SOAP response.
    
    Additional keywords: MSGDFHPI0602
    

Problem conclusion

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

  • DFHWBCL has been updated to no longer pad port numbers with
    leading zeros in the HTTP Host header for all outbound HTTP
    requests.
    

APAR Information

  • APAR number

    PK56688

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    400

  • Status

    CLOSED UR3

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2007-11-19

  • Closed date

    2007-12-18

  • Last modified date

    2008-01-03

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

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

    UK32346

Modules/Macros

  •    DESWBCL  DFHWBCL
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R400 PSY UK32346

       UP07/12/21 P F712

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 January 2008