The Java Connector Development Kit supports various standards for communication with other systems and frameworks. Among these are the Common Event Infrastructure, which provides interoperability with other IBM WebSphere event-producing applications, and Application Response Measurement instrumentation support, which makes transaction metrics from the connector and application available to the IBM Tivoli Monitoring for Transaction Performance framework. For more information about these standards, see:
Java-based connectors are compatible with IBM's Common Event Infrastructure, a standard for event management that permits interoperability with other IBM WebSphere event-producing applications. When you implement Common Event Infrastructure support in your connector, events produced by the connector can be received (or "consumed") by another Common Event Infrastructure- compatible application.
You must have the following software installed to implement the Common Event Infrastructure in the connector:
WebSphere Application Server Foundation includes the Common Event Infrastructure Server Application, which is required for Common Event Infrastructure to operate. The WebSphere Application Server Foundation can be installed on any system (it does not have to be the same machine on which the adapter is installed.) The WebSphere Application Server Application Client includes the libraries required for interaction between the adapter and the Common Event Infrastructure Server Application. You must install WebSphere Application Server Application Client on the same system on which you install and run the connector. The connector connects to the WebSphere Application Server Foundation server by means of a configurable URL. Common Event Infrastructure support is available using any integration broker supported with this release.
Common Event Infrastructure functionality is enabled with the standard properties CommonEventInfrastructure and CommonEventInfrastructureContextURL, configured with Connector Configurator. By default, Common Event Infrastructure is not enabled. The CommonEventInfrastructureContextURL property enables you to configure the URL of the Common Event Infrastructure server.(Refer to Appendix A, Standard Properties, for more information.).
If Common Event Infrastructure is enabled, the connector generates Common Event Infrastructure events that map to the following adapter events:
For another application (the "consumer application") to receive the Common Event Infrastructure events generated by the connector, the application must use the Common Event Infrastructure event catalog to determine the definitions of appropriate events and their properties. The events must be defined in the event catalog for the consumer application to be able to consume the sending application's events.
For more information about Common Event Infrastructure, refer to the Common Event Infrastructure information in the WebSphere Application Server Foundation documentation. This is available on the web at the IBM WebSphere Application Server Information Center.
Java-based connectors are compatible with the Application Response Measurement application programming interface (API), an API that allows applications to be managed for availability, service level agreements, and capacity planning. The connector calls the ARM APIs to participate in IBM Tivoli Monitoring for Transaction Performance , allowing collection and review of data concerning transaction metrics.
In addition to the software prerequisites required for the adapter, you must have the following installed for ARM to operate with the connector:
Application Response Measurement support is available using any integration broker supported with this release.
ARM instrumentation is enabled by setting the standard property TivoliMonitorTransactionPerformance in Connector Configurator to "True". By default ARM support is not enabled. (Refer to Appendix A, Standard Properties, for more information.)
When ARM is enabled, the transactions that are monitored are service events and event deliveries. The transaction is measured from the start of a service request or event delivery to the end of the service request or event delivery. The name of the transaction displayed on the Tivoli Monitoring for Transaction Performance console will start with either SERVICE REQUEST or EVENT DELIVERY. The next part of the name will be the business object verb (such as CREATE, RETRIEVE, UPDATE or DELETE). The final part of the name will be the business object name such as "EMPLOYEE." So for example, the name of a transaction for an event delivery for creation of an employee might beEVENT DELIVERY CREATE EMPLOYEE. Another might be SERVICE REQUEST UPDATE ORDER.
The following metrics are collected by default for each type of service request or event delivery:
You can select which of these metrics to display, for which connector events, by configuring Discovery Policies and Listener Policies for particular transactions from within the Tivoli Monitoring for Transaction Performance console. (Refer to For more information.)
Refer to the IBM Tivoli Monitoring for Transaction Performance documentation for more information.