IBM Support

PH68152: USER REPORTS UNEXPECTED VALUES ARE RETURNED TO AN IMS APPLICATION CAUSING UNPREDICTABLE RESULTS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A program runs as a transaction in an IMS MPP region. Upon
    completion of API calls the MQRC values returned to the
    application are invalid leading to the application abnormally
    terminating. Development finds the problem is in the V940 IMS
    stub CSQQSTUB which can pass an invalid reason code back to the
    application in some scenarios where it should return
    MQRC_HCONN_ERROR but instead the stub ends up returning the
    value in GPR5 from before the call.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
    *                 Release 4 Modification 0.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: IMS application MQ API call fails with  *
    *                      completion code MQCC_FAILED but with an *
    *                      invalid reason code.                    *
    ****************************************************************
    If an IMS application linked with the CSQQSTUB stub makes an MQ
    API call with an invalid connection handle, then in some cases
    the API call may fail with an invalid reason code.
    

Problem conclusion

  • MQ API calls from IMS applications with an invalid connection
    handle will fail with reason code MQRC_HCONN_ERROR in all cases.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH68152

  • Reported component name

    IBM MQ Z/OS V9

  • Reported component ID

    5655MQ900

  • Reported release

    400

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2025-09-16

  • Closed date

    2025-10-17

  • Last modified date

    2025-11-30

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

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

    UO05398

Modules/Macros

  • CSQQSTUB
    

Fix information

  • Fixed component name

    IBM MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

  • R400 PSY UO05398

       UP25/11/12 P F511

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":"BU048","label":"IBM Software"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"400","Line of Business":{"code":"LOB77","label":"Automation Platform"}}]

Document Information

Modified date:
30 November 2025