IBM Support

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

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 number

    PI86039

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    100

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-08-17

  • Closed date

    2017-12-04

  • Last modified date

    2018-01-03

  • 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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 January 2018