IBM Support

IC97587: WEBSPHERE MQ .NET CLIENT APPLICATION REPORTS AN UNHANDLED NMQIEXCEPTION IN MANAGEDNMQIMQ.MQCONNX

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • If the Queue manager ends, when the client application connects,
    an unhandled exception is thrown from MQCONNX.
    
    NmqiException thrown from GetQueueManagerInfo is not properly
    handled by ManagedNmqiMQ.MQCONNX.
    
    The .Net client trace shows:
     IBM.WMQ.Nmqi.NmqiException: Exception of type
    'IBM.WMQ.Nmqi.NmqiException' was thrown.
     at IBM.WMQ.Nmqi.NmqiTools.GetQueueManagerInfo
    (NmqiEnvironment env, NmqiMQ mq, Hconn hconn) in
     C:\path\to\ NmqiTools.cs:line 1021
     at IBM.WMQ.Nmqi.ManagedHconn.UpdateHconn(NmqiMQ mqInstance,
    Phconn phconn) in
    C:\path\to\ ManagedHconn.cs:line 354
     at IBM.WMQ.Nmqi.ManagedNmqiMQ.MQCONNX(String pQMgrName,
    MQConnectOptions pConnectOpts, Phconn phconn, Int32&
    pCompCode, Int32& pReason) in C:\path\to\ManagedNmqiMQ.cs:line
    769
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users of .NET applications connecting to the queue manager
    through managed/unmanaged/bindings mode
    
    
    Platforms affected:
    Windows
    
    ****************************************************************
    PROBLEM SUMMARY:
    WebSphere MQ .Net client code is not gracefully handling the
    NMQIException thrown to MQCONN(X) call. NMQIException can be
    thrown from NmqiTools.GetQueueManagerInfo if the queue manager
    ends when the client connects.
    

Problem conclusion

  • WebSphere MQ .Net client code has been modified such that the
    unhandled exception is handled gracefully in MQCONN(X) calls
    while connecting to the queue manager through
    managed/unmanaged/bindings mode. The NMQIException caught by
    MQCONN(X) will be re thrown has MQException to the application.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.0       7.0.1.12
    v7.1       7.1.0.5
    v7.5       7.5.0.4
    
    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

    IC97587

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    701

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-11-12

  • Closed date

    2013-12-05

  • Last modified date

    2013-12-05

  • 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 WINDOWS V7

  • Fixed component ID

    5724H7220

Applicable component levels

  • R701 PSY

       UP

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ63","label":"APAR \/ Maintenance"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
05 December 2013