IBM Support

PK52276: DFHPI9523 MAY BE RECEIVED IF THE XML IN THE WSDL CONTAINS EXCLAMATION POINTS IF USING CODEPAGE OTHER THAN 1047.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • If you are using the WSDL just created by DFHLS2WS as input
    to DFHWS2LS, and you are using a codepage other than IBM-1047
    and the XML contains exclamation points (marks) ie. "!",
    DFHWS2LS may fail with a message like the following (in this
    case the text is in German):
      DFHPI9523E An unexpected error occurred whilst processing
      file "/u/rcicctl0/wsdl/cwsoap1a.wsdl". The problem is:
      "WSDLException: faultCode=PARSER_ERROR: Problem parsing '-
      WSDL Document -'.: Die Formatierungs steuerzeichen im
      Dokument vor dem Stammelement mチssen syntaktisch kor
      rekt sein.".WSDLException: faultCode=PARSER_ERROR: Problem
      parsing '- WSDL Document -'.: Die
      formatierungssteuerzeichen im Dokument vor dem
      Stammelement mチssen syntaktisch korrekt sein.
    .
      DFHPI9558E ERRORS have been generated processing file
      "/u/rcicctl0/wsdl/cwsoap1a.wsdl".
    .
    After removing all the XML comments (<!--....-->) from the
    WSDL, the failure no longer occurs.
    .
    This APAR is being taken for further investigation, but it
    appears the problem is with DFHWS2LS when it reads in the
    WSDL created by DFHLS2WS.  The WSDL had been correctly
    written out in the local encoding (in this case Cp1141).
    When DFHWS2LS reads it in the WSDL parsing it uses is left to
    determine the correct encoding.  In the absence of an XML
    encoding tag then it should default to using the local
    encoding.  This appears to not be the case and 1047 is being
    used instead.  This causes parsing errors when the XML
    contains comments because the exclamation mark character
    doesn't have the expected codepoint for codepage 1047.
    

Local fix

  • Remove the exclamation points from the XML in the WSDL.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All.                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHPI9523 with faultCode                *
    *                      PARSER_ERROR running DFHWS2LS.          *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    A WSDL file is created from a language structure using DFHLS2WS
    running in a codepage of 1141. This WSDL file is then used as
    input to DFHWS2LS to create a language structure, again running
    in codepage 1141.
    This run of DFHWS2LS fails with MSGDFHPI9523 PARSER-ERROR. This
    is because there is no XML encoding statement inserted into the
    WSDL, so when it is input into the DFHWS2LS the default of
    codepage 1047 is used. There was an exclamation mark output by
    the original DFHLS2WS run to generate the WSDL file in codepage
    1141. The exclamation mark has a different code point in 1141
    than in 1047 which is used by default when reading in the WSDL.
    This causes the parser failure.
    Additional keywords: MSG_INVALID_VALUE MSG_INVALID_CHARACTER
    

Problem conclusion

  • DFHLS2WS has been changed to have a new WSDLCP parameter with
    values of LOCAL and UTF-8. UTF-8 can be used to specify that
    the WSDL is to be generated in codepage utf-8 and that
    an XML encoding tag should be inserted into the WSDL to show
    that the WSDL file is in utf-8 codepage.
    
    The CICS TS 3.2 Messages and Codes (GC34682700) will be
    updated. In Chapter 1 (DFH messages) the message DFHPI9664
    will be added as follows:
    
    DFHPI9664  E THE VALUE SPECIFIED FOR PARAMETER
              "PARAMETER" IS INVALID.  VALID VALUES ARE
              "VALUES"
    
    EXPLANATION:  A value has been specified for one of the
    parameters to DFHLS2WS or DFHWS2LS that is invalid.
    SYSTEM ACTION:  The Web Services assistant continues
    processing.
    
    USER RESPONSE:  Correct the parameter value passed to the
    CICS Web Services assistant before retrying. More
    information on the permissible values for this parameter can
    be found in the CICS Web Services assistant's log file and
    the CICS Web Services manual.
    NOTE:  This message cannot be changed with the message
    editing utility.
    
    DESTINATION:  SYSPRINT
    
    MODULES:  DFHLS2WS, DFHWS2LS
    
    The CICS TS 3.2 Web Services Guide (SC34683800) will be
    updated. In chapter 8 Creating a Web Service, the section
    DFHLS2WS will have the following symbolic parameter added:
    WSDLCP=value
          If specified, this denotes the codepage that the WSDL is
          generated in.
          value can be either "LOCAL" or "UTF-8"
          LOCAL signifies that the WSDL is generated in the local
          codepage and no encoding tag is generated.
          UTF-8 signifies that the WSDL is to be generated in
          codepage UTF-8 and that an XML encoding tag is generated
          within the WSDL to indicate that codepage UTF-8 was used.
    NOTE: If WSDL is generated with UTF-8 specified, care must be
          taken when copying the WSDL to a different platform to
          ensure that the encoding tag remains correct.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK52276

  • 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-09-06

  • Closed date

    2007-11-20

  • Last modified date

    2007-12-03

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

    PK37031

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

    UK31450 UK31453

Modules/Macros

  •    DFHMEPIE DFJ@H176 DFJ@H223
    

Publications Referenced
SC34683800GC34682700   

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R50D PSY UK31453

       UP07/11/24 P F711

  • R500 PSY UK31450

       UP07/11/24 P F711

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:
03 December 2007