IBM Support

PI93557: NATIVE (NON-JAVA) JSON WEB SERVICE DOES NOT RETURN A CONTAINER DECLARED AS OPTIONAL IN THE CHANNEL DESCRIPTION DOCUMENT.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A JSON Web Service is created using a channel description
    document.  One of the containers in the response channel is
    declared as optional.
    At runtime, despite being populated by the program, the optional
    container is not returned in the JSON response.
    
    Additional Symptom(s) Search Keyword(s): KIXREVDAM
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Optional container missing from JSON    *
    *                      response or DFHPI1008                   *
    *                      CONTAINER_NOT_FOUND.                    *
    ****************************************************************
    A JSON web service is created using DFHLS2JS and channel
    description documents.  The native (non-Java) JSON
    transformation logic is used.
    
    In one scenario the response channel description document lists
    an optional container specified with a language structure.
    Despite being populated by the program the container data is not
    returned in the web service response body.  No error is
    reported.  CICS trace shows that an INQUIRE_CONTAINER call
    for a container called A; (or similar) failed with reason
    CONTAINER_NOT_FOUND.
    
    Alternatively, if the response channel description document
    lists an optional container not described by a language
    structure and this container is populated by the program then
    requests fail with a DFHPI1008 message with insert
    CONTAINER_NOT_FOUND.
    
    Additional keywords: msgDFHPI1008 PI1008
    

Problem conclusion

  • DFHPIJG has been modified to correctly retrieve the contents of
    optional containers when a channel description document is used.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI93557

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    000

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-02-08

  • Closed date

    2018-05-16

  • Last modified date

    2018-06-04

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

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

    UI55880 UI55881

Modules/Macros

  • DFHPIJG
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R000 PSY UI55880

       UP18/05/17 P F805

  • R100 PSY UI55881

       UP18/05/18 P F805

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.3","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.3","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
04 June 2018