Data Collector for WebSphere Message Broker reference

ConfigDC syntax

Use the configDC script to enable and configure the Data Collector for WebSphere Message Broker environment.

configDC.sh/bat [-enable |-disable] broker_installdir

where:

-enable, configures the environment to load the KK3UserExit
-disable, removes the KK3UserExit from the environment
broker_installdir, Message Broker installation directory (optional)
If broker_installdir is specified, the Data Collector for WebSphere Message Broker is enabled for that broker only.

If broker_installdir is not specified, the Data Collector for WebSphere Message Broker checks for $MQSI_WORKPATH to determine whether to enable the current broker installation or all installations.

KK3.dc.properties

Use the k3/config/KK3.dc.properties configuration file to configure Data Collector for WebSphere Message Broker. The configuration file is reloaded whenever it is updated.

Apply settings globally using the prefix default. For example, enable the Data Collector for WebSphere Message Broker:

# Enable monitoring for all execution groups
default.monitor=on

Enable data to be sent to the Transaction Collector:

default.tt.enabled=true

Specify the address of the Transaction Collector. For example:

default.tt.serverstring=tcp:127.0.0.1:5455

Specify this directory to integrate with MQ Tracking:

default.ttdc.mq.installdir=path-to-MQTracking-installation-directory

For example, default.ttdc.mq.installdir=C:\IBM\ITM\TMAITM6\kth on Windows, or /opt/IBM/WMB/aix533/th on AIX.

Integrate with the ITCAM for SOA Services Management agent. When enabled, Data Collector for WebSphere Message Broker populates the ITCAM for SOA Services Management agent workspaces and responds to ITCAM for SOA take action commands.

default.kd4.enabled=true

When the setting has been enabled to integrate with the ITCAM for SOA agent (default.kd4.enabled=true), the global settings for monitor, log, and trace are ignored and are overwritten by per-Execution Group settings controlled by the ITCAM for SOA agent. View these settings in ITCAM for SOA's Services Management Agent workspace. Modify the settings using the ITCAM for SOA take action commands.

Data Collector for WebSphere Message Broker produces an operator log with diagnostic messages. Set the logging level to info, warn, or error.

default.log=info

If required, Data Collector for WebSphere Message Broker can produce trace logs for L3 support. Only enable trace logs when troubleshooting problems.

default.trace=on