A fix is available
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
DFHWS2LS 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.1 Messages and Codes (GC34644203) will be updated. In Chapter 1 (DFH messages) the message DFHPI9664 will be added as follows: DFHPI9664 E THE VALUE SPECIFIED BY PARAMETER "PARAMETER" IS INVALID. PLEASE CONSULT THE LOG FILE GENERATED BY THE CICS WEB SERVICES ASSISTANT FOR MORE INFORMATION. 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.1 Web Services Guide (SC34645804) will be updated. In chapter 7 Creating the Web Services Infrastructure, 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
PK37031
Reported component name
CICSTS 3.1 Z/OS
Reported component ID
5655M1500
Reported release
400
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2007-01-08
Closed date
2007-09-24
Last modified date
2007-11-14
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK52276 UK29475 UK29476
Modules/Macros
DFHMEPIE DFH37031 DFJ@H176 DFJ@H223 MFHMEPIE
SC34645804 | GC34644203 |
Fix information
Fixed component name
CICSTS 3.1 Z/OS
Fixed component ID
5655M1500
Applicable component levels
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:
14 November 2007