IBM Support

IT39548: Error message reported by crtmqm at MQ 9.1 needs to include additional diagnostic information

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

  • In MQ 9.1 RDQM environment, if the creation of the queue
    manager fails on the Secondary node then  the messages reported
    by the crtmqm command  is not clear enough for the user to
    understand this.
    
    In the below instance the queue manager were unable to be
    created on the Secondary node, however the error message
    reported does not clarify this
    
    [mqm@node001 ~]$ crtmqm -sx -fs 30 -lp 25 -ls 5 RDQMTEST002
    Creating replicated data queue manager configuration.
    The secondary queue manager must first be created on the other
    replicated data nodes.
    You need to run command 'crtmqm -sxs -fs 30720M RDQMTEST002' on
    nodes
    'node002' and 'node003'.
    AMQ3812E: Failed to create replicated data queue manager
    configuration.
    Command '/opt/mqm/bin/crtmqm' run with sudo.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    All users using RDQM feature at IBM MQ version 9.1
    
    
    Platforms affected:
    Linux on x86-64
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    The error message reported by crtmqm command is not useful to
    understand the cause of the failure.
    

Problem conclusion

  • A more useful error message is added to help the user to
    understand the cause for the queue manager creation failure.
    
    [mqm@node1 ~]# crtmqm -sx -fs 1 QM1
    Creating replicated data queue manager configuration.
    AMQ3694E: Failed to create secondary queue manager on
    'testnode1.domain'.
    To see the reason for the failure, run the following command on
    node
    'testnode1.domain':
    crtmqm -sxs -fs 1024M QM1
    AMQ3812E: Failed to create replicated data queue manager
    configuration.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v9.1 LTS   9.1.0.12
    
    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

    IT39548

  • Reported component name

    IBM MQ BASE MP

  • Reported component ID

    5724H7271

  • Reported release

    910

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2022-01-05

  • Closed date

    2022-06-07

  • Last modified date

    2022-09-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 BASE MP

  • Fixed component ID

    5724H7271

Applicable component levels

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"910","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
30 September 2022