Use the sitconf.sh command on UNIX® systems and the sitconf.cmd command on Windows® systems to set or change the configuration of the event synchronization. You can use this command to initially create the configuration settings or to update existing settings.

After you change the configuration of the event synchronization, you must manually stop and restart the Situation Update Forwarder process. See the IBM Tivoli Monitoring Installation and Setup Guide for information.

where:

add

Create the configuration file. The default name is situpdate.conf.

update

Updates the existing specified configuration file.

refresh

Refreshes event synchronization to use the latest situation timeout configuration parameter in the sit_timeouts.conf file. To perform the refresh of event synchronization, the errorevent.conf file must also be configured. See the topic "Configuring error event flow to OMNIbus (optional)" in the IBM Tivoli Monitoring Installation and Setup Guide for more details on configuring the errorevent.conf file.

fileName = config_filename

The name of the configuration file for event synchronization. situpdate.conf is the default file name.

fileSize=size

Specify this option to set and change the maximum size, in bytes, for any one event cache file. The minimum (and default) value is 50000. Do not use commas when specifying this value (use 50000 instead of 50,000).

fileNumber=number

Specify this option to set and change the maximum number of event caches files permitted at any given time. The minimum value is 2, while the default value is 10. When this value is reached, the oldest file is deleted to make room for a new file.

fileLocation=path

Specify this option if you want to set and change the location on the event server where event cache files are located. The default locations are as follows:

• On Windows: Event_Sync_Install_Dir/persistence
• On UNIX: Event_Sync_Install_Dir\persistence

Where Event_Sync_Install_Dir is the directory chosen when event synchronization was installed.

pollingInterval=seconds

Specify this option to set and change the polling interval, in seconds. The minimum value is 1, while the default value is 3. This is the number of seconds that the Situation Update Forwarder process sleeps when there are no updates to process.

crcBytecount=count

Specify this option to set and change the number of bytes that the long running process will use when it saves the location of the last event it processes. This value must be an integer. The minimum (and default) is 50.

cmsSoapUrl=url

Specify this option to set and change the URL for the Service Oriented Architecture Protocol Server configured on the computer where the monitoring server is running. The default value is cms/soap. This value is used to create the URL to which Tivoli® Netcool/OMNIbus sends event information. For example, http://hostname:port///cms/soap, where hostname is the hostname of the monitoring server and port is the port.

bufferFlushRate=rate

Specify this option to set and change the maximum number of event updates sent to the monitoring server at one time. The minimum (and default) value is 100 events.

logLevel=level

Specify this option to set and change the level of information for event synchronization that is logged. You have the following choices:

• low (default)
• med
• verbose

pathc=

The location where the configuration file will be placed.

type=OMNIBUS

Required because this command is specific to Tivoli Netcool/OMNIbus.

The following example changes the trace level for the event synchronization to medium:

   sitconf.sh update fileName=situpdate.conf logLevel=med 

pathc=/opt/IBM/SitForwarder/etc type=OMNIBUS

Return to Table 10.