IT16143: .NET sample application simplexaget fails and generates an FDC with probe ID AT040010 in component atxClose

APAR status

• Closed as program error.

Error description

• When using the IBM MQ V8 .NET sample application SimpleXAGet
  fails due to the incorrect sequence of transactional calls made
  in the sample. An FDC similar to the one below is generated:
  ----------------------------------------------------------------
   Operating System  :- Windows Server 2012 R2 Server Standard
                        Edition, Build 9200
   PIDS              :- 5724H7251
   LVLS              :- 8.0.0.5
   Product Long Name :- WebSphere MQ for Windows (x64 platform)
   Vendor            :- IBM
   O/S Registered    :- 1
   Data Path         :- C:\ProgramData\IBM\MQ
   Installation Path :- C:\Program Files\IBM\WebSphere MQ
   Installation Name :- Installation1    (1)
   License Type      :- Production
   Probe Id          :- AT040010
   Application Name  :- MQM
   Component         :- atxClose
   ...
   Process Name      :- C:\Program Files\IBM\WebSphere
                        MQ\bin64\amqzlaa0.exe
   ...
   Major Errorcode   :- arcE_XAER_PROTO
   ...
   .
   MQM Function Stack
   zlaMainThread
   zlaProcessMessage
   zlaProcessXARequest
   zlaXAClose
   zsqXAClose
   apiCloseRMI
   atmCloseRMI
   atxClose
   xcsFFST
  ----------------------------------------------------------------
  .
  The other .NET sample application SimpleXAPut also makes an
  incorrect sequence of transactional calls and fails as well.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users using MQ .NET XA sample applications supplied with MQ.
  
  
  Platforms affected:
  Windows
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The sample program SimpleXAPut.cs and SimpleXAGet.cs shipped
  with MQ performed an incorrect sequence of calls that resulted
  in an error condition. The sample incorrectly disconnected the
  queue manager connection before the transaction was committed or
  rolled back.
  

Problem conclusion

• The problem is fixed by altering the sample such that the commit
  or rollback actions are performed before the connection is
  disconnected.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.5       7.5.0.8
  v8.0       8.0.0.6
  v9.0 CD    9.0.1
  v9.0 LTS   9.0.0.1
  
  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 BASE MULTIP

• Fixed component ID

  5724H7251

Applicable component levels