A fix is available
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
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