Skip to end of metadata
Go to start of metadata
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 optionDescriptionDefault value
RegNameThe name of the person or organisation the software is licensed toe.g. Tri-Line
RegNumThe license number

e.g. 419-258-252-800

Features

A number associated with your registration code enabling certain system functions

  • 255:full
  • 511: enable voice recording
  • 0: demo mode

Expiry

The software expiry date in dd/mm/yyyy format.

0 = never expires

 

BRANDING

Configuration optionDescriptionDefault value
VendorAppTitleThe text that appears on the left hand side of the TIM titleTIM Professional
VendorScreenTitle
The text that appears on the left hand side of the TIM title bar, before the ‘Registered to’ textTIM Professional
WebRealmTitleSets 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
TechInfo01st line of text in the Technical support box in Help/AboutTIM Professional Web Extensions
TechInfo12nd line of text in the Technical support box in Help/Aboutor visit our website at
TechInfo23rd line of text in the Technical support box in Help/Abouthttp://www.tri-line.com/
TechInfo34th line of text in the Technical support box in Help/AboutAlways quote your customer number

 

HTTP EXTENSIONS

Configuration optionDescriptionDefault 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 optionDescriptionDefault 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 optionDescriptionDefault 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 optionDescriptionDefault 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:

  • Select another template file

  • Do nothing extra

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

LogChanges Specifies the file (always in
the config folder) where any
significant system changes
are stored with the date and
time that they happened.

Significant system changes include:

Tariff band and dialcode changes, additions, and
deletions.
Extension and trunk configuration changes, including
additions, renames and deletions.
Database clearouts.
Database extension name and trunk name updates.
Temporary file deletions (manual requests only).
Configuration file opens and saves.

 

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
Labels: