Siebel Analytics Installation and Configuration Guide > NQSConfig.ini File Reference > Parameter and Syntax Descriptions >

Parameters in the 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.

To collect more detailed information about queries, set the parameters in the Server Query Statistics section. For more information, see Parameters in the Server Query Statistics Section.


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

Example: ENABLE = OFF ;


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 To change the account under which a Windows service runs. Valid values are any fully qualified pathname to an existing, writable directory.

NOTE:  Do not specify the same directory used to store server query statistics.

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


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.



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 will be created each day. The default is 240 minutes (4 hours).

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.



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, Version 7.5, Rev. C 
 Published: 18 April 2003