About the Gateway

The IBM Tivoli Netcool/OMNIbus Gateway for Tivoli EIF uses the IBM Tivoli Netcool/OMNIbus Gateways Toolkit (NGTK) library, which provides the basic framework for the gateway process. The NGTK library is installed as a part of Tivoli Netcool/OMNIbus.

Gateway type

The Gateway for Tivoli EIF is a unidirectional gateway that enables events to flow in one direction, from a source ObjectServer to a Tivoli Event Integration Facility (Tivoli EIF) event consumer. Changes made in the source ObjectServer are reflected in Tivoli EIF, but changes in Tivoli EIF are not reflected in the source ObjectServer.

See the IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide for more information about unidirectional gateways.

Information flow

The gateway is comprised of reader/writer, mapper, and writer components. The flow of information between the components is as follows:
  1. The reader/writer component reads from the source ObjectServer and passes the data to the mapper component.
  2. The mapper component receives data from the reader component, transforms the data into an appropriate form for the target writer using the map definition file (tivoli_eif.map), and passes the data to the writer component.
  3. The writer component receives the source data from the mapper component and writes it to Tivoli EIF.
Note: The gateway adds a new Tivoli EIF attribute (gateway_instance) to each Tivoli Netcool/OMNIbus event sent to Tivoli EIF. This enables you to identify which gateway sent which events to Tivoli EIF. The values of the gateway_instance attribute is determined by the Gate.TIVOLI_EIF.GWInstanceName property defined in the NCO_GATE.props properties file.

Centralized property management

The gateway uses centralized property management and separates properties from data processing configuration. The gateway can be configured using configuration files; for details, see Configuring the gateway.