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-7608).

Table 1. Properties and command line options

Property name

Command line option

Description

AckSystemId string

-acksystemid string

Use this property to specify the processing system on which the IRP Manager runs. This is used by the acknowledge_alarm CLI function.

The default is "".

AckUserId string

-ackuserid string

Use this property to specify the name of the user acknowledging the alarm. This is used by the acknowledge_alarm CLI function.

The default is "".

Agentheartbeat integer

-agentheartbeat integer

Use this property to specify the frequency (in seconds) with which the probe checks the status of the IRP agent.

The default is 60.

AlarmFilter string

-alarmfilter string

Use this property to specify the filter the Alarm IRP uses to limit the alarms sent to the probe.

The default is "".

AlarmIrpName string

-alarmirpname string

Use this property to specify the name of the Alarm IRP Agent used by the Naming Service.

The default is 32.111-3 V6.2.

Note: The value of this property can differ between NetAct systems. For example, it might take the following format: NokiaNetact3gppv6AlarmIRP.

BeatInterval integer

-beatinterval integer

Use this property to specify the heartbeat interval for peer-to-peer failover.

The default is 2.

ClearSystemId string

-clearsystemid string

Use this property to specify the system identifier that the userid_clear_alarms CLI command clears.

The default is "".

ClearUserId string

-clearuserid string

Use this property to specify the user clearing the alarms using the userid_clear_alarms CLI command.

The default is "".

CommandPort integer

-commandport integer

Use this property to specify the port through which users can connect to the 3GPP interface using the Command Line Interface (CLI) supplied with the probe. For details about the CLI, see Command line interface.

The default is 6970.

CommandPortLimit integer

-commandportlimit integer

Use this property to specify the maximum number of Telnet connections that can be made to the probe.

The default is 10.

EntryPointIrpFile string

-entrypointirpfile string

Use this property to specify the location of the file that contains the IOR of the EntryPoint IRP object.

The default is "".

FlushBufferInterval integer

-flushbufferinterval integer

Use this property to specify how often (in seconds) the probe flushes all alerts in the buffer to the ObjectServer.

The default is 0 (which instructs the probe to never flush the alerts to the ObjectServer).

InstanceId string

-instanceid string

Use this property to specify a unique identifier for the instance of the probe. This property allows you to run multiple instances of the probe on the same machine.

The default is "".

Mode string

-mode string

Use this property to specify the role of an instance of the probe in a peer-to-peer failover relationship. This property takes the following values:

master: The instance is the master probe.

slave: The instance is the slave probe.

standard: There is no failover relationship.

The default is standard.

NamingServiceIOR Request string

-namingserviceiorrequest string

Use this property to specify the command that the probe uses to upload the CORBA Naming Service IOR.

The default is GET /cgi-bin /get_nbif_ior.

NamingServiceHost string

-namingservicehost string

Use this property to specify the host running the CORBA Naming Service.

The default is localhost.

NamingServicePort integer

-namingserviceport integer

Use this property to specify the port on which the CORBA Naming Service listens.

The default is 5001.

NetActServerName string

-netactservername string

Use this property to specify the name of the Nokia-Siemens NetAct server to which the probe connects to retrieve the Naming Context IOR file.

The default is "".

NetActServerPort integer

-netactserverport integer

Use this property to specify the port on the Nokia-Siemens NetAct server through which the probe connects to retrieve the Naming Context IOR file.

The default is 10115.

Notification Categories string

-notificationcategories string

Use this property to specify the notification categories that the probe subscribes to.

The default is "" (the probe subscribes to all categories).

Note: To specify multiple categories, separate them using semicolons, in the following format:

category1; category2; categoryn

For example, to subscribe to the alarms and heartbeat events, use the following value:

ALARM IRP V1.0.0; CS IRP V1.0.0

NotificationFilter string

-notificationfilter string

Use this property to specify the filter that the Notification IRP uses to limit the notifications sent to the probe.

The default is "".

NotificationIrpName string

-notificationirpname string

Use this property to specify the name of the Notification IRP Agent used by the Naming Service.

The default is 32.303 V6.1.

Note: The value of this property can differ between NetAct systems. For example, it might take the following format: NokiaNetact3gppv6NotificationIRP

ORBCharEncoding string

-orbcharencoding string

Use this property to specify the native character encoding set used by the Object Request Broker (ORB) for character data.

The default is UTF8.

This property can also take the value ISO8859_1.

ORBLocalHostName string

-orblocalhostname string

Use this property to specify the local host name used by the server-side ORB to place the server's host name into the IOR of a remote object.

The default is "".

ORBLocalPort integer

-orblocalport integer

Use this property to specify the local port to which the ORB listens.

The default is 0 (the ORB selects an available port at random).

ORBWCharDefault string

-orbwchardefault string

Use this property to specify what wide character (wchar) set the IBM ORB uses when communicating with other ORBs that do not publish a wchar set.

The default is UTF16.

This property can also take the value UCS2.

PeerHost string

-peerhost string

Use this property to specify the host to which the probe fails over in a peer-to-peer failover configuration.

The default is localhost.

PeerPort integer

-peerport integer

Use this property to specify the port through which the master and slave probes communicate in a peer-to-peer failover configuration.

The default is 9999.

Resynch string

-resynch (This is equivalent to Resynch with a value of true.)

-noresynch (This is equivalent to Resynch with a value of false.)

Use this property to specify whether the probe requests all active alarms from the Nokia-Siemens NetAct system before connecting to the notification service for new alarms. This property takes the following values:

false: The probe does not perform resynchronization.

true: The probe performs resynchronization at startup.

The default is false.

Retry string

-retry string

Use this property to specify whether the probe attempts to reconnect to the Nokia-Siemens NetAct system following a timeout. This property takes the following values:

false: The probe does not attempt to reconnect to the system

true: The probe attempts to reconnect to the system

The default is false.

TimeTick integer

-timetick integer

Use this property to specify the lifetime (in minutes) of the Notification IRP session on the 3GPP server.

The default is 0 (there is no time limit for the session).

Timeout integer

-timeout integer

Use this property to specify the time period (in seconds) that the probe waits for the next alarm before disconnecting.

The default is 0 (which instructs the probe to never disconnect).