Creating and editing ObjectServer files

An ObjectServer file provides a way to log or report information about ObjectServer events.

1. From the Netcool/OMNIbus Administrator window, select the System menu button.
2. Click Log Files. The Log Files pane opens.
3. To add a file, click Add Log File in the toolbar. The File Details window opens.
4. To edit the file details, select the file to edit and then click Edit Log File in the toolbar. The File Details window opens.
5. Complete this window as follows:

   Name

   Type a unique name for the ObjectServer file; for example, a name that provides some meaning about its usage. Note that this is not the file name as it will be created on the file system; to specify this, use the Full File Path field. If you are editing a file, you cannot change the name.

   Tip: When creating ObjectServer objects, their names must begin with an uppercase or lowercase letter, followed by uppercase or lowercase letters, numbers, or underscore (_) characters, up to 40 characters in length. User, group, and role names can be any text string up to 64 characters in length and can include spaces. Names of ObjectServer objects are case-sensitive.

   Full File Path

   Type the full path and file name of the physical file; for example, /opt/netcool/omnibus/log/status.log.

   Note: A number is automatically appended to the file name on the file system.

   Enabled

   Select this check box to activate the ObjectServer file. If not activated, the file will exist on the file system, but cannot be written to. You can specify the ObjectServer file information and then activate the file at a later time.

   Unlimited File Size

   Select this check box if you want information to be written to a single file with an unlimited size. If you choose this setting, the Max. Size and Max. Files fields are not displayed in the window.

   When this check box is clear, information can be written to a single file, or to a pool of files that will each be written to in turn when a specified maximum size is reached. If you choose this setting, you must specify associated values in the Max. Size and Max. Files fields.

   Truncate

   Click this button to clear any information that has been written to the physical file. This does not delete the file. In situations where there is more than one physical file in a set, only the file that is currently being written to on the file system is truncated.

   Note: This button is visible only when you are editing file details.

   Max. Size

   Specify the maximum ObjectServer file size and then select a unit of measurement. The minimum file size is 1 KB and the maximum file size is 4 GB.

   Note: The operating system may place further restrictions on the maximum size of a single file.

   Max. Files

   Specify the maximum number of ObjectServer files to create.

6. Save or cancel your changes as follows:

   OK

   Click this button to save the file details and close the window. New file details are added to the Log Files pane.

   Cancel

   Click this button to close the window without saving your changes.