PI49304: THE Z/VSE SOAP SUPPORT (WITH LITERAL STYLE SUPPORT) DOES NOT CORRECTLY HANDLE COMPLEX COPYBOOKS WITH REDEFINES AND OCCURS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The new z/VSE SOAP support, that was introduced in z/VSE 5.2 and
  now supports literal encoding style, does not correctly handle
  complex copybooks with REDEFINES and OCCURS clauses. The result
  is that fields are mapped to a wrong location in the commarea.
  This affects z/VSE as SOAP server as well as z/VSE as SOAP
  client.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All z/VSE SOAP Engine Users that are using   *
  *                 the new SOAP support with literal support.   *
  ****************************************************************
  * PROBLEM DESCRIPTION: The new z/VSE SOAP support, that was    *
  *                      introduced in z/VSE 5.2 and now sup-    *
  *                      ports literal encoding style, does not  *
  *                      correctly handle complex copybooks      *
  *                      with REDEFINES and OCCURS clauses. The  *
  *                      result is that fields are mapped to a   *
  *                      wrong location in the commarea.  This   *
  *                      affects z/VSE as SOAP server as well    *
  *                      as z/VSE as SOAP client.                *
  *                      The CICS defnitions for the SOAP        *
  *                      programs are missing in the CICS PPT.   *
  ****************************************************************
  * RECOMMENDATION: Install this PTF.                            *
  ****************************************************************
  The new z/VSE SOAP support, that was introduced in z/VSE 5.2 and
  now supports literal encoding style, does not correctly handle
  complex copybooks with REDEFINES and OCCURS clauses. The result
  is that fields are mapped to a wrong location in the commarea.
  This affects z/VSE as SOAP server as well as z/VSE as SOAP
  client.
  The missing CICS definition for the Z/VSE SOAP programs have
  been added to the CICS PPT.
  

Problem conclusion

• The code has been corrected to now handle complex copybooks
  correctly.
  
  For users of the 'new' z/VSE SOAP support (with literal style
  support):
  
  After applying this PTF you MUST also update the CICS2WS tool
  to version 2.7.0 (or later). The latest CICS2WS tool version
  can be downloaded here:
    http://www-03.ibm.com/systems/z/os/zvse/downloads/#cics2ws
  
  You MUST then re-generate any existing RULES with the new
  CICS2WS tool version of 2.7.0 (or later), assemble them on
  z/VSE and perform a NEWCOPY on them in CICS.
  The z/VSE SOAP Engine will only accept RULES generated with
  a CICS2WS tool version of 2.7.0 (or later).
  
  Note:
  Users of the 'old' SOAP support using generated PROXY code
  are not affected and do not need to update the CICS2WS version.
  However the new CICS2WS version will also work with the 'old'
  SOAP support.
  
  You should also apply the PTF for APAR PI49304. This PTF will
  ensure that the affected programs are properly defined in CICS.
  Alternatively you can define the programs using DFHCSDUP as
  follows:
    Define  Program(IESOACLN) Group(VSESPG)
            Language(C) Datalocation(ANY)
            Resident(NO) Execkey(CICS) Reload(NO)
            Description(SOAP V2 CLIENT)
    Define  Program(IESOASRV) Group(VSESPG)
            Language(C) Datalocation(ANY)
            Resident(NO) Execkey(USER) Reload(NO)
            Description(SOAP V2 Server)
    Define  Program(IESCNVRM) Group(VSESPG)
            Language(C)  Datalocation(ANY)
            Resident(NO) Execkey(USER) Reload(NO)
            Description(SOAP V2 DATA TYPES CONVERTOR)
    Define  Program(IESXPTHM) Group(VSESPG)
            Language(C) Datalocation(ANY)
            Resident(NO) Execkey(USER) Reload(NO)
            Description(XPATH SUPPORT)
  

Temporary fix

Comments

APAR Information

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

  PI49037

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

  UI31887

Modules/Macros

• IESZPPT
  

Fix information

• Fixed component name

  VSE/SP UNIQUE

• Fixed component ID

  5686CF901

Applicable component levels

• R52C PSY UI31887

     UP16/02/02 I 1000

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.