Using the ObjectServer properties and command-line options

The ObjectServer reads its properties file when it starts. If a property is not specified in this file, the default value is used unless a command-line option is used to override it.

About the ObjectServer properties file

The default location of the properties file is $NCHOME/omnibus/etc/servername.props. In the ObjectServer properties file, a property and its corresponding value are separated by a colon (:). String values are surrounded by single, straight quotation marks, for example:

Name: 'NCOMS'

Each ObjectServer property has a default value. In an unedited properties file, all properties are set to the default values. At the top of the file, a list of the properties with their default values, data types, and descriptions is provided, to act as a reference. These properties are commented out with a number sign (#) at the beginning of the line. Below the list of commented-out properties, another list of properties with their default values is provided for editing purposes, if required.

Note: If you are running the ObjectServer in UTF-8 encoding on Windows, you must also save the ObjectServer properties file in UTF-8 encoding.

Specifying ObjectServer properties

You can change the settings for ObjectServer properties in one of the following ways:

Edit the properties file and change the value of the required properties. Change the entries below the commented-out list of properties. When you make changes to the properties in the properties file, the changes do not take effect until you restart the ObjectServer.
Note:
Exceptions apply. For more information, see Props.LiveUpdate.
Run the ALTER SYSTEM SET command from the SQL interactive interface.
From the Netcool/OMNIbus Administrator interface, use the System menu button and the Properties option to display the properties and edit their values.
When you use the ALTER SYSTEM SET command or Netcool/OMNIbus Administrator to change the ObjectServer properties, changes to some of the properties do not take effect until you restart the ObjectServer. For information about viewing the properties that require an ObjectServer restart, see the list of Tips that follows.
When Props.LiveUpdate is turned on, updates made with the ALTER SYSTEM SET command take precedence over live updates to the property file.
Properties that are set with command line arguments can never be altered by live updates to the property file. For more information, see Props.LiveUpdate.

Whenever you change the ObjectServer property values by using the ALTER SYSTEM SET command or Netcool/OMNIbus Administrator, a list of properties is added at the bottom of the properties file to reflect your changes. As a result, multiple entries for a property can exist within a file. The last entry for a property takes precedence over any earlier entries.

Tips for viewing information about ObjectServer properties:

You can query the catalog.properties table to view information about ObjectServer properties. For example, to retrieve a list of properties that cannot be modified, enter the following query in the SQL interactive interface:
select PropName from catalog.properties where IsModifyable=FALSE;
Changes to some ObjectServer properties do not take effect until you restart the ObjectServer. To retrieve a list of these properties, enter the following query:
select PropName from catalog.properties where IsImmediate=FALSE;
You can also view information about the ObjectServer properties from the Netcool/OMNIbus Administrator interface.

Specifying ObjectServer command-line options

When running the ObjectServer by using the nco_objserv command, you can specify a set of command-line options. You can override both the default value and the properties file value by changing the property value from the command line.

The command-line options for the ObjectServer use the following format:

nco_objserv [ -option [ value ] ... ]

In this command, -option is the command-line option and value is the value to which you are setting the option. Not every option requires you to specify a value.

You can add command-line options to nco_objserv commands in the process agent configuration file.