Data Collector for WebSphere Message Broker reference

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

ConfigDC syntax

Use the following syntax for the configDC command 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 in ITCAM for Transactions:

default.tt.enabled=true

Specify the address of the Transaction Collector in ITCAM for Transactions. For example:

default.tt.serverstring=tcp:127.0.0.1:5455

Specify this directory to integrate with MQ Tracking in ITCAM for Transactions:

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.

Specify the Transaction Collector queue size connection parameter, that is, the internal Transaction Tracking API buffer of the Data Collector for WebSphere Message Broker:

default.tt.queuesize=50000

Restriction: Do not change this value except if advised to do so by IBM Software Support.

Specify the number of milliseconds for the Data Collector for WebSphere Message Broker to wait when attempting to connect to the Transaction Collector:

default.tt.connecttimeout=30000

Specify the number of times the Data Collector for WebSphere Message Broker attempts to connect to a Transaction Collector:

default.tt.connectretries=0

If the value is 0, the Data Collector for WebSphere Message Broker keeps trying to connect.

Specify the interval in milliseconds between attempts by the Data Collector for WebSphere Message Broker to connect to a Transaction Collector:

default.tt.connectretryinterval=5000

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