IBM Support

PH10391: DFHPI1007 ISSUED WITH UNDEFINED_ELEMENT WHEN A NESTING LEVEL WITHIN BRACKETS INCLUDES AN EMPTY OBJECT

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You are parsing a JSON message that includes an array with
    several levels of nested brackets, both square and curly.  This
    message was successfully parsed at CICS TS 5.1, but not at CICS
    TS 5.4.  You receive message:
    
    DFHPI1007 YOURCICS TRAN 01234 JSON to data
    transformation failed because of incorrect input
    (UNDEFINED_ELEMENT YourElement) for JSONTRANSFRM YourResource.
    
    CICS correctly identifies the start of the array of nested
    objects, but when the first object encountered is empty, the
    closing bracket is interpreted as the end of the entire array,
    leading to the the parser losing syncronization with the entire
    structure.
    
    
    Additional Symptom(s) Search Keyword(s): KIXREVPAD
    

Local fix

  • Switch to using the JVM server based JSON parsing logic that
    was used in CICS TS 5.1.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Native JSON parser failed because of    *
    *                      incorrect input (UNDEFINED_ELEMENT X).  *
    *                      Message DFHPI1007 transformation failed *
    *                      occurs.                                 *
    ****************************************************************
    The native JSON parser is used to convert JSON data to
    application data. A JSON schema declares a required array of
    objects. If one of the objects in the array is empty the parser
    thinks it is at the end of the array causing the remaining JSON
    data to be parsed incorrectly.  This will most likely lead to
    message DFHPI1007 with insert UNDEFINED_ELEMENT being issued.
    
    Additional keywords: msgDFHPI1007 PI1007
    

Problem conclusion

  • DFHPIJP1 has been changed to parse empty objects in an array
    correctly.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH10391

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-03-29

  • Closed date

    2019-07-04

  • Last modified date

    2019-08-01

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

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

    UI64081 UI64082

Modules/Macros

  • DFHPIJP1
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R100 PSY UI64081

       UP19/07/08 P F907

  • R200 PSY UI64082

       UP19/07/08 P F907

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:
01 August 2019