You are viewing an old version of this page. View the current version.
Compare with Current ·
View Page History
The table below describe the main configuration settings of the software available in the main.cfg file, which is accessible from the main installation folder.
 | If you need to modify any of these settings, we strongly recommend to contact our Technical Support team. |
REGISTRATION
| Configuration option | Description | Default value |
| RegName | The name of the person or organisation the software is licensed to | e.g. Tri-Line |
| RegNum | The license number | e.g. 419-258-252-800 |
Features | A number associated with your registration code enabling certain system functions |
|
Expiry | The software expiry date in dd/mm/yyyy format. | 0 = never expires |
BRANDING
| Configuration option | Description | Default value |
|---|---|---|
| VendorAppTitle | The text that appears on the left hand side of the TIM title | TIM Professional |
| VendorScreenTitle | The text that appears on the left hand side of the TIM title bar, before the ‘Registered to’ text | TIM Professional |
| WebRealmTitle | Sets the realm name for anyone accessing the system via its web interface. Only effective when an HTTP authentication pair (username and password) is set. | TIM Professional Web Extensions |
| TechInfo0 | 1st line of text in the Technical support box in Help/About | TIM Professional Web Extensions |
| TechInfo1 | 2nd line of text in the Technical support box in Help/About | or visit our website at |
| TechInfo2 | 3rd line of text in the Technical support box in Help/About | http://www.tri-line.com/ |
| TechInfo3 | 4th line of text in the Technical support box in Help/About | Always quote your customer number |
HTTP EXTENSIONS
| Configuration option | Description | Default value |
|---|---|---|
WebEnabled | Determines whether users on the network are able to access system functions via a web browser. | True |
MultiUser | If set to False, the system does not ask for passwords during web and report access. If set to True, the system uses the information contained in the ACCESS.CFG configuration file. | False |
WWWKeepTempReports | Sets whether or not the system discards immediately any temporary files that are created to produce reports, etc | True |
WWWServerIP | Integrated web server IP address. Used when generating reports and TIM web interface. This is used for creating cyclical links (in emails and live reports) back to the internal web server. | 127.0.0.1 |
WWWServerPort | Integrated web server port number. If default port is used, this does not need to be specified when entering web server IP. | 80 |
WWWBind | Setting this option to true causes the above IP address and port to become bound and is typically used with a computer that has 2 or more active network cards (multiple IP addresses) | False |
IP Connectivity
| Configuration option | Description | Default value |
|---|---|---|
IPPBXEnabled | If True, enables IP-PBX Connection Parameters | False |
IPPBXIP | PBX IP address used by IP-PBX Connection Parameters | 192.168.0.1 |
IPPBXPort | IPPBX port number used by IP-PBX Connection Parameters | 4001 |
IPPBXUsername | IPPBX user name for logging onto PBX |
|
IPPBXPassword | IPPBX password used for logging onto PBX |
|
IPScript | IPPBX script used for logging onto PBX | maximiser.ips |
TCPIPScout | IF True, enables Telnet server and allows the system to responds to data packets sent over the TCP/IP network. | False |
TCPDataPort | Telnet server port number that that is used by the telnet server and is Only effective when TCPIPScout option is set to True. | 23 |
TCPServerIP | Sets the IP address or host name of the TCP/IP remote PBX data socket. | 127.0.0.1 |
TCPBind | Determines whether the TCP/IP remote PBX data socket is bound to the IP address/name and port as specified in the TCPServerIP and TCPDataPort settings. In some installations, where a computer has multiple IP addresses, it may be desirable to bind the socket to a specific one. | False |
Display Options
| Configuration option | Description | Default value |
|---|---|---|
LCVGridLines | If True, enables grid lines in call view | False |
BarColour | Change colour of bar graph generator. | 000080 |
BarBackColour | Change colour of bar graph generator. | ffffff |
HighlightColour | Specifies the colour to be used when highlighting qualifying calls. | ffb0b0 |
Options
| Configuration option | Description | Default value |
|---|---|---|
MultiTask | Determines whether a user can access other system functions whilst data is being processed, or whether they must wait until it has finished. | True |
CurrencySymbol | Sets the currency symbol used throughout the system, including web reports. | £ |
PBXTemplate | The default PBX Template being used by TIM in Setup/PBX tab | internal.tdt |
DefaultTariffTable | The default tariff table used by TIM when routing doesn't specify that another be used. | BT |
MinimumDialledDigits | Minimum dialled digits defined in Setup/PBX tab | 3 |
DCSearchDigits | Dial code search complexity in Setup/PBX tab Specifies the number of digits (starting from the leftmost) from which to start matching any dialled number in all tariff tables. For example, 01614199999 would start searching with 016141 using the default settings. | 10 |
DiscardedPath | If set to False, TIM stops spooling call data and puts a start button on the bottom left of the main window. File scout can be stopped by moving the mouse over the status text whilst pressing SHIFT on the keyboard. When successfully stopped, the Start button will appear at the bottom left of the main screen. This feature will only be invoked if the system is not currently busy (egg. processing calls). FileScout can also be deactivated by holding down the shift key whilst starting tim and the user is presented with the controlled Startup dialog with the following two options:
| True |
FileScout | Sets whether the system responds to data packets received via the local PC's serial port. | False |
SerialScout | Turns on TIM’s ability to receive call data via Windows Handle Messaging, which allows applications to send data to each other without needing to employ networking or shared disk writing/reading. NetPBX is the only other application allowed to send data to TIM in this way. | False |
DirectWMScout | Show extension names in call view instead of extension number and can be set from the Setup/PBX tab. | True |
ShowExtensionNamesInLiveView | Sets whether or not the system saves newly-discovered items (extension and trunk numbers) into the ‘New Extensions’ or ‘New Trunks’ folders. If set to False, the system prompts the user whether they would like to do this when entering the Extension or Trunk set-up screens. | True |
SaveUnknownItems | Stores any significant system changes. If this is missing, it defaults to confighistory.log
| history.log |
LogChanges | Sets the path to the file that will store overflowed data received via the other methods of data delivery. This would not normally be used but is provided in case of emergency. | \timoverflow.pbx |
OverflowFile | Sets the length of time in seconds that the system will wait when trying to process any data arriving in its \spool sub-folder. Some applications providing the data may not release the file handle very quickly causing a sharing violation. | 10 |
OverflowTimeout | Enables or disables the built-in live statistics as used in call centre applications and which are accessible via the web interface in the form of SSI variables. Can also be set on the Setup/System tab. | True |
LiveStats | Sets whether or not the system always prompts the user to update their previous call records when a change has been made to the extensions or trunks configuration. | True |
AlwaysPromptUpdate | Sets whether or not the system always prompts the user to save newly-discovered items such as extensions and trunks, before making changes to their extensions or trunks configuration. | True |
AlwaysPromptNewItems | Sets the life of a temporary file. The units are days and may be expressed in fractions of days, egg. (1/24 = 0.041 is approximate to 1 hour). NOTE that setting this option to 0 instructs the software to remove temporary files immediately after use. | 14 |
TempFileExpiry | Enables highlighting of call records in call view that meet a specific criteria. | True |
ShowHighlights | When ShowHighlights = True, highlights any call record in call view that is greater than the specified duration in seconds. | 1800 |
HighlightDuration | When ShowHighlights = True, highlights any call record in call view that is greater than the specified cost | 5.00 |
HighlightCost | Specifies the (partial) dialled number of a call which, if matched, will cause it to be highlighted, assuming call highlighting is enabled. NOTE that leaving this option blank and not removing it will cause all non-outgoing calls to be highlighted, since their dialled digits will be blank, and indeed match. Allows multiple values to be comma-separated, based on a dialled number. | 09* |
HighlightNumber | Instructs the system to change the destination of custom dialled numbers as defined in the LOCATIONS.CFG file. This option enables the use of the Locations tab in Tools|Setup Currently does not work with CLI number. | True |
UseLocationTable | Allows the international dialling prefix to be customised, from the default. | 00 |
InternationalPrefix | If set to True, will force all reports to only display the associated name of an extension, and not its extension number. This was requested as a security feature so users could not easily determine a DDI number, in order to circumvent NGNs (non-geographic numbers). | True |
ShowOnlyExtnNames | When enabled, shows only Account Name instead of the Account Number when account number is specified. | False |
ShowOnlyAccNames | The ‘globally, use these criteria:’ option in Tools/system tab. Highlights any call record in call view that meets any one of the following criteria: HighlightDuration = HighlightCost = HighlightNumber = | True |
GlobalHighlights | Allows the user to amend both the extension number and/or trunk number as taken from the PBX's call records. By specifying a value for either of these CFOs, the amount specified will be added to the number as received from the PBX call record. For example if TrunkNumberModifier was set to 1000000 (1 million) then a trunk number originally given as, say, 12 from the PBX would become 1000012. These options can help when you need to move extension or trunk numbers out of a certain range. The modified trunk and extension values are stored in the database as though that is how they were received originally from the PBX, however the BACKUP.PBX or local backup files will still contain the original values, thus allowing the user to amend the whole range in the future. | 0 |
TrunkNumberModifier | See ‘TrunkNumberModifier’ for an explanation. NOTE not found in main.cfg by default. |
|
ExtnNumberModifier |
| 0 |
AEI |
| False |
SaveRawBackup |
|
|
RawBackupFile |
|
|
SWFL | Indicates whether or not the main screen shows socket diagnostic information at the top-left corner. It is set on/off by ticking 'Diagnostics' menu in the 'View' menu. | False |
ShowDiagnostics | When set to True, this option causes TIM to not delete a spool file and append new call records to the end of the file. NOTE this option is used by AvayaIPOffice and VoiSpeed setups. | True |
IncrementalSpool | When this option is present, TIM looks in the location specified for spool files, rather than the default location: \tim\spool. If SpoolFolder is set to blank, the default path becomes the standard path, rather than the root folder, as a security precaution. NOTE this option is used by some AvayaIPOffice setups and all VoiSpeed setups, when Delta server is running on a different computer to TIM. Typically a folder containing the SMDR file is shared as a drive letter visible to TIM eg Spoolfolder = T:\ |
\Program Files\Avaya\IP Office\SMDR\SMDR_Output\ |
SpoolFolder | When this option is present, TIM only processes the named file as a spool file. Wild cards can be used. ***************find out wild card options*********** | SMDR.CSV
|
SpoolFiles
| enable/disable the automatic prepending of a '0' (zero) to the CLI on incoming calls. The default is True; to disable, set to False. TDT Options must appear in the [Options] section of a TDT file. |
|
rependCLIZero | This option is used in conjunction with ‘IncrementalSpool = True’ and contains a copy of the last call record that tim processed in the spool file. This prevents TIM from re-processing the entire spool file each time TIM checks the spool folder for new call data.[No longer stored here. ***MOVED TO STATE.CFG***] | "" |
LastIncrementalCDR |
EMAIL SETTINGS
This document sets out the settings available to the user within the software's main configuration file MAIN.CFG. These settings are normally set to the optimum settings, but in certain installations may need tweaking. If you are in any doubt about these settings, do not alter them without proper guidance.
| Setting | Description | Default value |
|---|---|---|
| PBXTemplate | Sets the default PBX Template that the system uses when no other routing takes precedence. | |
| Features | A number associated with your registration code enabling certain system functions. | |
| VendorImagePath | For branding purposes only. Sets the path to the image that will be displayed in the top-left corner of the main screen. | |
| VendorAppTitle | For branding purposes only. Set the application's title as registered with the operating system. | |
| VendorScreenTitle | For branding purposes only. Sets the main screen's title. | |
| WebRealmTitle | Sets the realm name for anyone accessing the system via its web interface. Only effective when an HTTP authentication pair (username and password) is set. | |
| WebEnabled | Determines whether users on the network are able to access system functions via a web browser. | true or false |
| HTTPAuthPair | A Base64-encoded string containing the username and password needed to access the system's web functions. This is no longer used (it was superseded by the Users & Passwords function in R157). | |
| WWWKeepTempReports | Sets whether or not the system discards immediately any temporary files that are created to produce reports, etc. | true or false |
| WWWServerIP | Sets the IP address or hostname of the local PC. This is used for creating cyclical links (in emails and live reports) back to the internal web server. | |
| WWWServerPort | Sets the TCP Port that the internal web server uses. | 80 |
| WWWBind | Bind the WWW socket to the IP address and Port as specified in the WWWServerIP and WWWServerPort settings. This may be desirable in the case of a computer with multiple IP addresses. | false |
| MultiTask | Determines whether a user can access other system functions whilst data is being processed, or whether they must wait until it has finished. | true or false |
| CurrencySymbol | Sets the currency symbol used throughout the system, including web reports. | |
| DefaultTariffTable | Sets the default tariff table to use when routing doesn't command that another be used. | |
| MinimumDialledDigits | Sets the minimum number of dialled digits an outgoing call record must possess in order not to be discarded as invalid. | 3 |
| FileScout | Sets whether the file spooler is active or not. | true |
| TCPIPScout | Sets whether the system responds to data packets sent over the TCP/IP network, as an alternative to a file, as used in multiple site applications. | true or false |
| SerialScout | Sets whether the system responds to data packets received via the local PC's serial port. | false |
| DirectWMScout | This settings determines whether or not the system responds to Microsoft Windows low-level window notification as a method for sending data. | false |
| TCPServerIP | Sets the IP address or host name of the TCP/IP remote PBX data socket. | localhost |
| TCPDataPort | The TCP Port that the TCPIP data scout uses to receive data packets via. (Only effective when TCPIPScout is set to true). | 23 |
| TCPBind | Determines whether the TCP/IP remote PBX data socket is bound to the IP address/name and port as specified in the TCPServerIP and TCPDataPort settings. In some installations, where a computer has multiple IP addresses, it may be desirable to bind the socket to a specific one, and in this case TCPBind would be set to true. | false |
| ShowExtensionNamesInLiveView | Determines whether an extension's associated name is displayed in place of the basic number on the Call View screen. | |
| LiveStats | Enables or disables the built-in live statistics as used in call centre applications, and which are accessible via the web interface in the form of SSI variables. | true or false |
| StatsFor | Sets a particular extension group to monitor, for the Live Statistics function (if enabled). Partial entries are acceptable, eg. Admini* would keep statistics for all groups beginning Admini. The default (*) indicates that statistics should be collated for all extensions. | * |
| AlwaysPromptUpdate | Sets whether or not the system always prompts the user to update their previous call records when a change has been made to the extensions or trunks configuration. | true or false |
| AlwaysPromptNewItems | Sets whether or not the system always prompts the user to save newly-discovered items such as extensions and trunks, before making changes to their extensions or trunks configuration. | true or false |
| TempFileExpiry | Sets the life of a temporary file. The units are days and may be expressed in fractions of days, eg. (1/24 = 0.041 is approximate to 1 hour). Please note that setting this option to 0 instructs the software to remove temporary files immediately after use. | 0 |
| OverflowFile | Sets the path to the file that will store overflowed data received via the other methods of data delivery. This would not normally be used but is provided in case of emergency. | |
| OverflowTimeout | Sets the length of time in seconds that the system will wait when trying to process any data arriving in its \spool sub-folder. Some applications providing the data may not release the filehandle very quickly causing a sharing violation. | |
| EmailSRLinkOnly | Instructs the system to send only a link back to a pre-manufactured file holding the information for a report. It is sent in place of the actual report data where some e-mail systems cannot correctly handle embedded images and other data. | |
| SMTPHost | Sets the SMTP host name or IP address for sending mail via SMTP. | |
| SMTPPort | Sets the SMTP TCP Port that the SMTP mail server is listening on. | 25 |
| SMTPServerName | Sets the server name under which the system masquerades when negotiating a connection with the SMTP mail server. Some SMTP hosts will only communicate with designated named servers. | |
| SMTPMailFrom | Sets the return e-mail address to be used when sending e-mail items. | |
| MAPIProfile | Sets the profile name to be used when the system sends e-mail using MAPI transport, instead of SMTP. | |
| MAPIPassword | Sets the password for the MAPI profile being used, when sending e-mail using the MAPI transport method. | |
| BillTaxRate% | Sets the sales tax (without the % mark) that is applied to Billing Reports only. | |
| Report#Extra | A string to be prepended to the URL of a report before it is submitted to the report engine. It is used to override certain report settings or apply settings that are commonly used and the user does not want to repeatedly select. A setting is provided for each Report ID (1 - 8). | # = 1 to 8 |
| AutoRestartHour | Sets the hour of the day (0-23) that the system will automatically restart itself, giving time to purge temporary files and compact the calls database (if enabled). | |
| RestartDelay | Specifies the number of seconds to wait, following a request, before the system restarts. Increasing this setting allows more time for tasks such as closing the database. | 5 |
| OverrideMarkup | Used to override any mark-up that is selected when producing a Billing Report. Even if the user sets their own mark-up, this setting will take precedence. Specify as a %, but don't include the % symbol is NOT required. | |
| OverrideSurcharge | Used to override any surcharge that is selected when producing a Billing Report. Even if the user sets their own surcharge amount, this setting will take precedence. The currency symbol should NOT be included. | |
| TechInfo# | Sets the text in the Help|About box for branding purposes. For example, you could put your technical support contact number(s) here. | |
| SaveUnknownItems | Sets whether or not the system saves newly-discovered items (extension and trunk numbers) into the 'New Extensions' or 'New Trunks' folders.
If set to false, the system prompts the user whether they would like to do this when entering the Extension or Trunk set-up screens. |
false |
| ShowHighlights | Sets whether the call highlighting feature on the Call View screen is enabled or not. | true |
| HighlightColour | Specifies the colour to be used when highlighting qualifying calls. | ffc0c0 |
| UseLocationTable | Instructs the system to change the destination of custom dialled numbers as defined in the LOCATIONS.CFG file. | false |
| KeepLiveViewData | Determines whether or not the information displayed in the Call View screen persists between application sessions. If this is set to false, any restart of the system will clear the Call View screen. | true |
| AAEvery | Sets the number of days between each Automatic Archive, where calls over this period are automatically removed from the database and saved into the \backup folder under a unique name. Setting this to 0 disables the function. | 0 |
| IATTrigger | Specifies the time in minutes, after which, if no activity has been logged, an alarm is produced as part of the Inactivity Timer feature. | 60 |
| IATExcludeDays | Specify the days (in the abbreviated form of ddd) which do not qualify for the Inactivity Timer, separated by spaces. For example, an organisation whose telephone system may reasonably be inactive over weekends may specify 'Sat Sun' here in order to exclude Saturdays and Sundays. | |
| IATExcludeHours | Specify the hours (in the form hh), separated by spaces, during which the Inactivity Timer will not be activated if no data is logged. For example, an organisation whose telephone system is usually inactive outside the hours of 8am and 6pm might include '00 01 02 03 04 05 06 07 19 20 21 22 23' here in order to exclude these hours. | |
| IATAudible | Specifies that in the event of an alert (as part of the Inactivity Timer feature), in addition to notifying the system administration by e-mail or logging to a file, the PC's internal bell is also sounded every second. This could be used to ensure that an administrator who is nearby the PC is notified of the inactivity as soon as it occurs, rather than waiting for an e-mail, etc. | false |
| LogChanges | Specifies the filename to be used to store noteworthy information about system activity. This information is useful in determining the sequence of events that lead to an error, for example. The file containing this information is always stored within the \config folder and so should not include a path. | history.log |
| DCSearchDigits | Specifies the number of digits (starting from the leftmost) from which to start matching any dialled number in all tariff tables. For example, 01614199999 would start searching with '016141' using the default setting. | 6 |
| HighlightDuration | Specifies the duration of a call over which it will be highlighted, assuming call highlighting is enabled. | 1800 |
| HighlightCost | Specifies the cost of a call over which it will be highlighted, assuming call highlighting is enabled. | 5.00 |
| HighlightNumber | Specifies the (partial) dialled number of a call which, if matched, will cause it to be highlighted, assuming call highlighting is enabled. Please note that simply leaving this option blank (and not removing it), will cause all non-outgoing calls to be highlighted, since their dialled digits will be blank, and indeed match. | NONE |
| HighlightExtn | Specifies a particular (partial) extension number to highlight, if a call is made from or to that extension/those extensions. | nothing |
| HighlightExtnGroup | Specifies a particular (partial) extension group to highlight, if a call is made from or to an extension within that group/those groups. | nothing |
| PieColour# | Specifies the colour to paint each segment in any pie charts. The value should be specified in the HTML-HexRGB style (eg. ff00ff). In the case of the Call Geography report, the # specifies the slice of the pie chart corresponding to it's associated dialled number, eg. PieColour7 = ffffff would colour the slice corresponding to mobile numbers to white. This is because 7 is the prefix to mobile numbers, eg. (0)7771234567. | # is a number |