PI86039: Mapping Level 4.2 which adds support for the 'additionalProperties' keyword in JSON Schema documents.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR adds Mapping Level 4.2, which adds support for the
  'additionalProperties' keyword in JSON Schema documents.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR adds Mapping Level 4.2, which *
  *                      adds support for the                    *
  *                      'additionalProperties' keyword in JSON  *
  *                      Schema documents.                       *
  ****************************************************************
  This APAR adds Mapping Level 4.2, which adds support for the
  'additionalProperties' keyword in JSON Schema documents.
  

Problem conclusion

Temporary fix

Comments

• In addition to adding support for 'additionalProperties', this
  APAR also improves the performance of the Java based data
  transformation service for JSON, and fixes some functional
  problems.
  
  The problems fixed are:
  
   1. PIC 'Z' toleration for COBOL; the presence of spaces within
      a PIC Z field causes INVALID_ZONED_DEC errors in CICS.
  
   2. A positively signed value in an unsigned field causes an
      INVALID_ZONED_DEC error in CICS.
  
   3. A completely empty JSON Object at the root of a JSON message
      causes a "JSON data is not well formed" error response for
      JSON Web Services in CICS.
  
   4. JSON request messages parsed as CCSID 1200 (UTF-16) using
      the non-Java mechanism report INVALID CHARACTER errors when
      processing a Byte Order Marker.
  
   5. JSON response messages generated as CCSID 1200 (UTF-16)
      using the non-Java mechanism contain SUB codes for some
      characters.
  
  Most users of Java based JSON data transformation in CICS
  (including z/OS Connect) will experience a small performance
  improvement from applying this APAR.
  
  Users of CICS JSON Web Services (a technology built upon Axis2,
  and using 'Classpath' style JVMSERVER resources) will find that
  Axis2 Handler programs cannot be used for JSON following
  application of this APAR. A JVM property of
  -Dcom.ibm.cics.json.enableAxis2Handlers=true may be added to the
  JVM Profile for the Classpath JVMSERVER to restore the older
  processing. Enabling that option disables the performance
  benefits of this APAR, and will trigger a DFHPI1009 message if
  the new mapping level 4.2 capabilities are used. Users of z/OS
  Connect will not be affected by this issue.
  
  
  JSON formating:
  
  The low-level formatting of JSON documents may change following
  application of this APAR. In some scenarios, especially those
  in which JSON is formatted using a Java conversion process,
  JSON data may be produced in a form logically equivalent to
  what was produced before, but physically different. For example,
  a number that would previously be generated as "0E-18" might
  now be generated as "0.000000000000000000". The two lexical
  values have equivalent meaning.
  
  
  Mapping Level 4.2:
  
  As with all other mapping levels, mapping level 4.2 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.2.  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.2.
  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.2 is support in
  DFHJS2LS for 'Additional Properties' in JSON Schema, this
  capability is not available at older mapping levels.
  
  As with all other mapping levels, other usability enhancements
  and defect corrections may also be experienced. Mapping level
  4.2 has (as with other mapping levels before it) automatically
  enabled some enhancements that were previously only available
  to users through the MAPPING-OVERRIDES parameter. This includes
  the LESS-DUP-NAMES and HYPHENS-AS-UNDERSCORES options. Those
  enhancements are part of the basic mapping experience for all
  users at mapping level 4.2.
  

APAR Information

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

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

  UI52356 UI52357

Modules/Macros

• DFHECEI  DFHEPAS  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@H351 DFJ@H389 DFJ@H403 DFJ@H433
  DFJ@H441 DFJ@H465
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI52356

     UP17/12/05 P F712

• R10D PSY UI52357

     UP17/12/05 P F712

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.