IT17408: endmqm -i leads MQ to crash and reports FDC with probe ID XC130031

APAR status

• Closed as program error.

Error description

• An IBM MQ queue manager terminates abrubtly when endmqm -i is
  issued. The following Failure Data Capture (FDC) record is
  generated:
  
  FDC summary:
  
  ...
  | Probe Id          :- XC130031
        |
  | Application Name  :- MQM
  |
  | Component         :- xehExceptionHandler
  |
  | SCCS Info         :-
  F:\build\slot1\p800_P\src\lib\cs\pc\winnt\amqxerrn.c,  |
  ...
  | Major Errorcode   :- xecF_E_UNEXPECTED_SYSTEM_RC
  ...
  | Comment1          :- Access Violation at address...
  ...
  MQM Function Stack
  ccxResponder
  rrxResponder
  ccxReceiveThreadFn
  cciProcessOne
  cciProcessUserData
  cciProcessAsyncRcv
  rriServerAsyncRcv
  rstReceiveMessageRequest
  rstCheckForOneMessage
  rstHandleMsgExpansion
  xcsFFST
  
  
  From the FDC the following waiter structure can be seen.
  
  hAsyncWaiter
         {
           Self:                 02::05::05-18155840
           Active                FALSE
           Status:               20800872
           Options:
  MQGMO_FAIL_IF_QUIESCING|MQGMO_SYNCPOINT|MQGMO_PROPERTIES_FORCE_M
  QRFH2
           SetTime:              2016-09-22 06:20:47.819
           DataLength            4096
  Page 29 of 41
           ReturnableLength      0
           hBuffer:              9612 : 0x0000000004A4AC60 :
  01::02::02-01678432
           InitialPropertyOption: None
           PropLength:           0
           WaiterConnId:         1293
           UsingAsync:           TRUE
           QueueChecked:         TRUE
           MasterWaiter:         02::05::05-18154944
           MasterWaiter->Active: FALSE
  

Local fix

• Use endmqm -c (equivalent to endmqm with no flags) to gracefully
  quiesce the queue manager.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All MQ users who issue endmqm -i against a running queue manager
  which has waiting getters inside an asynchronous consume
  operation.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  A logic error when handling the immediate shutdown request could
  cause the queue manager to access an invalid memory address,
  which would terminate the queue manager process.
  

Problem conclusion

• The MQ queue manager logic has been updated to avoid the
  termination in this case.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v8.0       8.0.0.6
  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