IC89394: SETMQM FAILS TO UPDATE INSTALL NAME IF QUEUE MANAGER FILE SYSTEM IS NOT AVAILABLE

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • "setmqm" command might fail with error AMQ6237 if the queue
    manager file system is not available.
    
    Example:
    
    AMQ6237: File '/var/mqm/qmgrs/MYQMGR/qmstatus.ini' missing.
    
    WebSphere MQ queue manager in HACMP high availability
    configuration fails to start after the file system for the
    failed node is mounted on the surviving node.
    
    In a high availability scenario where the file system for the
    failed node is mounted on the surviving node then an attempt is
    made to start the queue manager for the failed node on the
    surviving node, the following error is seen in log:
    AMQ6292: The queue manager is associated with a different
    installation.
    
    The output of dspmqinf command may show
    InstallationName=Installation1 on the original node but then
    show InstallationName=Installation0 on the failover node.
    
    The /var/mqm/mqs.ini file on node one has an InstallationName
    for the queue manager on node one but that InstallationName
    attribute is missing for node two's queue manager. Issuing the
    setmqm command does not produce an error but the
    
    it is not able to open the qmstatus.ini file when the queue
    manager file system is not accessible.
    
    In a high availability setup where the queue manager file system
    is only available on the backup node if the primary node has
    been failed over (such as with HACMP), the addmqinf will not
    update the existing stanzas in the /var/mqm/mqs.ini for other
    nodes in the cluster, requiring that each and every node in the
    cluster have their respective /MQHA file system available for
    the purpose of updating the QueueManager stanzas in the
    

Local fix

  • Manually update the /var/mqm/mqs.ini file to add or correct
    the InstallationName.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users using setmqm command to update install name on a standby
    node in a high availability setup
    
    
    Platforms affected:
    Solaris x86-64, Solaris SPARC, Linux on zSeries, Linux on
    x86-64, Linux on x86, Linux on S390, Linux on Power, IBM
    iSeries, HP-UX OpenVMS, HP-UX PA-RISC, HP-UX Itanium, AIX
    
    ****************************************************************
    PROBLEM SUMMARY:
    This problem occurred because "setmqm" command required access
    to queue manager file system for validating the configuration
    before updating the install name.
    

Problem conclusion

  • setmqm has been modified to update the install name in mqs.ini
    without validating the queue manager configuration if the
    queue manager file system is not available. If the update is
    successful, then setmqm will display and also log a warning
    message AMQ5658.V-01-05;701;700.01.05;HP-UX (PA-RISC);U839621;20
      -01-05;701;700.01.05;iSeries;tbc_p700_0_1_5;20110204;20111231;
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
      DV-01-06;701;700.01.06;Linux (Power);U841559;20110606;20111231
                       v7.1003;20111231;true;end p,k;701-MDV-01-07;7
    Platform           Fix Pack 7.1.0.311003;20111231;true;end
    --------           --------------------01;true;end p,k;701-MDV-0
    Windows            7.1.0.3true;end p,k;701-MDV-01-08;701;700.01.
    AIX                7.1.0.3dows;U200337;20120514;20120514;true;en
    HP-UX (Itanium)    7.1.0.3ris (x86-64);U849730;20120514;20120514
    Solaris (SPARC)    7.1.0.3701;700.01.09;Linux (Power);U849727;20
    Solaris (x86-64)   7.1.0.301-MDV-01-10;701;700.01.10;HP-UX (Itan
    iSeries            7.1.0.3rue;end p,k;701-MDV-01-10;701;700.01.1
    Linux (x86)        7.1.0.301;Windows;U200338;20120201;20131001;t
    Linux (x86-64)     7.1.0.30-01;710;710.00.01;Solaris (x86-64);U8
    Linux (zSeries)    7.1.0.3p,k;710-MDV-00-01;710;710.00.01;Linux
    Linux (Power)      7.1.0.331001;true;end p,k;710-MDV-00-02;710;7
      10-MDV-00-02;710;710.00.02;Linux (x86-64);7.1.0.2;20130201;201
    Platform           v7.5 added when a doc APAR is opened <DOC_INS
    --------           --------------------AR_TYPE> <APAR_TYPE=mqe>
    Multiplatforms     7.5.0.2G_WORDS_INFO> ;The latest available ma
      support/docview.wss?rs=171&uid=swg27006309 </CLOSING_WORDS_INF
    The latest available maintenance can be obtained from
    'WebSphere MQ Recommended Fixes'ACK_OWNER>  ## Information used
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
      6-64);1;N/A;3;HUO302;86699999999;999;99;000;end Solaris (x86-6
    If the maintenance level is not yet available information on
    its planned availability can be found in 'WebSphere MQ
    Planned Maintenance Release Dates'.wss?rs=171&uid=swg27006309;en
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    IC89394

  • Reported component name

    WMQ BASE MULTIP

  • Reported component ID

    5724H7241

  • Reported release

    750

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-01-08

  • Closed date

    2013-03-14

  • Last modified date

    2013-05-29

  • 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

    WMQ BASE MULTIP

  • Fixed component ID

    5724H7241

Applicable component levels

  • R750 PSY

       UP



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

WebSphere MQ
APAR / Maintenance

Software version:

7.5

Reference #:

IC89394

Modified date:

2013-05-29

Translate my page

Machine Translation

Content navigation