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