A fix is available
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:
APAR is sysrouted TO one or more of the following:
UK71184 UK71185
Modules/Macros
DFJ@H176 DFJ@H223
SC34719100 | SC34702201 | SC34702001 | SC34715800 |
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
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":"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