PK15904: PROVIDE NILLABLE ATTRIBUTE SUPPORT FOR CICS WEBSERVICES.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR is a refresh of the CICS Web services assistants
  (DFHWS2LS and DFHLS2WS) from the development stream and
  includes both new capability and bug fixes. It adds support
  for xsd:list, xsd:union, xsd:anySimpleType and xsd:attribute
  XML schema entries (including support for the xsi:nil instance
  attribute). It also adds the ability to map variable length
  string and binary values to containers. It improves the
  performance of the Web services XML transformation
  infrastructure in CICS.
  
  Problems solved by this APAR include:
    support for pure DBCS in COBOL,
    problems with structures in C/C++,
    problems with namespaces in generated SOAP messages,
    problems with 'short' data types with pre-Enterprise PL/I,
    problems with inheritance by extension in WSDL documents,
    problems with 'OCCURS X TO Y' in COBOL,
    problems with generated variable names being too long
    (e.g. COBOL data names generated that are greater than 30
          characters long).
  
  Other APARs resolved: PK13990, PK14301, PK16024
  
  See also defects: 14890, 14877, 14841, 14797, 14794, 14757,
  14753, 14681, 14631, 14630, 14613, 14608, 14597, 14594, 14550,
  14054 and 12992.
  
  DCR 7722  DCR7722
  
  Additional Symptoms:
  After application of this maintenance you may see error
  DFHPI1008 INPUT_STRUCTURE_TOO_SMALL due to the ICM not
  receiving the expected length of data returned by the
  application in either the commarea or container.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR is a refresh of the CICS Web  *
  *                      Services assistants (DFHWS2LS and       *
  *                      DFHLS2WS) to provide new capability and *
  *                      fix known defects.  There are also      *
  *                      significant performance improvements    *
  *                      made to the pipeline runtime code.      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A new optional parameter for DFHWS2LS and DFHLS2WS is
  introduced called MAPPING-LEVEL. This parameter can accept
  either of the following values: 1.0 or 1.1. If
  MAPPING-LEVEL=1.1 is specified then the new mapping
  capabilities are activated including support for XML
  attributes. A mapping level of 1.0 (the default) ensures that
  the existing CICS TS v3.1 mappings are used and the new
  capabilities are not activated. The 1.0 level of mappings are
  provided for backwards compatibility purposes. For new
  applications it is recommended that you specify
  MAPPING-LEVEL=1.1 when running either DFHWS2LS or DFHLS2WS in
  order to enable the new capabilities.
  
  The new capabilities are mostly in DFHWS2LS. If
  MAPPING-LEVEL=1.1 is specified then WSDL documents that
  contained some previously unsupported schema artifacts are now
  supported. These include the xsd:union, xsd:list and
  xsd:anySimpleType elements. At mapping level 1.1 there is also
  support for some schema artifacts that were previously ignored.
  This includes support for xsd:attribute elements and the
  nillable attribute on xsd:element elements. A further
  improvement at the new mapping level is that where a value
  described in the XML schema within a WSDL document is known to
  be of variable length and is likely to be large, it is now
  mapped to a separate CICS container. This allows the
  application to treat the value as variable length without
  having to pad large fields with nulls or spaces.
  
  This APAR significantly improves the performance of the
  DFHPIII, the module that builds SOAP messages. This performance
  improvement is available for both new mapping level 1.1
  applications and existing mapping level 1.0 applications. The
  scale of the improvement will vary depending on the nature of
  your applications and the volume of data to be sent.
  
  This APAR refreshes parts of the CICS Catalog manager sample
  application. This includes adding '.ear' files to the 'Web
  client' part of the sample for use with Rational Application
  Developer version 6.
  
  In addition to the functional and performance improvements,
  this APAR fixes some problems discovered by the CICS
  development team. These fixes apply to both mapping level 1.0
  and 1.1. The most significant of these fixes include:
   DFHWS2LS:
   o corrections for missing namespace values in some SOAP
     messages sent from CICS.
   o corrections to some LANG=PLI-OTHER data types, especially
     for xsd:short and xsd:unsignedShort.
   o corrections where an xsd:complexType derives from another
     xsd:complexType via extension.
   o improved toleration of OCCURS x TO y in COBOL
   o corrections to avoid over long variable names in generated
     language structures.
  
   DFHLS2WS:
   o removal of extraneous SOSI characters for pure DBCS values
     in COBOL.
   o corrections for alignment problems with some structures in
     COBOL and C/C++.
  

Problem conclusion

Temporary fix

•             *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

• This APAR adds new PI domain messages and changes the PI domain
  trace interpreter. Documentation for the new MAPPING-LEVEL
  parameter will be available in the Information Center at its
  next refresh.
  

APAR Information

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

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

  UK11615 UK11616

Modules/Macros

•    DESPICC  DESPICV  DESPIDC  DESPIII  DESPIIW
  DESPITRI DESPIWR  DFHMEPIC DFHMEPIE DFHMEPIK DFHPICC  DFHPICCA
  DFHPICCM DFHPICCT DFHPIDCC DFHPIDCD DFHPIII  DFHPIIIA DFHPIIIM
  DFHPIIIT DFHPIIW  DFHPIIWA DFHPIIWM DFHPIIWT DFHPISB  DFHPITRI
  DFHPIWR  DFHPIWRA DFHPIWRJ DFHPIWRM DFHPIWRT DFHPIWRV DFJ@H176
  DFJ@H225 DFJ@H226 MFHMEPIE
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R40D PSY UK11616

     UP06/02/14 P F602

• R400 PSY UK11615

     UP06/02/14 P F602

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.