Configuration settings

Several configuration settings are available for the Reference session agent.

Display Name values are displayed in TMS, which is the recommended method for configuring session agents.

Name values are displayed in TealeafCaptureSocket.cfg.

This table lists and describes the configuration settings:

Table 1. Configuration Settings
Display Name	Name	Description
`Advanced User Agent Parsing`	`AdvancedUAParsing`	When set to `True`, the Reference session agent uses the self-pruning cache to speed up lookups of user agent information. This cache contains the most recently seen user agents. The default value is `True`.
`Allow Empty Extensions`	`AllowEmptyExtension`	When `True`, URLs that do not contain an extension are permitted to be normalized. The default value is `True`.
`Days to Keep Stats`	`StatsKeepDays`	The number of days to retain statistics on the Reference session agent in rolling log files. The default value is `30`.
`Log Reference Statistics`	`OutputReferenceStats`	When set to `True`, statistics on the Reference session agent operations are generated each hour for reporting through the Statistics Logger session agent. The default value is `True`.
`Maximum Cache Size`	`MaxCacheSize`	The maximum number of entries in the cache. The default value is `2000`. Note: If `Advanced User Agent Parsing` is enabled, this value must be specified.
`Normalize App Name`	`NormalizeAppName`	When set to `True`, the value of `TLT_APPLICATION_NAME` is set to the virtual directory defined as the value between the first two slashes of the URL. The default value is `True`.
`Normalize Host`	`NormalizeHost`	When set to `True`, extra data manipulation is performed to normalize host values before they are saved as reference IDs. The default value is `True`.
`Normalize Server`	`NormalizeServer`	When set to `True`, `TLT_SERVER` is set to the value of `LOCAL_ADDR`. The default value is `True`.
`Normalize URL`	`NormalizeURL`	Only URLs with the extension and status codes that are listed under `NormalizeURLExt` are considered. If the URL ends in a slash, the default root is appended, and the URL is decoded. If the URL contains one of the characters (/, :, ;, ?), the URL is truncated at that character. The default value is `True`.
`Pruning Interval`	`PruningInterval`	The interval in minutes when the user agent cache is updated with the most recently seen user agents. The default value is `10`. Note: If `Advanced User Agent Parsing` is enabled, this value must be specified.
`Reference Statistics Min Hits`	`OutputReferenceStatsMin`	Minimum number of hits during a statistic log interval to qualify the reference statistics for logging. The default value is `1`.
`Reference Update Interval`	`UpdateInterval`	Interval in seconds at which the references files are updated or read. The default value is `60`.
`Referrer Parsing`	`ReferrerParsing`	When set to `True`, referrer values are parsed and normalized. The default value is `True`.
`Statistics Reporting Interval`	`StatsReportingInterval`	The interval in minutes at which the session agent reports statistics. The following values are accepted: `5`, `10`, `15`, `30`, or `60`. Note: This interval is relative to the start of the hour. For example, a value of `30` generates statistics at 12:00, 12:30, and so on.
`Status Codes`	`NormalizeURLStatusCode`	The list of qualifying URL status codes that can be normalized. The default value is `0;200;302;304;400;402;403;404; 410;500;501;502;503;504;505`.
`URL Default Document`	`NormalizeURLRootDefault`	If the URL indicates that the resource is a directory, then this value is inserted as the default file name. The default value is `DEFAULTPAGE`.
`URL Extensions`	`NormalizeURLExt`	The semi-colon delimited list of URLs to be normalized. The default value is `ACTION;ASMX;ASP;ASPX;CSS;DO; HTM;HTML;GIF;ICO;JPG;JS;JSP;JHTML; PDF;PHP;SWF`.
`URL Reference Rules`	`URLReferenceRules`	Whether URL reference rules are enabled. The default value is `true`.
`URL Reference Rules File`	`URLReferenceRulesFile`	The path and file name of the URL reference rules. The default value is `.\system\Reference_Path_Rules.txt`. Relative paths are relative to the directory that contains the `DLL` in use.
`URL Reference Rules Mode`	`URLReferenceRulesMode`	The mode for URL reference rules. The default value is `cont`. `stop` - URL processing ends after the rule set or virtual directory fails to match. Processing always stops after a matched rule set or virtual directory. `cont` - URL processing continues even if a failure condition is met.
`Use Full Virtual Dir`	`UseFullVirtualDir`	If set to `True`, matches are made for the entire virtual directory string, even if it includes a slash (for example, `myapp\subdir`). If set to `False`, matches are determined by the `URLReferenceVirtualDir` setting in use. The default value is `False`.
`URL Virtual Dirs`	`URLReferenceVirtualDir`	A list of URL virtual directories, which are separated by commas and without spaces. The default value is `servlets`. Example: `servlets;cgi-bin` Other options are available.
`User Agent Files Directory`	`UAFilesDir`	This directory contains all required user agent parsing files: `BrowsCap.csv` for desktop user agent detection `WURFL.csv` for mobile user agents `UserCap.csv` for any user-defined user agent detection strings Note: If `Advanced User Agent Parsing` is enabled, this value must be specified. This value is a full path to the directory. Do not use a relative path. You can specify this path as a UNC path.

This table lists and describes more configuration items:

Table 2. More Configuration Items:
Display Name	Name	Description
`Log URL Statistics`	`OutputURLStats`	This debugging tool can be used to output URL statistics. The default value is `False`.
`Overload Application Reference Field`	`OverloadAppRef`	When set to `True`, the value of `TLT_APPLICATION_NAME` in the request buffer is overridden by the value for the type of browser that is extracted from the user agent cache.

Join the community

Academy

Session agent reference

Related articles

Join the community

Academy