IT39579: FDCs XC721050 and ZS142010 generated from the amqiclen process when uninstalling IBM MQ

APAR status

• Closed as program error.

Error description

• In an IBM MQ HA or DR environment, the addmqinf command is used
  to
  add the QueueManager stanza into mqs.ini. If the queue manager
  is not
  started on the standby node at least once then the following
  failure data capture (FDC) records are
  generated from amqiclen program during uninstallation:
  .
  XC721050 xcsCreateFile xecF_E_UNEXPECTED_SYSTEM_RC OK AMQ6119S
  ZS142010 zslEnqueue    OK
                                               OK AMQ6125E
  
  FDC details:
  Probe Id          :- XC721050
  Component         :- xcsCreateFile
  Program Name      :- amqiclen
  Major Errorcode   :- xecF_E_UNEXPECTED_SYSTEM_RC
  Minor Errorcode   :- OK
  Probe Type        :- MSGAMQ6119
  Probe Severity    :- 1
  Probe Description :- AMQ6119S: An internal IBM MQ error has
  occurred ('2 - ' from open.)
  Arith1            :- 2 (0x2)
  Comment1    :- '2 - ' from open.
  
  MQM Function Stack
  amqiclen_main
  xcsDestroySharedSubpool
  xstGetSubpoolsLock
  xstAccessSubpoolsLock
  xcsCreateFile
  xcsFFST
  
  Probe Id          :- ZS142010
  Component         :- zslEnqueue
  Program Name      :- amqiclen
  Major Errorcode   :- OK
  Minor Errorcode   :- OK
  Probe Type        :- INCORROUT
  Probe Severity    :- 4
  Probe Description :- AMQ6125E: An internal IBM MQ error has
  occurred.
  Comment1          :- Enqueue Lock Directory does not exist
  Comment2          :- /var/mqm/sockets/QmgrName/qmgrlocl
  
  MQM Function Stack
  amqiclen_main
  zslEnqueue
  xcsFFST
  

Local fix

• Ignore the FDC records
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users uninstalling IBM MQ on a node where the QueueManager
  stanza entry was added using addmqinf and the queue manager was
  never started on that node
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  A defect in IBM MQ meant that the addmqinf command did not
  create the necessary directory structure when the queue manager
  file system was unavailable. This caused IBM MQ to generate FDC
  records reporting a missing directory or file during
  uninstallation.
  

Problem conclusion

• The IBM MQ code has been modified to recreate the necessary
  directory structure even when the queue manager file system is
  unavailable.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.1 LTS   9.1.0.11
  v9.2 LTS   9.2.0.6
  v9.x CD    9.3.0.0
  
  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

  MQ BASE V9.2

• Fixed component ID

  5724H7281

Applicable component levels