IBM Support

PH18283: MQRC_PROPERTY_NAME_ERROR RC2442 2442 098A AFTER PH03635 / UI60306 19/11/13 PTF PECHANGE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A CALL 'MQSETMP' begin to fail with MQRC_PROPERTY_NAME_ERROR
    after UI60306 was applied.
    The problem occurs because the DSA back chain is no longer set
    after UI60306 is applied - this doesn't affect MQ processing,
    as the callers registers are saved on the stack and are
    correctly restored, however it causes CEEVGTUN to abend U4088
    when called from CSQBLECS because this LE routine attempts to
    validate the dsa chain.
    
    This will only occur when the application CCSID has not already
    been resolved prior to the MQSETMP call - for example when the
    application is compiled/linked using the stub interface (e.g.
    CSQBSTUB) rather than the dlls (e.g. CSQBLB1), and has not
    issued any non message-property API calls prior to message
    property calls.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
    *                 Release 0 Modification 0.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: Message property APIs fail with         *
    *                      MQRC_PROPERTY_NAME_ERROR (MQRC2442)     *
    *                      after UI60306 has been applied.         *
    ****************************************************************
    Following the changes introduced by PH03635, CSQBPAPI was no
    longer chaining its savearea to the caller's. This savearea was
    not used for MQ, which was using the linkage stack to save the
    callers registers.
    However, in some cases CEEVGTUN is called to locate DSA storage,
    and this requires the back chain to be set. As this was not
    set correctly, a U4088-99 abend occurs.
    

Problem conclusion

  • CSQBPAPI is changed to chain its savearea to the callers.
    MQMSGPROP/K
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH18283

  • Reported component name

    IBM MQ Z/OS V9

  • Reported component ID

    5655MQ900

  • Reported release

    000

  • Status

    CLOSED PER

  • PE

    YesPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-10-18

  • Closed date

    2019-11-13

  • Last modified date

    2019-11-30

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

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

    PH18311 UI66403

Modules/Macros

  • CSQBPAPI
    

Fix information

  • Fixed component name

    IBM MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

  • R000 PSY UI66403

       UP19/11/27 P F911 ­

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":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
30 November 2019