IBM Support

PH56710: DFHJSON-DATA CONTAINER NOT DELETED BY CICS IF IT EXISTS PRIOR TO EXEC CICS TRANSFORM JSONTODATA API CALL.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • While running CICS/TS 5.5 on z/OS 2.4 we noticed that CICS does
    not delete the DFHJSON-DATA container if it exists prior to a
    EXEC CICS TRANSFORM JSONTODATA API call.
    .
    The application program does not specify OUTCONTAINER.
    The dangers of not first deleting the DFHJSON-DATA container
    are that the DFHJSON-DATA container may contain the results
    from the previous EXEC CICS TRANSFORM !
    .
    Looking at the CICS trace, When the DFHJSON-DATA container
    exists, the
    AP E160 EXEC ENTRY TRANSFORM JSONTODATA trace shows
    INCONTAINER('DFHJSON-JSON ' AT X'A6745AF8')
    By the time it gets to the
    PI 3200 PIJS ENTRY - FUNCTION(TRANSFORM_JSON) trace,
    it shows REQUEST_NAME(DFHJSON-DATA) RESPONSE_NAME(DFHJSON-JSON)
    which is the wrong way around!
    

Local fix

  • DELETE DFHJSON-DATA container in your application before
    issuing EXEC CICS TRANSFORM JSONTODATA.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: A program's consecutive TRANSFORM       *
    *                      JSONTODATA call fails.                  *
    ****************************************************************
    When an EXEC CICS TRANSFORM JSONTODATA API command is executed
    and the optional parameter OUTCONTAINER is not specified, CICS
    will put the output into the DFHJSON-DATA container.
    
    If this DFHJSON-DATA container is not deleted and a subsequent
    EXEC CICS TRANSFORM JSONTODATA API call not specifying
    OUTCONTAINER is made, CICS will incorrectly perform a data to
    JSON transformation which will likely fail or cause
    unpredictable results.
    

Problem conclusion

  • DFHEIML has been changed to ensure that a residual DFHJSON-DATA
    container is deleted before the processing of an EXEC CICS
    TRANSFORM JSONTODATA command occurs.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH56710

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    200

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2023-09-04

  • Closed date

    2023-11-14

  • Last modified date

    2023-12-02

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

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

    PH57032 UI94447 UI94448

Modules/Macros

  • DFHEIML
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R200 PSY UI94448

       UP23/11/17 P F311

  • R300 PSY UI94447

       UP23/11/15 P F311

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"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.5","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
04 December 2023