IBM Support

IT31459: userrestore command on MQ appliance fails with AMQ6650

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

  • <p>A backup of users saved with  userbackup command, can't be
    restored.</p><p> </p><p>Error generated on v8 is</p><p><span
    style="background-color:rgb(255, 255, 255)">mqa(mqcli)#
    userrestore -f userbackup</span>
    </p><p>AMQ6650: The userrestore command failed. Error identifier
    ( '406' ,  '1' )</p><p> </p><p><span
    style="background-color:rgb(255, 255, 255)">Error generated on
    v9 is</span></p><p>mqa(mqcli)# userrestore -f
    userbackup</p><p>AMQ6650E: The userrestore command failed. Error
    identifier ( '405' ,  '1' )                            </p>
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    MQ appliance users running userrestore command when backup
    contains large number of users
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    A logical error in MQ appliance code caused the userrestore
    command to not properly restore the users when the backup had a
    group(e.g. "users") with a large number of members
    

Problem conclusion

  • MQ appliance code has been modified to make sure the userrestore
    command restores the users as expected in this scenario
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.0       8.0.0.15
    v9.1 CD    TBC.
    v9.1 LTS   9.1.0.5
    
    The latest available maintenance can be obtained from
    'WebSphere MQ Recommended Fixes'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
    
    If the maintenance level is not yet available information on
    its planned availability can be found in 'WebSphere MQ
    Planned Maintenance Release Dates'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT31459

  • Reported component name

    IBM MQ APPL M20

  • Reported component ID

    5725Z0900

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-01-09

  • Closed date

    2020-03-30

  • Last modified date

    2020-03-30

  • 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

    IBM MQ APPL M20

  • Fixed component ID

    5725Z0900

Applicable component levels

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS5K6E","label":"IBM MQ Appliance"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
30 March 2020