IBM Tivoli Netcool/OMNIbus Version 8.1

Windows command-line options for the transient event list

When you run the NCOelct.exe command to start the transient event list on Windows, you must specify a number of command-line options to customize the event list. You can run this command from the %NCHOME%\omnibus\desktop directory.

The following table describes the command-line options for starting the transient event list on Windows.

Table 1. Windows transient event list (NCOelct.exe) command-line options
Command-line option Description
-diagnostic Displays extended diagnostic messages.
-dualwrite 0 | 1 Indicates whether to enable or disable dual-write mode when operating in a desktop ObjectServer architecture. Valid options are as follows:
  • 0: Disable dual-write mode
  • 1: Enable dual-write mode

The -dualwrite command-line option overrides the DualWrite field entry in the master.national table of the desktop ObjectServer.

-elf string | URL

This is a required option.

Specifies the filter file to use for the transient event list, where:

string specifies a path to a .elf file.

URL specifies a .elf file on a remote server that is accessible by using HTTP or FTP. Specify the URL by using one of the following formats:

  • http://servername[:port]/path/filename.elf
  • http://username:password@servername[:port]/path/filename.elf
  • ftp://servername[:port]/path/filename.elf
  • ftp://username:password@servername[:port]/path/filename.elf

The optional port number :port needs to be specified only if the server is not using the default port.

If using FTP, the path must be the full path from the root directory; for example, /home/user/mydir/myfilter.elf.

You can use the -params command-line option to specify filter parameters in addition to those specified in the .elf file. For usage details, see the -params description, in this table.

-elv string | URL Specifies the event list view file to use for the transient event list, where:

string specifies a path to a .elv file.

URL specifies a .elv file on a remote server that is accessible by using HTTP or FTP. Specify the URL by using one of the following formats:

  • http://servername[:port]/path/filename.elv
  • http://username:password@servername[:port]/path/filename.elv
  • ftp://servername[:port]/path/filename.elv
  • ftp://username:password@servername[:port]/path/filename.elv

The optional port number :port needs to be specified only if the server is not using the default port.

If using FTP, the path must be the full path from the root directory; for example, /home/user/mydir/myview.elv.

-help Displays help for this command and exits.
-masterserver string Indicates the master ObjectServer to use in a desktop ObjectServer architecture.

The -masterserver command-line option overrides the MasterServer field entry in the master.national table of the desktop ObjectServer.

-networktimeout integer Specifies a time in seconds after which a login attempt or connection to the ObjectServer will time out, if a network failure occurs. After the specified timeout period, the event list attempts to reconnect to the ObjectServer. If the connection is unsuccessful after a second timeout period, the event list will attempt to connect to a backup ObjectServer, where available. The default is 20 seconds.
-params string Specifies a string to use to replace a single placeholder in the filter_text parameter of the filter file. This placeholder must begin with the @ symbol (for example, @FilterText).
-password string Specifies the password for the selected user name. The NCOelct utility accepts only alphanumeric characters in the password. Special characters such as #, /, >, @, and ! are not permitted in the password.
-server string Specifies the name of the ObjectServer to which you are connecting.
-username string Specifies the user name to use to log in to the event list.
-version Displays version information and exits.


Library | Support |