IBM Support

PK51498: METHOD FOR SUPPLYING USERID/PASSWORD ON A HTTPPROXY PARM IN DFHWS2LS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Trying to use Web Services and setting up DFHWS2LS and using the
    HTTPPROXY parm.  The PROXY in question, requires you pass along
    a userid/password to access the PROXY.  Need a method to be able
    to pass these values.
    .
    As CICS/TS V3.1 'CICS WEB Services Guide' mentions, the standard
    format of this parameter is:
    .
    HTTPPROXY={domain name|IP address}:port number
    .
    There is no option for a user to specify userid/password.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHWS2LS does not allow HTTP proxy      *
    *                      authentication to be used               *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    When specifying schema locations or namespaces that are
    located on the Internet, DFHWS2LS will connect to the
    Internet to download them. If the outbound connection
    requires a proxy server, and HTTP proxy authentication
    is in use, DFHWS2LS will not be able to connect to the
    Internet and a HTTP error 407 will be returned.
    This is because there is no method of specifying a HTTP
    proxy username and password in DFHWS2LS.
    DFHWS2LS will fail with a CICSWSDLException and message
    DFHPI9026E in the log.
    
    Additional Keywords: MSGDFHPI9026E PI9026E 9026
                         ProtocolException
    

Problem conclusion

  • DFHWS2LS has been modified to use two new parameters -
    HTTPPROXY-USERNAME and HTTPPROXY-PASSWORD.
    
    The CICS Web Services Guide for CICS TS Version 3 Release 2
    (SRL: SC34-6838-00) will be updated as follows:
    
    In Chapter 8 ("Creating a Web Service"), in section 1
    "The CICS Web Services Assistant", in subsection
    titled: "DFHWS2LS: WSDL to high level language conversion",
    update the "Input parameters for DFHWS2LS" section:
    
    The diagram is to be updated adding two new input parameters:
    HTTPPROXY-USERNAME and HTTPPROXY-PASSWORD. These are optional
    parameters, but can only be specified if the HTTPPROXY is also
    specified.
    
    Inside the "Input parameters for DFHWS2LS" section, inside the
    "Parameter Descriptions" heading, under the HTTPPROXY
    description add the following:
    
    HTTPPROXY-USERNAME=value
      Specifies the HTTP proxy username that should be used in
      conjunction with HTTPPROXY-PASSWORD if the system on which
      you are running DFHWS2LS uses a HTTP proxy server to access
      the Internet, and the HTTP proxy server uses basic
      authentication. You can only use this parameter when you
      also specify HTTPPROXY.
    
    HTTPPROXY-PASSWORD=value
      Specifies the HTTP proxy password that should be used in
      conjunction with HTTPPROXY-USERNAME if the system on which
      you are running DFHWS2LS uses a HTTP proxy server to access
      the Internet, and the HTTP proxy server uses basic
      authentication. You can only use this parameter when you
      also specify HTTPPROXY.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK51498

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    500

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2007-08-23

  • Closed date

    2007-08-30

  • Last modified date

    2007-10-02

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

    PK37436

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

    UK28719

Modules/Macros

  •    DFJ@H176 DFJ@H223
    

Publications Referenced
SC34683800    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R50D PSY UK28719

       UP07/09/06 P F709

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.2","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.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 October 2007