IBM Support

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

Subscribe

You can track all active APARs for this component.

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 number

    PI91113

  • Reported component name

    RATL INTEGRA TE

  • Reported component ID

    5725G79IT

  • Reported release

    910

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-12-05

  • Closed date

    2018-04-23

  • Last modified date

    2018-04-23

  • 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



Document information

More support for: Rational Test Workbench

Software version: 910

Reference #: PI91113

Modified date: 23 April 2018