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 more information about generic Netcool/OMNIbus properties and command line options, see the IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide.

Table 1. Properties and command line options

Property name

Command line option

Description

DecodeArrays integer

-decodearrays integer

Use this property to specify whether the probe interprets arrays. This property takes the following values:

0: The probe does not interpret arrays.

2: The probe interprets arrays.

The default is 0.

DecodeSecondTables integer

-decodesecondtables integer

Use this property to specify whether the probe interprets the second table that appears in the event. This property takes the following values:

0: The probe does not interpret the second table.

1: The probe interprets the second table.

The default is 0.

DecodeTables integer

-decodetables integer

Use this property to specify whether the probe interprets the first table that appear in the event. This property takes the following values:

0: The probe does not interpret the first table.

1: The probe interprets the first table.

The default is 0.

EventReadString string

-eventreadstring string

Use this property to specify the string that the probe sends to the Nokia-Siemens EWSD system to indicate that it has received an event. This string can act as an acknowledgment that prompts the system to send the next alarm.

The default is "".

MaxEvents integer

-maxevents integer

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

The default is 10.

Note: When a large number of events are being generated, you can increase this number to increase the event throughput.

NoNameResolution integer

-nonameresolution integer

Use this property to specify whether the probe performs name resolution on IP addresses. This property takes the following values:

0: The probe performs name resolution.

1: The probe does not perform name resolution.

The default is 0.

PortNumber integer

-portnumber integer

Use this property to specify the active TCP/IP port on which the probe listens for connections from the Nokia-Siemens EWSD system.

The default is 4567.

ReadTimeout integer

-readtimeout integer

Use this property to specify the period of time that the probe waits for a new alarm before timing out.

The default is 1.

Note: For this property, the probe treats values from 1 to 10 as seconds and values above 10 as milliseconds. For example, if you specify a value of 11, the probe treats this as 0.011 seconds (11/1000).

ReportStatus integer

-reportstatus integer

Use this property to specify whether the probe sends a ProbeWatch message to the ObjectServer when clients connect to, or disconnect from, the socket. This property takes the following values:

0: The probe does not send a ProbeWatch message.

1: The probe sends a ProbeWatch message.

The default is 1.

SocketBuffer integer

-socketbuffer integer

Use this property to specify the maximum buffer size for each socket.

The default is 1024.

Note: If the probe needs to read a large number of events quickly, you can increase this value.

SplitPairs integer

-splitpairs integer

Use this property to specify whether the probe splits name-value pairs that are separated by an equals (=) sign. This property takes the following values:

0: The probe does not split name-value pairs.

1: The probe splits name-value pairs.

The default is 0.

StreamCapture integer

-streamcapture integer

Use this property to specify whether stream capture is enabled. This property takes the following values:

0: Stream capture is not enabled.

1: Stream capture is enabled.

The default is 0.

StreamCaptureFilename string

-streamcapturefilename string

Use this property to specify the name and location of the stream capture file.

The default is $OMNIHOME/var/siemens_ewsd_server.stream.