A fix is available
APAR status
Closed as program error.
Error description
XML Schema elements are given a number in PL/I structure . When we generate PL/I structures from XML Schema using DFHSC2LS and DFHWS2LS utility programs the PL/I structure contains numbered fields when the field name is reused. In the information center: http://www-01.ibm.com/support/knowledgecenter/SSGMCP_5.1.0/com.i bm.cics.ts.applicationprogramming.doc/datamapping/dfhws_wsdl2pli .html?lang=en It says in point 3: "Duplicate names in the same scope are made unique by the addition of one or more numeric digits to the second and subsequent instances of the name. For example, three instances of year become year, year1, and year2." In our case, even though the scope IS NOT the same, the field PRICE is given a number: PRICE1_num, PRICE2_num, PRICE3_num, even though they are scoped within a different element.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS Users. * **************************************************************** * PROBLEM DESCRIPTION: DFHSC2LS generates an inline mapping * * structure for an array with an * * incorrectly named count field. * **************************************************************** * RECOMMENDATION: * **************************************************************** Using DFHSC2LS to generate an inline mapping structure for XML which contains an array with a varying number of elements will result in a declaration for a count field ahead of the element itself. The generated name should be unique within its scope, but for Enterprise PL/I the count field is incorrectly generated with a number appended to the name so that it is unique within the entire structure, not just its scope. For example: 02 Element, 04 contents_num UNSIGNED FIXED BINARY(32) UNALIGNED, 04 contents FIXED DECIMAL (11,2), 02 SecondElement, 04 contents2_num UNSIGNED FIXED BINARY(32) UNALIGNED, 04 contents FIXED DECIMAL (11,2), The contents2_num field does not require the addition of the '2' to make it unique within its scope. The same problem exists when using DFHWS2LS to convert WSDL to create an Enterprise PL/I data structure.
Problem conclusion
DFHSC2LS and DFHWS2LS have been altered to accept a new MAPPING-OVERRIDES value of NO-ARRAY-NAME-INDEXING. If the new value is specified then it will check both the the element name and the name of the higher level within the structure when deciding whether a name requires the addition of a number to make it unique. The CICS Transaction Server for z/OS, Version 5 Release 1, Web Services Guide, SC34-2878-01, has been altered to add a new value for the DFHSC2LS and DFHWS2LS MAPPING-OVERRIDES parameter as follows: Change the section 'Input parameters for DFHSC2LS' to add the new value: | .-SAME-AS-MAPPING-LEVEL--. | '-MAPPING-OVERRIDES=-+------------------------+-' '-UNDERSCORES-AS-HYPHENS-' '-NO-ARRAY-NAME-INDEXING-' Change the 'Parameter Descriptions' for DFHSC2LS to add the new value and its explanation: MAPPING-OVERRIDES= SAME-AS-MAPPING-LEVEL|UNDERSCORES-AS-HYPHENS |NO-ARRAY-NAME-INDEXING} NO-ARRAY-NAME-INDEXING For Enterprise PL/I only. Ensures that the field names within an array are unique only within the scope of the higher level structure. Change the section 'Input parameters for DFHWS2LS' to add the new value: | .-SAME-AS-MAPPING-LEVEL--. | '-MAPPING-OVERRIDES=-+------------------------+-' '-UNDERSCORES-AS-HYPHENS-' '-LESS-DUP-NAMES---------' '-NO-ARRAY-NAME-INDEXING-' Change the 'Parameter Descriptions' for DFHWS2LS to add the new value and its explanation: MAPPING-OVERRIDES= SAME-AS-MAPPING-LEVEL|UNDERSCORES-AS-HYPHENS |NO-ARRAY-NAME-INDEXING} NO-ARRAY-NAME-INDEXING For Enterprise PL/I only. Ensures that the field names within an array are unique only within the scope of the higher level structure. The same changes will be made to the CICS Transaction Server for z/OS, Version 5 Release 2, Web Services Guide, SC34-7301-00.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
×**** PE16/06/28 FIX IN ERROR. SEE APAR PI57467 FOR DESCRIPTION
APAR Information
APAR number
PI35297
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
800
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2015-02-18
Closed date
2015-09-17
Last modified date
2016-07-22
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI31269 UI31270
Modules/Macros
DFJ@H176
SC34287801 | SC34730100 |
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
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"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.1","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
22 July 2020