IBM Support

PI92602: MQ V9: Name of subscription is lost after qmgr restart

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • After qmgr restart, subscriptions have an empty sub name.
    Before the restart DIS SUB DETAILS shows
    
    SUB(TEST1)
    SUBID(123456789123456789123456789123456789123456789123)
    ......
    afterwards the same display command shows
    SUB()
    SUBID(123456789123456789123456789123456789123456789123)
    ......
    
    The problem can be seen, when an existing subscription is
    altered, and only the subid is used by the alter command to
    identify the subscription.
    

Local fix

  • Use not only the SUBID to identify a subscription, when using
    an ALTER to change a subscription.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
    *                 Release 0 Modification 0.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: After restarting the queue manager,     *
    *                      durable subscriptions no longer         *
    *                      contain a value for the SUB parameter   *
    *                      i.e. the subscription name.             *
    ****************************************************************
    When a durable subscription is defined or altered, the changes
    are persisted to SYSTEM.DURABLE.SUBSCRIPTION.QUEUE so that the
    subscription can be recreated after the queue manager is
    restarted.
    If the ALTER SUB command did not specify a value for the SUB
    parameter, and used only the SUBID parameter to identify the
    subscription, an error in processing the parameters causes the
    subscription name to be incorrectly cleared in the persisted
    record for the subscription, causing the subscription name to be
    lost when the queue manager is next restarted.
    

Problem conclusion

  • CSQMCNSB is changed to correctly detect when only the SUBID
    parameter is used to identify the subscription being altered,
    so that the existing subscription name is correctly retained.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI92602

  • Reported component name

    IBM MQ Z/OS V9

  • Reported component ID

    5655MQ900

  • Reported release

    000

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-01-18

  • Closed date

    2018-01-30

  • Last modified date

    2018-04-03

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

    PI91588

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

    010PC2Ÿ UI53536 010PC2Ÿ 010PC2Ÿ

Modules/Macros

  • CSQMCNSB
    

Fix information

  • Fixed component name

    IBM MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

  • R000 PSY UI53536

       UP18/03/14 P F803

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":"LOB45","label":"Automation"}}]

Document Information

Modified date:
03 April 2018