IBM Support

PM44917: DFHWS2LS GENERATED PL/I STRUCTURES RECEIVE IBM1881I S MESSAGES AT COMPILE TIME.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • DFHWS2LS generates PL/I structures that receive the following
    messages at compile time:
    IBM1881I S  The reference VARIABLE is ambiguous.
    This is because the WSDL that is used as input into DFHWS2LS
    contains elements that have been defined as both Optional and
    Nillable. DFHWS2LS then creates a structure that looks like the
    following:
    12 variable,
    15 variable                       CHAR(255) VARYING
    Additional Keywords:
    KIXREVSCB
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHWS2LS generated PLI structures       *
    *                      receive IBM1881I S messages at compile  *
    *                      time.                                   *
    *                                                              *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    DFHWS2LS is being used to generate language structures in PLI.
    There are non-structural data element fields that are defined as
    both nillable and optional in the WSDL file. When the PLI
    language structures are generated from this WSDL file, they end
    up with names repeated at different levels. If these fields are
    not referenced using the full level name of the field in a
    program, the compiler reports this as being ambiguous.
    

Problem conclusion

  • A new parameter MAPPING-OVERRIDES is added to DFHWS2LS and
    DFHSC2LS to provide the option of adding '_value' to the end of
    the field names for non-structural data element that are defined
    as both nillable and optional. The default value of this
    parameter is SAME-AS-MAPPING-LEVEL, which keeps the same naming
    style as before. If users want to generate field names that end
    with '_value' for non-structural data elements, the parameter
    should be set to LESS-DUP-NAMES. This could lead to a reduction
    in numeric suffixes that are added to field names.
    
    The CICS Transaction Server for z/OS Version 4 Release 1
    Web Services Guide, SC34-7020-01, has been altered as
    follows:
    
    In Chapter 8. 'Creating a Web service' in section 'DFHWS2LS:
    WSDL to high-level language conversion' the following optional
    input parameter has been added to DFHWS2LS:
    
            +-MAPPING-OVERRIDES=SAME-AS-MAPPING-LEVEL-+
         >--+-----------------------------------------+--><
            +-MAPPING-OVERRIDES=LESS-DUP-NAMES--------+
    
    MAPPING-OVERRIDES = {SAME-AS-MAPPING-LEVEL | LESS-DUP-NAMES }
    
       Provides the options to override mapping level defaults
       when generating language structures.
    
     SAME-AS-MAPPING-LEVEL
       This is the default.
       It generates language structures in the same style as the
       mapping level.
    
     LESS-DUP-NAMES
       It generates non-structural structure field names with
       '_value' at the end of the name to enable direct
       referencing to the field. For example, level 12 field
       streetName in the following PLI language structure:
    
       09 streetName,
           12 streetName                     CHAR(255) VARYING
          UNALIGNED,
           12 filler                         BIT (7),
           12 attr_nil_streetName_value      BIT (1),
    
       will be suffixed with '_value' at the end when specifying
       MAPPING-OVERRIDES = LESS-DUP-NAMES:
    
       09 streetName,
           12 streetName_value               CHAR(255) VARYING
          UNALIGNED,
           12 filler                         BIT (7),
           12 attr_nil_streetName_value      BIT (1),
    
    
    The CICS Transaction Server for z/OS Version 4 Release 1
    Application Programming Guide, SC34-7022-01, has been altered
    as follows:
    
    In Chapter 28. 'Mapping and transforming application data and
    XML' in section 'DFHSC2LS: XML schema to high-level language
    conversion' the following optional input parameter has been
    added to DFHSC2LS:
    
            +-MAPPING-OVERRIDES=SAME-AS-MAPPING-LEVEL-+
         >--+-----------------------------------------+--><
            +-MAPPING-OVERRIDES=LESS-DUP-NAMES--------+
    
    MAPPING-OVERRIDES = {SAME-AS-MAPPING-LEVEL | LESS-DUP-NAMES }
    
       Provides the options to override mapping level defaults
       when generating language structures.
    
     SAME-AS-MAPPING-LEVEL
       This is the default.
       It generates language structures in the same style as the
       mapping level.
    
     LESS-DUP-NAMES
       It generates non-structural structure field names with
       '_value' at the end of the name to enable direct
       referencing to the field. For example, level 12 field
       streetName in the following PLI language structure:
    
       09 streetName,
           12 streetName                     CHAR(255) VARYING
          UNALIGNED,
           12 filler                         BIT (7),
           12 attr_nil_streetName_value      BIT (1),
    
       will be suffixed with '_value' at the end when specifying
       MAPPING-OVERRIDES = LESS-DUP-NAMES:
    
       09 streetName,
           12 streetName_value               CHAR(255) VARYING
          UNALIGNED,
           12 filler                         BIT (7),
           12 attr_nil_streetName_value      BIT (1),
    
    
    The CICS Transaction Server for z/OS Version 4 Release 2
    Web Services Guide, SC34-7191-00, has been altered as
    follows:
    
    In Chapter 7. 'Creating a Web service' in section 'DFHWS2LS:
    WSDL to high-level language conversion' the following optional
    input parameter has been added to DFHWS2LS:
    
            +-MAPPING-OVERRIDES=SAME-AS-MAPPING-LEVEL-+
         >--+-----------------------------------------+--><
            +-MAPPING-OVERRIDES=LESS-DUP-NAMES--------+
    
    MAPPING-OVERRIDES = {SAME-AS-MAPPING-LEVEL | LESS-DUP-NAMES }
    
       Provides the options to override mapping level defaults
       when generating language structures.
    
     SAME-AS-MAPPING-LEVEL
       This is the default.
       It generates language structures in the same style as the
       mapping level.
    
     LESS-DUP-NAMES
       It generates non-structural structure field names with
       '_value' at the end of the name to enable direct
       referencing to the field. For example, level 12 field
       streetName in the following PLI language structure:
    
       09 streetName,
           12 streetName                     CHAR(255) VARYING
          UNALIGNED,
           12 filler                         BIT (7),
           12 attr_nil_streetName_value      BIT (1),
    
       will be suffixed with '_value' at the end when specifying
       MAPPING-OVERRIDES = LESS-DUP-NAMES:
    
       09 streetName,
           12 streetName_value               CHAR(255) VARYING
          UNALIGNED,
           12 filler                         BIT (7),
           12 attr_nil_streetName_value      BIT (1),
    
    
    The CICS Transaction Server for z/OS Version 4 Release 2
    Application Programming Guide, SC34-7158-00, has been altered
    as follows:
    
    In Chapter 28. 'Mapping and transforming application data and
    XML' in section 'DFHSC2LS: XML schema to high-level language
    conversion' the following optional input parameter has been
    added to DFHSC2LS:
    
            +-MAPPING-OVERRIDES=SAME-AS-MAPPING-LEVEL-+
         >--+-----------------------------------------+--><
            +-MAPPING-OVERRIDES=LESS-DUP-NAMES--------+
    
    MAPPING-OVERRIDES = {SAME-AS-MAPPING-LEVEL | LESS-DUP-NAMES }
    
       Provides the options to override mapping level defaults
       when generating language structures.
    
     SAME-AS-MAPPING-LEVEL
       This is the default.
       It generates language structures in the same style as the
       mapping level.
    
     LESS-DUP-NAMES
       It generates non-structural structure field names with
       '_value' at the end of the name to enable direct
       referencing to the field. For example, level 12 field
       streetName in the following PLI language structure:
    
       09 streetName,
           12 streetName                     CHAR(255) VARYING
          UNALIGNED,
           12 filler                         BIT (7),
           12 attr_nil_streetName_value      BIT (1),
    
       will be suffixed with '_value' at the end when specifying
       MAPPING-OVERRIDES = LESS-DUP-NAMES:
    
       09 streetName,
           12 streetName_value               CHAR(255) VARYING
          UNALIGNED,
           12 filler                         BIT (7),
           12 attr_nil_streetName_value      BIT (1),
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM44917

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-08-03

  • Closed date

    2011-08-25

  • Last modified date

    2011-10-03

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

    PM38985

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

    UK71184 UK71185

Modules/Macros

  •    DFJ@H176 DFJ@H223
    

Publications Referenced
SC34719100SC34702201SC34702001SC34715800 

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R60D PSY UK71184

       UP11/09/08 P F109

  • R70D PSY UK71185

       UP11/09/08 P F109

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

Document Information

Modified date:
03 October 2011