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

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 command.

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 command.

The default is "".

AlarmIRPIOR string

-alarmirpior string

Use this property to specify the alarm IRP object reference.

The default is "".

AlarmIRPIORFile string

-alarmirpiorfile string

Use this property to specify the path to the Alarm IRP object reference.

The default is "".

AlarmIrpName string

-alarmirp string

Use this property to specify the name of the Alarm IRP object to which the probe sends a resynchronization request.

The default is AlarmIRP=1.

ClearSystemId string

-clearsystemid string

Use this property to specify the system identifier of the alarms that the system_clear_alarms CLI command clears.

The default is "".

ClearUserId string

-clearuserid string

Use this property to specify the user identifier of the alarms that the userid_clear_alarms CLI command clears.

The default is "".

EnableSSL string

-noenablessl (This is equivalent to EnableSSL with a value of false.)

-enablessl (This is equivalent to EnableSSL with a value of true.)

Use this property to specify whether SSL connectivity between the probe and the 3GPP interface is enabled or disabled. This property takes the following values:

false: SSL connectivity between the probe and the 3GPP interface is disabled.

true: SSL connectivity between the probe and the 3GPP interface is enabled.

The default is false.

EntryPointIOR string

-entrypointior string

Use this property to specify the Entry Point object reference .

The default is "".

EntryPointIORFile string

-entrypointiorfile string

Use this property to specify the path to the Entry Point object reference file.

The default is "".

EntryPointIRPName string

-entrypointirpname string

Use this property to specify the name of the Entry Point IRP object.

The default is "".

IDLAttrMapFile string

-idlattrmapfile string

Use this property to specify the IDD attribute map that the probe uses when creating readable tokens for the probe log and rules file.

The default is $OMNIHOME/probe/includes/ generic_3gpp_v6_4_RuleElementMap.xml

You will need to change the value of this property to specify the full path to the file, for example:

opt/IBM/tivoli/netcool81/ omnibus/probe/includes/ generic_3gpp_v6_4_RuleElementMap.xml

KeyStore string

-keystore string

Use this property to specify the location of the keystore file that contains the client certificate for SSL and trusted authority certificate.

The default is "".

KeyStorePassword string

-keystorepassword string

Use this property to specify the password required to access the certificate specified by the Keystore property.

The default is "".

Note: You must encrypt this password using the nco_g_crypt utility with Netcool/OMNIbus.

NamingServiceHost string

-namingservicehost string

Use this property to specify the host on which the naming service is running.

The default is "".

NamingServiceIORfile string

-namingserviceiorfile string

Use this property to specify the Naming Service object reference file.

The default is "".

NamingServicePort integer

-namingserviceport integer

Use this property to specify the port on which the Naming Service is running.

The default is 0.

NotificationCategories string

-notification categories string

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

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

category1;category2;categoryn

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

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 "".

NotificationIRPIOR string

-notificationirpior string

Use this property to specify the Notification IRP object.

The default is "".

NotificationIRPIORFile string

-notificationirpior file string

Use this property to specify the path to the Notification IRP IOR file.

The default is "".

NotificationIRPName string

-notificationirpname string

Use this property to specify the name of the Notification IRP object to which the probe sends active alarm subscription requests.

The default is "".

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 ISO-8859-1.

ORBDebug string

-orbdebug string

Use this property to specify whether the probe writes ORB messages to a debug log file. This property takes the following values:

false: The probe does not write ORB messages to a debug file.

true: The probe writes ORB messages to a debug file.

The default is false.

ORBDebugFile string

-orbdebugfile string

Use this property to specify the location of the ORB debug file.

The default is $OMNIHOME/log/orb.debug.

ORBInitialHost string

-orbinitialhost string

Use this property to specify the host name of the Naming Service server.

The default is "".

ORBInitialPort integer

-orbinitialport integer

Use this property to specify the port number through which to connect to the Naming Service host.

The default is 1570.

ORBLocalHost string

-orblocalhost string

Use this property to specify the host name or IP address of the host where the application server or client application ORB is running.

The default is "".

ORBLocalPort integer

-orblocalport integer

Use this property to specify the port number for the ORB to listen on.

The default is 0.

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.

Release3GPP string

-release3gpp string

Use this property to specify the version of 3GPP that the host is running. The possible values are:

V3.2

V5.5.1

V6.3

V6.4

V7.0

V9.1

The default is V9.1.

SecurityProtocol string

-securityprotocol string

Use this property to specify the security protocol. This property takes the following values:

TLS

TLSv1

TLSv1.2

The default is TLSv1.

TimeTick integer

-timetick integer

Use this property to specify the time (in minutes) that device sessions are kept open.

The default is -1 (this instructs the probe to keep sessions open permanently).
Note: If the generic HeartBeatInterval property is set to 0, the Retry and RetryInterval properties will no affect. So if TimeTick is enabled, it should be used with the Inactivity property to shut down the probe following disconnection by the target system. If the HeartBeatInterval property is set to a value greater than 0, and if the heartbeat interval is shorter than the time tick interval, time tick will not be triggered to terminate connections because the expiry time of the connections will be constantly renewed on each heartbeat.