PK48633: PROBLEMS WITH FIELD SUPPRESSION IN DFHLS2WS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Incorrect behaviour is experienced when a software agent is
  attached to DFHLS2WS and field suppression is used. If the agent
  specifies that an entire sub-structure within the language
  structure should be suppressed from the SOAP representation then
  problems may occur. These problems may involve rogue error
  messages being issued by DFHLS2WS or corrupted data at runtime.
  For example, the following error message may be received:
  "INTERNAL ERROR: SIGN LEADING is not avaiable at this mapping
  level or for this data type.".
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message: "INTERNAL ERROR: SIGN          *
  *                      LEADING is not available at this        *
  *                      mapping level or for this data type."   *
  *                      is incorrectly issued when using        *
  *                      field suppression in DFHLS2WS.          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  DFHLS2WS has been used together with a software agent that
  programmatically indicates that certain fields within the
  language structure should not be included in the SOAP
  representation of the data. That is, some fields have been
  suppressed using a tool such as WD/z.
  If an entire sub-structure from within the language structure
  is flagged for suppression then unpredictable behaviour may
  be experienced.
  In the reported problem the following message was issued:
  "CICSWSDLException: INTERNAL ERROR: SIGN LEADING is not
  available at this mapping level or for this data type."
  Other errors may be experienced, including runtime corruption
  within a generated commarea or SOAP message.
  When element suppression is in effect DFHLS2WS generates some
  extra information to represent the suppressed fields. This
  information is propagated through ICMImplFromWSDL.java except
  for one path through the code that results in the list of
  suppressed elements being replaced with an empty list.
  Where this path through the code is driven DFHLS2WS is
  confused about the data-types for the suppressed fields
  (information it needs to know in order to calculate how much
  space to set aside in the commarea). This confusion can trigger
  assertions within DFHLS2WS which detect certain states that
  should be impossible. The INTERNAL_ERROR message reported just
  such an assertion failure.
  However, there is no guarantee that the problem will be caught
  by DFHLS2WS and may result in a runtime error when the WSBind
  file is used to populate/interpret the application commarea.
  

Problem conclusion

• ICMImplFromWSDL.java has been changed to correctly propagate
  the current list of suppressed field data-types.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK28332

Modules/Macros

•    DFJ@H176
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R50D PSY UK28332

     UP07/08/24 P F708

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.