IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Disable various types of Byte Code Instrumentation for J2EE APIs

The data collector uses a technique called Byte Code Instrumentation (BCI) to collect data from various types of J2EE APIs that typically operate as nested requests. BCI is automatically enabled for these types of APIs. It can be disabled by adding lines to the custom_directory/toolkit_custom.properties file.

Disable instrumentation of one or more of the following types of APIs by adding the following lines to the toolkit_custom.properties file:


Adding lines to toolkit_custom.properties

Type of J2EE API Line to add to toolkit_custom.properties file
Enterprise JavaBeans (EJB)
com.ibm.tivoli.itcam.toolkit.ai.enableejb=false
Java Connector Architecture (JCA)
com.ibm.tivoli.itcam.toolkit.ai.enablejca=false
Java Database Connectivity (JDBC)
com.ibm.tivoli.itcam.toolkit.ai.enablejdbc=false
Java Naming and Directory Interface (JNDI)
com.ibm.tivoli.itcam.toolkit.ai.enablejndi=false
Java Message Service (JMS)
com.ibm.tivoli.itcam.toolkit.ai.enablejms=false
Servlets/JavaServer Pages (JSP)
com.ibm.tivoli.itcam.toolkit.ai.enableservlet=false
HTTP session count tracking
com.ibm.tivoli.itcam.toolkit.ai.enablesessioncount=false
CICS® Transaction Gateway (CTG)
com.ibm.tivoli.itcam.dc.ctg.enablectg=false
IMS™
com.ibm.tivoli.itcam.dc.mqi.enableims=false
Java Data Objects (JDO)
com.ibm.tivoli.itcam.dc.mqi.enablejdo=false
Message Queue Interface (MQI)
com.ibm.tivoli.itcam.dc.mqi.enablemqi=false
Axis web service (only on JBoss and WebLogic)
com.ibm.tivoli.itcam.toolkit.ai.axis.enablewebservice=false
Remote Method Invocation (RMI)
am.ejb.rmilistener.enable=false

For performance reasons, you can also disable BCI for several API types only for Level 1 monitoring. In this case, BCI will for the API types be enabled only when the monitoring level is set to 2 or 3.

To do this, add (or uncomment) the following lines in the custom_directory/toolkit_custom.properties file.


Modifying lines in toolkit_custom.properties

Type of J2EE API Line to add to toolkit_custom.properties file
JCA
com.ibm.tivoli.itcam.toolkit.ai.jca.callback.unconditional=false
JDBC
com.ibm.tivoli.itcam.toolkit.ai.jdbc.callback.unconditional=false
JNDI
com.ibm.tivoli.itcam.toolkit.ai.jndi.callback.unconditional=false
JMS
com.ibm.tivoli.itcam.toolkit.ai.jms.callback.unconditional=false


Parent topic:

Customization and advanced configuration for the data collector