PI95139: 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

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.3.0 Knowledge Center and the
  CICS Transaction Server for z/OS 5.4.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 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:

  UI57327 UI57328 UI57329 UI57330

Modules/Macros

• DFHECEI  DFHEPAS  DFHMLJS  DFHMLTF  DFHPIA1  DFHPIAD  DFHPIAT
  DFHPICA  DFHPICC  DFHPIDM  DFHPIDSH DFHPIDUF DFHPIII  DFHPIIW
  DFHPIJG  DFHPIJP  DFHPIJP1 DFHPIJS  DFHPIJW  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@H441
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI57327

     UP18/07/19 P F807

• R00D PSY UI57328

     UP18/07/19 P F807

• R100 PSY UI57329

     UP18/07/19 P F807

• R10D PSY UI57330

     UP18/07/19 P F807

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.