Siebel Analytics Installation and Configuration Guide > NQSConfig.INI File Reference > Siebel Analytics Configuration File Parameters and Syntax >

Parameters in the Configuration File Usage Tracking Section

The usage tracking parameters define default values for collection of usage tracking statistics on each logical query submitted to the Siebel Analytics Server. For more information about usage tracking, see the chapter on administering the query environment in Siebel Analytics Server Administration Guide.

ENABLE

Enables or disables collection of usage tracking statistics. Valid values are YES and NO. The default value is NO. When set to NO, statistics are not accumulated. When set to YES, statistics are accumulated for each logical query. The collection of usage tracking statistics is, by default, disabled.

Example: ENABLE = NO ;

STORAGE_DIRECTORY

Specifies the full path to the directory used to store usage tracking log files. The directory listed needs to be a valid fully-qualified, writable directory pathname, with double quotes ( " ) surrounding the pathname. Specify mapped directories only. UNC path names and network mapped drives are allowed only if the service runs under a qualified user account. To change the account under which the service is running, see Changing the Account Under Which a Windows Service Runs. Valid values are any fully qualified pathname to an existing, writable directory.

The parameter STORAGE_DIRECTORY is valid only if the parameter DIRECT_INSERT is set to NO. If usage tracking is enabled, but no storage directory is specified, the files are written to the Log subdirectory in the Siebel Analytics software installation directory.

Example: STORAGE_DIRECTORY = "C:\Temp\UsageTracking" ;

CHECKPOINT_INTERVAL_MINUTES

Specifies how often the usage tracking data is flushed to disk. Setting this interval higher increases the amount of data that may be lost in the event of an abnormal server shutdown. Setting this interval lower incurs additional overhead. The default is 5 minutes.

NOTE:  When the interval is set to 0, the Siebel Analytics Server attempts to write usage tracking data to disk with minimal time between attempts. This can negatively affect server performance, and is strongly discouraged.

Example: CHECKPOINT_INTERVAL_MINUTES = 5 ;

FILE_ROLLOVER_INTERVAL_MINUTES

Specifies the time, in minutes, before the current usage tracking log file is closed and a new file created. For example, if this entry is set to 60 minutes, then 24 usage tracking log files are created each day. The default is 240 minutes (4 hours).

NOTE:  The recommended setting for this parameter is 30.

If the checkpoint interval equals or exceeds the rollover interval, only the rollover occurs explicitly; the checkpoint only occurs implicitly when the old usage tracking log file is closed.

NOTE:  When the checkpoint interval is set to 0, the Siebel Analytics Server attempts to close current usage tracking log files and open new log files with minimal time between attempts. This can negatively affect server performance and result in a large number of usage tracking log files in the storage directory. Setting this interval to 0 is strongly discouraged.

Example: FILE_ROLLOVER_INTERVAL_MINUTES = 30;

CODE_PAGE

For multilingual repositories, this specifies the type of output code page to use when writing statistics to disk. Valid values include any valid code page number (such as 1252), and other globally recognized output code page types. The default value is ANSI. USC-2 is currently not supported. The type depends upon the database loader being used. For example, to support multilingual repositories for database loaders used by Oracle and DB2, specify UTF8. Enclose the value in double quotes.

Example: CODE_PAGE = "ANSI";


 Siebel Analytics Installation and Configuration Guide
 Published: 09 September 2004