PI12826: DFHWS2LS GENERATES INCORRECT NAMESPACES FOR RPC BASED WEB SERVICES

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible.

Error description

• A WSDL describes an RPC based web service.  The elements are
  defined using WSDL parts rather then an XML schema.  When
  DFHWS2LS processes this WSDL it does not work out the
  correct namespaces for each of the elements.  This causes
  the SOAP message to be rejected at runtime when it is parsed
  by a parser which is validating against the WSDL.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: The namespace for part accessors        *
  *                      generated from RPC WSDL documents       *
  *                      are inherited rather than null.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  WSBind files generated from RPC style WSDL documents cause CICS
  to generate SOAP messages with incorrect Part Accessors.
  The namespace of the Part Accessors should be null (as per WSi
  Basic Profile rule R2729), but are inherited under CICS.
  

Problem conclusion

Temporary fix

Comments

• DFHWS2LS has been updated to provide a new parameter,
  RPC-NAMESPACE with possible values INHERIT and NULL. This
  parameter can be used to generate WSBind files that conform
  to the requirements of the WSi Basic Profile specification.
  The default value is 'INHERIT', which preserves the existing
  behaviour of DFHLS2WS. The 'NULL' value enables the WSi
  compliant behaviour.
  .
  .
  The CICS Web Services Guide, Version 3, Release 1:
  (SRL: SC34-6458-04) has been updated as follows:
  In Chapter 7 - The CICS Web services assistant, under
  the sub-heading 'DFHWS2LS: WSDL to high level language
  conversion':
  .
  Under the title 'Input parameters for DFHWS2LS' the syntax
  diagram has been updated to add the following new optional
  parameter: RPC-NAMESPACE=INHERIT,NULL .
  
  Under the 'Parameter Descriptions' title following the syntax
  diagram the new parameter has been added followed by its
  description as below:
  .
  RPC-NAMESPACE=INHERIT,NULL
  Optional. Indicates whether RPC Part Accessors should inherit
  the namespace of RPC Operation Accessors. The default value of
  INHERIT means that they do, NULL means that they are in no
  namespace. The NULL option is required to ensure consistency
  with the WSi Basic Profile specification. This parameter is only
  relevant when processing RPC Literal style WSDL.
  

APAR Information

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

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

  UI19489

Modules/Macros

•    DFJ@H176
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R40D PSY UI19489

     UP14/07/17 P F407

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.