MQ: on the node types MQInput and MQOutput. Currently MQ tagging is only supported within the IBM Integration Bus Agent. Only MQ messages that are put into a queue by IBM Integration Bus and are read by IBM Integration Bus are tagged.

Installation

Install the AppMon Agent package using the appropriate command (based on your OS) to the machine running the System under Diagnosis (SUD).

Windows*NIX

Select the installation type WebSphere MB to install only the WebSphere Message Broker Agent. With the full Windows installation package, choose installation type Custom and ensure that the installation of the WebSphere Message Broker Agent is enabled.

Use java -jar packagename.jar. You are prompted for the target directory, which defaults to your current one.

Make sure that the AppMon Server is running before deploying the Agent.

WindowsAIX and z/Linux

Create the file %MQSI_WORKPATH%\common\profiles\dtwsmbagent.cmd with the following contents and change <server-address> and <dthome> for your environment:

@echo off
set DT_SERVER=<server-address>
set DT_HOME=<dthome>
rem If not set, DT_AGENTNAME defaults to "WebSphere_MB"
rem SET DT_AGENTNAME=<agentname-prefix>
rem Per default, store the PurePath id in variables/dynaTrace-tag
rem To store it in the Message Broker's environment, set variable name/path. For example:
rem set DT_WSMBTAGPATH=dynaTrace/pathId
set MQSI_USER_EXIT_PATH=%MQSI_USER_EXIT_PATH%;%DT_HOME%\agent\lib

Removing the Agent

To remove the Agent from a Message Broker installation, first disable the dtwsmbagent user exit. This can be done by setting a list of active user exits that does not contain dtwsmbagent.
To disable all user exits, specify an empty list as follows (it has to be executed while the broker is not running):

mqsichangebroker <brokername> -e ""

After disabling the user exit, the Agent is not used anymore but is still loaded by the Message Broker. To avoid this, remove the Agent from the user exit path by removing the dtwsmbagent.sh script (on *NIX) or .cmd script (on Windows).