Configure ActiveMQ Mirroring

For troubleshooting purposes, a 'mirror' queue can be set up in the ActiveMQ application configuration so that received ActiveMQ messages display in the IMS Integration Hub. Because IMS Integration Hub reads messages in a process similar to database record deletion, it is not always possible to find and view processed messages. A mirror queue retains copies of read ActiveMQ messages for display in the IMS Integration Hub Message Log Viewer.

The ActiveMQ service must be stopped before making changes to its configuration. The service can be restarted when configuration is complete.

Note: Depending on your ActiveMQ configuration, you may need to manually create the mirror queue in the ActiveMQ application or it may be automatically created when the ActiveMQ service starts.

Activity Steps

  1. Open Windows Notepad or an alternative text editor with administrator permissions.
  2. Open the activemq.xml configuration file (usually located in the apache-activemq-X.X\conf subfolder of the ActiveMQ folder, where X.X is a version number).
  3. In the transportConnectors section, add the following code:
    Copy
    <destinationInterceptors>
      <virtualDestinationInterceptor>
        <virtualDestinations>
          <compositeQueue name="iHub" forwardOnly="false">
            <forwardTo>
              <queue physicalName="iHub.QMirror"/>
            </forwardTo>
          </compositeQueue>
        </virtualDestinations>
      </virtualDestinationInterceptor>
    </destinationInterceptors

    4. Where:

    • compositeQueue name—Name of the ActiveMQ message queue to mirror
    • queue physicalName—Name of the mirror queue
  4. Save and close the activemq.xml file.