UNIX event list command-line options
When you use the nco_event command to start the event list on UNIX, you can specify a number of command-line options to modify the configuration. You can run this command from the $NCHOME/omnibus/bin directory.
The following table describes the command-line options for starting the UNIX event list.
Command-line option | Description |
---|---|
-char_expansion_factor integer | Instructs the client to allocate more bytes per character when the client receives data from the ObjectServer. Valid values are from 1 to 6. |
-cmap | Specifies a private color map. You cannot abbreviate this command-line option. |
-config string | URL or -elc string | URL |
Specifies the initial configuration file to use, where: string specifies a path to a .elc file. URL specifies a .elc file that is located on a remote server, which is accessible by using HTTP or FTP. Specify the URL by using one of the following formats:
The optional port number :port needs to be specified only if the server is not using the default port. You can optionally specify an IPv4 or IPv6 address for the servername value. When specifying an IPv6 address, enclose the address within brackets []; for example: http://[2003:13f8:206:190:204:baef:fe6a:6af0]:2880/mydir/myfile.elc |
-diagnostic | Displays extended diagnostic messages. This option is only useful for detecting problems with the event list. Do not use this command-line option unless you are advised by IBM Software Support. |
-dualwrite 0 | 1 | Indicates whether to enable or disable dual-write mode when
operating in a desktop ObjectServer architecture. Valid options are
as follows:
The -dualwrite command-line option overrides the DualWrite field entry in the master.national table of the desktop ObjectServer. |
-failbackpolltime integer | If connected to a backup
ObjectServer because failover occurred, the event list periodically attempts to reconnect to the
primary ObjectServer. This command-line option specifies the frequency, in seconds, at which the
event list polls for the return of the primary ObjectServer. If it is detected that the primary
ObjectServer has restarted, the event list disconnects from the backup ObjectServer and reconnects
to the primary ObjectServer. The default is 30 seconds. When set to
0, no polling occurs. When an event list connects to an ObjectServer, the event list checks the BackupObjectServer property setting of the ObjectServer to which it is connecting. Polling occurs only if this property is set to TRUE, indicating a backup ObjectServer. |
-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. |
-nlw | Instructs the client to suppress license expiry warnings. |
-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. |
-password string | Specifies the password to use to log in to the event list. |
-server string | Specifies the name of the ObjectServer to which you are connecting. |
-uneditable | Does not allow the event list configuration to be edited. When this option is used, the Filter Builder and View Builder buttons and the Save and Save As menu items are disabled. |
-username string | Specifies the user name to use to log in to the event list. |
-version | Displays version information and exits. |