PI88519: Mapping Level 4.3 which adds support for Top-Down Multi-dimensional arrays in JSON Schema documents

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR adds Mapping Level 4.3, which adds support for the
  Top-Down Multi-dimensional arrays in JSON Schema documents.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR adds Mapping Level 4.3, which *
  *                      adds support for Top-Down               *
  *                      Multi-dimensional arrays in JSON Schema *
  *                      documents.                              *
  ****************************************************************
  This APAR adds Mapping Level 4.3, which adds support for
  Top-Down Multi-dimensional arrays in JSON Schema documents.
  

Problem conclusion

Temporary fix

Comments

• In addition to adding support for Top-Down Multi-dimensional
  arrays, this APAR fixes the following problems:
  
   1. DEFAULT-ARRAY-MAXITEMS should apply to root level JSON
      arrays in DFHJS2LS.
   2. DFHJS2LS confuses arrays with maxItems=1 and optional
      objects.
   3. Empty JSON Object arrays are parsed as though containing one
      item in the non-Java parser.
   4. Axis2 error messages are embedded in XML without having
      reserved characters escaped causing exceptions to occur.
   5. 'null' keywords in JSON are processed inconsistently, and
      may cause a NullPointerException.
  
  Mapping Level 4.3:
  
  As with all other mapping levels, mapping level 4.3 introduces
  changes to Service enablement; and as with all other mapping
  levels, existing Services deployed using older mapping levels
  are unaffected by the new mapping level. If you have existing
  deployed Services then you are strongly encouraged to leave
  them as-is, do not attempt to regenerate and redeploy the
  associated artifacts at mapping level 4.3.  If you
  attempt to do so, you should expect the generated artifacts to
  have changed (WSDL, Schemas, copybooks, bundles, etc.), and
  that might necessitate changes to either the clients of the
  Service, or to the programs that implement the Service.
  
  New mapping levels are intended for use with new Services. If
  you are planning to generate a new Service, you are always
  encouraged to use the most current mapping level that is
  available to you; as of this APAR that is mapping level 4.3.
  Doing so will ensure you experience the best mapping experience
  that is available to you. In some cases the new mapping
  enhancements are enabled automatically, in others there may be
  new customisation options available by way of input parameters
  to the Assistants. Older mapping levels are retained so that
  you can continue to generate artifacts that are compatible with
  older Services, if you need to do so.
  
  The major new capability at mapping level 4.3 is support in
  DFHJS2LS for Top-Down Multi-dimensional Arrays in JSON Schema,
  this  capability is not available at older mapping levels.
  
  The CICS Transaction Server for z/OS 5.4 Knowledge Center will
  be updated to describe the new functionality.
  

APAR Information

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

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

  UI53223 UI53224

Modules/Macros

• DFHMEPIC DFHMEPIE DFHMEPIK 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@H261
  DFJ@H340 DFJ@H360 DFJ@H389 DFJ@H403 DFJ@H433
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI53223

     UP18/01/18 P F801

• R10D PSY UI53224

     UP18/01/18 P F801

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.