IBM Support

PI90119: CICS IS NOT USING THE CHANNEL NAME DEFINED IN THE CHANNEL DESCRIPTION DOCUMENT WHEN PROCESSING A JSON WEB SERVICE.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • I have created a wsbind file using DFHLS2JS with a channel
    description document describing the input channel name,
    container name and pointing to the PDS structure.
    
    When the request comes in, the channel name that is used
    instead of the one I have defined is DFHNODE. Because it is not
    using the channel name that I have specified, this causes a
    channel not found to occur.
    Additional Symptom(s) Search Keyword(s): KIXREVEPH
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Channel described in channel            *
    *                      description document is passed to JSON  *
    *                      web service with an incorrect name.     *
    ****************************************************************
    A JSON web service is created in CICS, using the native
    (non-Java) implementation.  A channel description document was
    provided as input to DFHLS2JS to describe the structure of the
    request and response data.
    
    When called, the containers described by the channel description
    document are passed to application program in channel DFHNODE,
    rather than the channel specified in the channel description
    document.  As a result any EXEC CICS GET CONTAINER calls made by
    the application program to retrieve the containers from the
    expected channel will fail with a CHANNELERR condition if they
    specify the channel name.
    
    When using CICS TS for z/OS 5.4, the program is passed an
    empty DFHNODE channel.
    
    Using either CICS TS for z/OS 5.3 or 5.4, any containers created
    in the channel specified by the channel description document are
    freed upon completion of the program so are not returned in the
    response.
    

Problem conclusion

  • DFHPIJS has been modified to rename the DFHNODE channel if a
    channel description document has been used, before the
    application program is called.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI90119

  • 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

    2017-11-10

  • Closed date

    2018-02-23

  • Last modified date

    2018-03-01

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

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

    UI54032 UI54033

Modules/Macros

  • DFHPIJS
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R000 PSY UI54032

       UP18/02/27 P F802

  • R100 PSY UI54033

       UP18/02/28 P F802

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:
01 March 2018