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

WebSphere MQ V7.0 Fix Pack 7.0.1.12
Fix Pack 7.1.0.5 for WebSphere MQ V7.1
WebSphere MQ V7.5 Fix Pack 7.5.0.4

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 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