IBM Tivoli Composite Application Agent for J2EE, Version 7.1.1

Disabling 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:

Table 1. 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.

Table 2. 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`

Feedback