Edit the configuration parameters that the hub monitoring server uses to forward events

IBM Tivoli Monitoring > Version 6.3 Fix Pack 2 > Installation Guides > Installation Guide > Set up event forwarding to Netcool/OMNIbus > Customize Event Integration
IBM Tivoli Monitoring, Version 6.3 Fix Pack 2

Edit the configuration parameters that the hub monitoring server uses to forward events

Edit the hub monitoring server Tivoli Event Integration Facility EIF configuration file to customize the configuration parameters that specify up to five failover Netcool/OMNIbus EIF probes or to adjust size of the event cache.

When the Tivoli Event Integration Facility (EIF) has been enabled on the hub monitoring server and the default EIF server (Tivoli Enterprise Console Event Server or Netcool/OMNIbus EIF probe), and port numbers have been specified, the EIF configuration file is updated with the information. This is the default EIF receiver of forwarded situation events.
See Configure the hub monitoring server to forward events for instructions on configuring the monitoring server to enable the Tivoli Event Integration Facility.
Take the following steps to edit the EIF configuration file:

Open the om_tec.config file:

In the Manage Tivoli Monitoring Services window, right-click Tivoli Enterprise Monitoring Server and click Advanced → Edit EIF Configuration.

Open Install_dir/tables/tems_name/TECLIB/om_tec.config in a text editor where Install_dir is the directory where IBM Tivoli Monitoring is installed and tems_name is the name of the hub monitoring server supplied during monitoring server installation.

Edit any of the event server configuration parameters for the event integration facility.

When you are finished editing om_tec.config, save the file.

You must restart the hub monitoring server or, alternatively, you can use the tacmd refreshTECinfo command to complete the updates without having to restart the monitoring server. To use this command, log in to the command-line interface with tacmd login, then run tacmd refreshTECinfo -t eif to complete the EIF configuration. For more information on this command, see the Command Reference.

Supported Netcool/OMNIbus Probe for Tivoli EIF configuration parameters for the Event Integration Facility (EIF)

Parameters Value Remarks
ServerLocation= tec_server_addr Host name or IP address of the OMNIbus EIF probe. To provide event failover, you can indicate up to five default EIF probes, separating each with a comma. When the default EIF probe is unavailable, the situation event goes to the next server in the list.
ServerPort= [port:0] OMNIbus EIF probe listening port, which is 9998 by default. Specify 0 if the OMNIbus EIF probe uses the port mapper. If you specified multiple server locations, add the corresponding port numbers here, separating each with a comma.
EventMaxSize= 4096 Maximum number of characters allowed in the event. This parameter is disabled by default. To enable it, remove the pound symbol (#) at the beginning of the line.
RetryInterval= 5 Number of times to retry connection with the EIF probe before returning an error.
getport_total_timeout_usec= 50500 Number of seconds to continue attempting to connect to the EIF probe port before timing out. The default is 14 hours.
NO_UTF8_CONVERSION= YES Events are already in UTF8, no conversion is needed. Must be set to YES.
ConnectionMode= co The connection mode.
BufferEvents= YES Whether the EIF buffers the event. This must be set to YES.
BufEvtMaxSize= 4096 Maximum size of the event cache. The default is initially 4096 KB and you can change it here.
BufEvtPath= ./TECLIB/om_tec.cache Path of the event cache file. The default is ./TECLIB/om_tec.cache.
FilterMode= OUT Enable event filtering. This is set to OUT by default.
Filter: Class=ITM_Generic; master_reset_flag=’’; To filter out specific classes, use this keyword. By default, situation events of the class ITM_Generic and those that send no master reset flag are not forwarded.

Parent topic:
Customize Event Integration

+
Search Tips | Advanced Search

Parameters	Value	Remarks
ServerLocation=	tec_server_addr	Host name or IP address of the OMNIbus EIF probe. To provide event failover, you can indicate up to five default EIF probes, separating each with a comma. When the default EIF probe is unavailable, the situation event goes to the next server in the list.
ServerPort=	[port:0]	OMNIbus EIF probe listening port, which is 9998 by default. Specify 0 if the OMNIbus EIF probe uses the port mapper. If you specified multiple server locations, add the corresponding port numbers here, separating each with a comma.
EventMaxSize=	4096	Maximum number of characters allowed in the event. This parameter is disabled by default. To enable it, remove the pound symbol (#) at the beginning of the line.
RetryInterval=	5	Number of times to retry connection with the EIF probe before returning an error.
getport_total_timeout_usec=	50500	Number of seconds to continue attempting to connect to the EIF probe port before timing out. The default is 14 hours.
NO_UTF8_CONVERSION=	YES	Events are already in UTF8, no conversion is needed. Must be set to YES.
ConnectionMode=	co	The connection mode.
BufferEvents=	YES	Whether the EIF buffers the event. This must be set to YES.
BufEvtMaxSize=	4096	Maximum size of the event cache. The default is initially 4096 KB and you can change it here.
BufEvtPath=	./TECLIB/om_tec.cache	Path of the event cache file. The default is ./TECLIB/om_tec.cache.
FilterMode=	OUT	Enable event filtering. This is set to OUT by default.
Filter:	Class=ITM_Generic; master_reset_flag=’’;	To filter out specific classes, use this keyword. By default, situation events of the class ITM_Generic and those that send no master reset flag are not forwarded.