Previous Topic: Configure the Native MQ CAI API ExitNext Topic: Generate Transactions from the ITKO_PATHFINDER Queue

Using CA Continuous Application Insight › Native MQ CAI › Configure the Agent Properties for Native MQ CAI

Configure the Agent Properties for Native MQ CAI

The DevTest Java Agent includes a set of Native MQ CAI properties that you must configure.

By default, Native MQ CAI monitors all the queues of a queue manager. You can use the Include queues and Exclude queues properties to override this behavior. The property values are regular expressions. The Exclude queues property takes precedence over the Include queues property. If you want to specify a queue name that contains a dot character, place a backslash immediately before the dot character. If you want to use a dot character as a regular expression construct, you do not need to include a backslash.

If the system under test uses an uncommon pattern, Native MQ CAI might need help determining which queue/message is a request and which queue/message is a response. In this scenario, try adding the optional QUEUE_REQUEST_MATCHES and QUEUE_RESPONSE_MATCHES properties to the rules.xml file. Set the values to regular expressions. The regular expressions are evaluated against the message payload. For example:

<property key="QUEUE_REQUEST_MATCHES:SOME_REQUEST_QUEUE" value=".*"/>
<property key="QUEUE_RESPONSE_MATCHES:SOME_RESPONSE_QUEUE" value=".*<response>.*"/>

Follow these steps:

  1. Open the Agents window.
  2. In the left portion, select the agent.
  3. Click the Settings tab.
  4. Select the MQMirror category.
  5. Set the Queue name property to ITKO_PATHFINDER. This value is the only valid value.
  6. Set the Queue manager name property to the queue manager that owns the queues that you want to monitor.
  7. Set the Host property to the IP address or host name of the server where WebSphere MQ is running.
  8. Set the Port property to the port number on which WebSphere MQ is listening for connection requests.
  9. Set the Channel name property to the WebSphere MQ channel for connecting to the queue manager.
  10. (Optional) Set the Connect interval property.
  11. If you need a user and password to access WebSphere MQ, set the User and Password properties.
  12. If you want to specify which queues to include, set the Include queues property.
  13. If you want to specify which queues to exclude, set the Exclude queues property.
  14. Click Save.