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, (SC14-7530).

Table 1. Properties and command line options

Property name

Command line option

Description

DateStreamCapture integer

-datestream capture integer

Use this property to specify whether the probe appends a date and time to the stream capture filename. This property takes the following values:

0: Probe does not append the date and time to the stream capture filename

1: 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.

FlushTime integer

-flushtime integer

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

The default is 5.

Note:
If this property is set to 0, the probe only sends events to the ObjectServer on receipt of an event terminator.

Host string

-host string

Use this property to specify the DNS of the BSM device host.

The default is localhost.

Note: You must change the default value to a fixed IP address or host name. For example, a typical IPv6 address would look as follows: '2001:15f8:106:192:214:5eff:fef5: 856'.

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 (the probe does not disconnect if the port becomes inactive).

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 interface through the socket.

The default is 0 (which disables this feature).

InvalidAlarmLogFile string

-invalidalarm logfile string

Use this property to specify the file to which the probe logs invalid alarms. The current date and time is appended to this filename.

The default is $OMNIHOME/var/samsung.invalid.

InvalidAlarmLogging integer

-invalidalarm logging integer

Use this property to specify whether the probe logs invalid alarms. This property takes the following values:

0: Probe does not log invalid alarms

1: Probe logs invalid alarms

The default is 0.

MaxInvalidAlarmLogFileSize integer

-maxinvalidalarm logfilesize integer

Use this property to specify the maximum size (in bytes) for the invalid alarm file. When this limit is reached, the probe creates a new file with a new date and time.

The default is 1048576.

MaxStreamCapFileSize integer

-maxstreamcap filesize 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 (infinite).

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.

ReconnectionAttempts integer

-reconnection attempts integer

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

The default is 0 (the probe makes unlimited attempts to reconnect to the socket).

ReconnectionInterval integer

-reconnection interval integer

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

The default is 0 (the probe uses standard backoff strategy).

StreamCaptureFile string

-streamcapture file string

Use this property to specify the file that the probe uses to store the input data stream.

The default is "".