PH03830: EMPTY ARRAYS NOT BEING TRUNCATED VIA TRUNCATE-NULL-ARRAY-VALUES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Customer is consuming a webservice which is returning all
  occurrences of an array.  DFHLS2WS was used to create a WSBIND
  file with input parameters:
  
  MAPPING-LEVEL=4.1
  TRUNCATE-NULL-ARRAYS=ENABLED
  TRUNCATE-NULL-ARRAY-VALUES=NULL,ZERO,SPACE
  
  The expectation is all empty arrays would not be returned to
  the consumer but this is not happening.
  
  In this instance, it was discovered one of the fields thought
  to be empty actually contained a packed zero.  The x'C' digit
  prevents the truncation logic from determining the array entry
  is empty.
  
  This APAR is being taken to create a new
  TRUNCATE-NULL-ARRAY-VALUES option for
  x'0C', x'0D' and x'0F' so these packed zero values can be
  considered empty when truncation checking occurs.
  
  Additional Symptom(s) Search Keyword(s): KIXREVDAM
  

Local fix

• No Local Fix.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Array truncation is not occurring for a *
  *                      SOAP Web service request despite the    *
  *                      TRUNCATE-NULL-ARRAY-VALUES options of   *
  *                      NULL,SPACE,ZERO being specified for     *
  *                      DFHLS2WS and more than 5 instances of   *
  *                      the array being initialized to nulls,   *
  *                      spaces or zeroes.                       *
  ****************************************************************
  DFHLS2WS is used to convert a language structure that contains
  one or more arrays and the following options are specified:
  TRUNCATE-NULL-ARRAYS=ENABLED
  TRUNCATE-NULL-ARRAY-VALUES=NULL,ZERO,SPACE
  A CICS Web service is invoked and the CICS application returns
  a commarea or container with a data array having more than 5
  instances of records containing nothing other than a mix of
  nulls, spaces, unsigned zoned decimal zeros (0xF0) and
  signed or unsigned packed decimal zeroes (0x0C, 0x0D or 0x0F).
  CICS regards bytes containing nulls, spaces and character zeroes
  as empty but not the packed decimal zeroes. Hence the array is
  not truncated.
  

Problem conclusion

• CICS is changed to extend the TRUNCATE-NULL-ARRAY-VALUES
  options used within the CICS Web Services Infrastructure
  allowing truncation of empty arrays that include packed
  decimal zero characters (0x0C, 0x0D and 0x0F). The CICS
  Transaction Server for z/OS 5.2.0 Knowledge Center will be
  updated to give details of the new PACKEDZERO option for
  the TRUNCATE-NULL-ARRAY-VALUES parameter under the 'Parameter
  descriptions' for the CICS Web Services Assistant
  (DFHLS2WS), XML Assistant (DFHLS2SC), and JSON Assistant
  (DFHLS2JS).
  

Temporary fix

Comments

APAR Information

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

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

  010PC2Ÿ UI60737 UI60738

Modules/Macros

• DFHECEI  DFHEPAS  DFHMLJS  DFHMLTF  DFHPIA1  DFHPIAD  DFHPIAT
  DFHPICA  DFHPICC  DFHPIDM  DFHPIDSH DFHPIDUF DFHPIII  DFHPIIW
  DFHPILN  DFHPIMM  DFHPIPL  DFHPIPM  DFHPIPM2 DFHPIPS  DFHPIRE
  DFHPIRI  DFHPIRL  DFHPIRM  DFHPIRN  DFHPIRS  DFHPISC  DFHPISF
  DFHPISN  DFHPIST  DFHPITC  DFHPITC1 DFHPITC2 DFHPITC3 DFHPITE
  DFHPITH  DFHPITL  DFHPITQ  DFHPITRI DFHPITS  DFHPIUE  DFHPIWR
  DFHPIWT  DFHPIXI  DFHPIXM  DFHPIXO  DFHWSADH DFHWSATR DFJ@H176
  DFJ@H403 DFJ@H450
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R900 PSY UI60737

     UP19/01/18 P F901

• R90D PSY UI60738

     UP19/01/18 P F901

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.