PI91113: WEBSPHERE MQ STUBS FAIL TO START WITH RULES NAMELIST [RIT.DIVERT.RULES] ERROR

Rational Performance Test Server 9.2
Rational Test Virtualization Server 9.2
Rational Integration Tester 9.2

APAR status

• Closed as program error.

Error description

• Attempts to start an MQ stub fail with the following error:
  
  [CRRIT8806E] Failed to start proxy route: An exception occurred
  while adding a rule to the rules namelist [rit.divert.rules],
  com.ghc.a3.mq.control.pcf.QueueManagerAdministrator$CannotLockNa
  melistException
  
  When the stub detects that the MQ server connection is broken it
  is stopped.  In the case of an MQ stub that is performing sift &
  pass-through, part of the terminate logic attempts to remove the
  rule that has been created for diverting.  In order to prevent
  multiple stubs altering the master namelist simultaneously the
  code employs a locking mechanism by creating a namelist called
  RIT.DIVERT.RULES_LCK.
  
  When the connection has been broken, there are situations where
  the lock namelist can be created but the MQ server reports that
  it could not create it.
  With the namelist in place, no new stubs can be started.
  
  WORKAROUNDS:
  
  Delete the namelist RIT.DIVERT.RULES_LCK.
  
  To greatly reduce the chances of this happening, update to
  version 9.0.1.1 or newer and configure your MQ transports to
  retry the MQ connection with infinite retries.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Users of Rational Integration Tester MQ API exit.            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Under certain circumstances the API exit locking mechanism   *
  * could fail and leave a namelist present that would then need *
  * to be manually removed before usage could resume.            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• In Rational Integration Tester 9.2.0 an alternative approach is
  used to achieving locking that prevents the namelist from
  remaining on the queue manager.
  

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

  RATL INTEGRA TE

• Fixed component ID

  5725G79IT

Applicable component levels

• R800 PSN

     UP

• R801 PSN

     UP

• R850 PSN

     UP

• R851 PSN

     UP

• R860 PSN

     UP

• R870 PSN

     UP

• R871 PSN

     UP

• R900 PSN

     UP

• R901 PSN

     UP

• R910 PSN

     UP

• R911 PSN

     UP

• R920 PSY

     UP