IBM Support

PI35297: DFHSC2LS CONVERTS XML SCHEMA ELEMENTS INTO PL/I STRUCTURED FIELDS WITH A NUMBER.

A fix is available

Subscribe

You can track all active APARs for this component.

 

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
    

Publications Referenced
SC34287801SC34730100   

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R80D PSY UI31269

       UP15/09/24 P F509

  • R90D PSY UI31270

       UP15/09/24 P F509

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