Properties and command line options

You use properties to specify how the probe interacts with the device. You can override the default values by using the properties file or the command line options.

The following table describes the properties and command line options specific to this probe. For information about default properties and command line options, see the IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide, (SC23-6373).

Table 1. Properties and command line options

Property name

Command line option

Description

ChatinString string

-chatinstring string

Use this property to specify the chat in script for connection to the host system.

The default is "".

ChatoutString string

-chatoutstring string

Use this property to specify the chat out script for disconnection from the host system.

The default is "".

DateStreamCapture integer

-datestreamcapture integer

Use this property to specifiy whether the probe appends a date and time to the stream capture filename:

0 - The description of the value is that the probe does not append the date and time to the stream capture filename

1 - The description of the value is that the probe appends the date and time to the stream capture filename

The default is 0.

Note:
Setting the DateStreamCapture property to 1 prevents the stream capture file from being overwritten.

ExpectTimeout integer

-expecttimeout integer

Use this property to specify the time (in seconds) the probe allows for a response to the expect part of the chat in/out script.

The default is 20.

FlushTime integer

-flushtime integer

Use this property to specify the time (in seconds) the probe waits before flushing the event to the ObjectServer.

The default is 5.

Host string

-host string

Use this property to specify the name of the host to which the probe connects.

The default is localhost.

HostsFile string

-hostsfile string

Use this property to specify the file that the probe uses to connect to multiple hosts.

The default is "".

Inactivity integer

-inactivity integer

Use this property to specify the time (in seconds) the probe allows a port to be inactive before disconnecting.

The default is 0.

InactivityRetry integer

-inactivityretry integer

Use this property to specify the number of consecutive periods of inactivity the probe allows before attempting to reconnect to the host.

The default is 0 (which disables this feature).

MaxEvents integer

-maxevents integer

Use this property to specify the maximum number of events the probe attempts to read simultaneously from a given source.

The default is 1.

Note:
You can increase this number to increase the event throughput when a large number of events are generated.

MaxStreamCapFileSize integer

-maxstreamcapfilesize integer

Use this property to specify the maximum size (in bytes) of the stream capture file. When this limit is reached, the probe creates a new file.

The default is 0.

Note:
If the probe reads a stream whose size exceeds the remaining allowable space in the file, it creates a new one, thus storing the whole stream in a single file.

Port integer

-port integer

Use this property to specify the port to which the probe connects.

The default is 23.

ReadTimeout integer

-readtimeout integer

Use this property to specify the number of milliseconds that the probe allows the socket to be silent. If this time is exceeded, it assumes that the connection is dead and disconnects.

The default is 100.

ReconnectionAttempts integer

-reconnectionattempts integer

Use this property to specify the maximum number of times that the probe attempts to reconnect to the socket.

The default is 0.

ReconnectionInterval integer

-reconnectioninterval integer

Use this property to specify the time (in seconds) between successive reconnection attempts.

The default is 0.

StreamCaptureFile string

-streamcapturefile string

Use this property to specify the file the probes uses to store the input stream log. Omitting this property disables the stream capture feature.

The default is "".