IBM Support

IT41539: Support for forward migration to IBM MQ Appliance 9.3 firmware on M2002 hardware

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.


APAR status

  • Closed as program error.

Error description

  • Additional provision is needed within the IBM MQ Appliance 9.2
    firmware (LTS and CD) to allow forward migration of M2002
    hardware to 9.3
    firmware levels.
    This APAR provides the necessary internal logic to allow forward

Local fix

Problem summary

  • ****************************************************************
    Users running IBM MQ 9.2 LTS or CD firmware levels on M2002
    appliance hardware, who wish to migrate forwards to 9.3 firmware
    Platforms affected:

Problem conclusion

  • The IBM MQ Appliance 9.2 firmware has been enhanced to
    facilitate forward migration to 9.3 levels on M2002 appliance
    To upgrade an M2002 appliance to a 9.3 firmware level, a 9.2
    firmware level must be installed that includes this APAR change.
    If an attempt is made to install 9.3 firmware on an M2002
    appliance that is running 9.2 firmware without this APAR change,
    then an error will be reported.
    Upgrading an M2002 appliance to 9.3 is a one-way operation,
    meaning that the appliance cannot be reverted to the 9.2
    firmware level once a 9.3 firmware has been applied. More
    information on updating an M2002 appliance to the 9.3 firmware
    level is available from the IBM documentation pages:
    Note to users planning to update from the IBM MQ Appliance 9.2.5
    firmware to 9.3:
    There is a larger than expected performance impact for queue
    managers that are configured to use an encrypted file system.
    Users who have adopted encrypted file systems with the 9.2.5
    firmware level might observe a performance degradation upon
    migration to 9.3.0. This issue is being investigated by IBM
    under APAR IT41622.
    The fix is targeted for delivery in the following PTFs:
    Version    Maintenance Level
    v9.2 LTS
    The latest available maintenance can be obtained from
    'WebSphere MQ Recommended Fixes'
    If the maintenance level is not yet available information on
    its planned availability can be found in 'WebSphere MQ
    Planned Maintenance Release Dates'

Temporary fix


APAR Information

  • APAR number


  • Reported component name

    MQ APPL M2002 V

  • Reported component ID


  • Reported release


  • Status


  • PE




  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date


  • Closed date


  • Last modified date


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

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

Fix information

  • Fixed component name

    MQ APPL M2002 V

  • Fixed component ID


Applicable component levels

[{"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Product":{"code":"SS5K6E","label":"IBM MQ Appliance"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"920","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
21 December 2022