[MonFax]

The MonFax section is exclusively for the use of the new MonFax component which has been added to Version 2.11.3 and 2.10.19.

MonFax is an additional set of functionally added to MonTel (which needs to be licensed separately) so that Fax sending information can be recovered or guestimated from the call records of the PABX from supported PABXs for stand alone Fax Machines, or supported third party software.

In the case of PABXs and stand alone fax machines the PABX (and the fax machine) needs to be able to support a user based pin number to gain access to an outside line.

For third party computer based central software, the Fax Software needs to be able to append the users pin number (with a hash ('#') delimitator) to the out going number dialled.

FaxServerMachineName

Used by: FaxMonSv

Value range: up to 33 characters

2.11.4 onwards: Used by FaxMonSv

Example:

FaxServerMachineName= NETWIZ2

This is the name of the computer on which the Windows 2003 Fax Service is running. It is also the location where MonTel Win2003 Fax Service Monitoring service (FaxMonSv) must be installed to successfully collect fax queue information.

FaxServerLoginName

Used by: FaxMonSv

Value range: 0 or 1

2.11.4 onwards: Used by FaxMonSv

Example:

FaxServerLoginName= MONTEL

This is the name of the login account that is used by the MonTel Win2003 Fax Service Monitoring service (FaxMonSv). The most sensible account to use would be the same one as the MonTel Server Service.

FaxServerPipeTextOut

Used by: FaxMonSV.

Version 2.11.7 onwards.

Example:

FaxServerPipeTextOut = 0

When FaxServerPipeTextOut = 1 the MonTel Server Console or Service will send the screen information by a "named pipe" to the relevant MonTel Service Manager program (MTAdmin) which will allow the MonTel supervisor to be able to monitor the service from their local PC. This is the over rides the general default setting DefaultPipeTextOut.

FaxServerPipeInstances

Used by: FaxMonSV.

Version 2.11.7 onwards.

Example:

FaxServerPipeInstances = 5

By default FaxServerPipeInstances is set to 5, which is the maximum value. This can be reduced to limit the number of external connections to a Server, or to reduce network traffic. If it is set to 0 then the Text out pipe is turned off.

A pipe instance is one channel between a MonTel service or console application and the Service manager, which is acting as a graphical user interface for the application. One channel or pipe is used for each open Service manager.

The text pipe is screen information sent by a "named pipe" to the relevant MonTel Service manager (MTAdmin). This is the over rides the general default setting DefaultPipeInstances.

FaxServiceRecoverWaitTimes

Used by: LogSvc (for FaxMonSV).

Version 2.11.7 onwards.

Example:

FaxServiceRecoverWaitTimes = 5,10,82

This settings is a comma delimited list of time in seconds that LogSvc.exe should pause before restarting a service. LogSvc.exe is passed the failure count by the service control system in Windows and chooses the pause in the list in order of the failure count, with the last time being repeated for subsequent failures.

To prevent LogSvc.exe from restarting the service, set the value to a negative number.

The default is the value in DefaultServiceRecoverWaitTimes. This setting over rides the general default setting DefaultServiceRecoverWaitTimes. By default DefaultServiceRecoverWaitTimes is set to 5, 82.

FaxServiceLogFilePathName

Used by: Server and FaxMonSv

Value range: Path and file name up to 255 characters

2.11.4 onwards: Used by the Server and FaxMonSv

Example:

FaxServiceLogFilePathName = //Server/Share/Path/File

This is the file to which the MonTel Win2003 Fax Service Monitoring service (FaxMonSv) exports information to be turned into call records by the MonTel server. For maximum concurrency this file should be located on the same computer as the MonTel Server.

The MonTel Server needs MonFaxUsingFaxService to be set to 1 before it will use the file to pick up call/fax record information.

Please note that as call records are based on queuing a fax record, and not on sending a fax, both the guessed duration, and the actually sending of a fax cannot be confirmed. See MonFaxConnectionTime and MonFaxPageSendingTime to be able to alter some of the default settings.

FaxServiceArchiveFrequency

Used by: FaxMonSv.

Version 2.11.09 onwards

Example:

FaxServiceArchiveFrequency = 0

If FaxServiceArchiveFrequency is greater than 0 then the MonTel FaxMonSv service will create an archive file from the existing output file specified in FaxServiceLogFilePathName. This archive file will have the same path and and name, except that the name will be appended by the current date and time. See FaxServiceArchiveRoundToWholePeriod to round this down to the next whole period.

If FaxServiceArchiveFrequency is set to zero or is not specified then the FaxMonSv data output file will continue to grow and no archive files will be created.

FaxServiceArchiveRoundToWholePeriod

Used by: FaxMonSv.

Version 2.11.09 onwards

Example:

FaxServiceArchiveRoundToWholePeriod = 0

If FaxServiceArchiveFrequency is greater than 0 and FaxServiceArchiveRoundToWholePeriod is set to 1, then create an archive file from the existing output file on the nearest rounded down to a whole period from the time specified by minutes in FaxServiceArchiveFrequency.

So if the period is 60 or larger it will be rounded down to the first minute in the hour. Likewise for 1440 it will be rounded down to the first hour in the next day.

If FaxServiceArchiveRoundToWholePeriod is set to zero or is not specified the update will occur every FaxServiceArchiveFrequency from the time the service Started.

MonFaxUsingFaxService

Used by: Server and FaxMonSv

Value range: 0 or 1

2.11.4 onwards: Used by the Server and FaxMonSv

Example:

MonFaxUsingFaxService = 1

This values needs to be set when using the MonTel Win2003 Fax Service Monitoring service (FaxMonSv) so that the Server knows to collect information for call records. The log file it uses is specified at FaxServiceLogFilePathName.

MonFaxConnectionTime

Used by: Client and Server

Value range: 0 or 9999

2.11.4 onwards: Used by MonTel32, Notify32 and the MonTel Server.

Example:

MonFaxConnectionTime = 8

This value is the estimated time to make a connection to an external fax machine or modem over a phone line before and pages are sent. When not set the default value is 8 seconds.

This value is used in conjunction with MonFaxPageSendingTime by the MonTel Server to estimate the sending duration of queued faxes on the fax server if it is collecting call/fax records from a Windows 2003 Fax Service.

This value is used in conjunction with MonFaxPageSendingTime by the MonTel Client to estimate the page count from the duration of a Fax/Call record, when the page count has not been supplied (for example a walk up fax machine).

MonFaxPageSendingTime

Used by: Client and Server

Value range: 0 to 9999

2.11.4 onwards: Used by MonTel32, Notify32 and the MonTel Server.

Example:

MonFaxPageSendingTime = 22

This value is the estimated time to send a page via a typical machine machine or modem in the office, less the connection time. When not set the default value is 22 seconds.

This value is used in conjunction with MonFaxConnectionTime by the MonTel Server to estimate the sending duration of queued faxes on the fax server if it is collecting call/fax records from a Windows 2003 Fax Service.

This value is used in conjunction with MonFaxConnectionTime by the MonTel Client to estimate the page count from the duration of a Fax/Call record, when the page count has not been supplied (for example a walk up fax machine).

MonFaxUseCostPerPage

Used by: Client

Value range: 0 or 1

2.11.3 onwards: Used by MonTel32 and Notify32

Example:

MonFaxUseCostPerPage = 1

When set to one this value will automatically modify the amount charged for the Fax by the values set in items MonFaxCostFirstandFollowerxxx below, based of the type of call, as shown in the following table.

MonFaxCostFirstandFollower Type	Call Type
IDD	IDD, SATELLITE
NATIONAL	NATIONAL
LOCAL	LOCAL, 1300
MOBILE	MOBILE, GMS
FREE	FREE
OTHER	UNDEFINED, UNKNOWN,NONE, PRS, INFOFAX, VAS, MAX2

Note that since MonTel/MonFax is (currently) recovering fax information from a telephone call record from the PABX, there is no page count information included. MonTel can only guess the page count, and does this (currently) by assuming 8 seconds of connection time, and 22 seconds per page. In the future a heuristic may be added so that motel can learn as if goes.

MonFaxManualPageCount

Used by: Client

Value range: 0 or 1

2.11.3 onwards: Used by MonTel32 and Notify32

Example:

MonFaxManualPageCount = 1

When set to one this value allows the user on a MonFax pop-up to modify or add in the number of pages sent. This will automatically modify the amount charged if MonFaxUseCostPerPage is also set to 1.

Note that since MonTel/MonFax is (currently) recovering fax information from a telephone call record from the PABX, there is no page count information included. MonTel can only guess the page count, and does this (currently) by assuming a default of 8 seconds of connection time, and 22 seconds per page. The connection time and seconds per page time can be specified by the values in MonFaxConnectionTime and MonFaxPageSendingTime.

MonFaxIncludeCostOfCall

Used by: Client

Value range: 0 or 1

2.11.3 onwards: Used by MonTel32 and Notify32

Example:

MonFaxIncludeCostOfCall = 1

When set to one this value will automatically modify the amount charged for the Fax by adding in the cost of the phone call, including any modification by the setting in MonFaxCallCostMultiplier.

MonFaxCallCostMultiplier

Used by: Client

Default value: 1.0

2.11.3 onwards: Used by MonTel32 and Notify32

Example:

MonFaxCallCostMultiplier = 1.0

When set to one this value will automatically modify the amount charged (if MonFaxIncludeCostOfCall is set to 1) for the Fax by multiplying this value by the cost of the call.

For example to add a 10% surcharge set MonFaxCallCostMultiplier = 1.1.

If this value is blank MonTel will assume it is set to 1.0.

MonFaxMarkupMultiplier

Used by: Client

Default value: 1.0

2.11.3 onwards: Used by MonTel32 and Notify32

Example:

MonFaxMarkupMultiplier = 1.0

When set to one this value will automatically modify the total amount charged for the Fax by multiplying this value by the amount calculated.

For example to add a 50% surcharge set MonFaxMarkupMultiplier = 1.5.

If this value is blank MonTel will assume it is set to 1.0.

MonFaxAddThisCostToFax

Used by: Client

Default value: 0.0

2.11.3 onwards: Used by MonTel32 and Notify32

Example:

MonFaxAddThisCostToFax = 0.0

The value specified in MonFaxAddThisCostToFax is added to the total amount charged for the Fax.

This allows for a base charge of say, $5.00 per fax, plus the charge of the telephone call.

If this value is blank MonTel will assume it is set to 0.0.

MonFaxCostFirstandFollowerIDD

Used by: Client

Value range: $xxx.nn, $xxx.nn

2.11.3 onwards: Used by MonTel32 and Notify32

Example:

MonFaxCostFirstandFollowerIDD = 1.00, 0.50

If MonFaxUseCostPerPage is set to one, then for international (IDD) calls (and SATELLITE) the values specified here will be used to calculate the cost of the fax based on the page count estimated or entered by the user.

There are two values separated by a comma. The first value is the cost of the first page, and the second value is for the cost of the second and remaining pages if any. To only change for the first page, set the second value to 0.00. Both values need to be set, so to make the first page the same cost as the remaining pages, make sure both values are the same.

MonFaxCostFirstandFollowerNATIONAL

Used by: Client

Value range: $xxx.nn, $xxx.nn

2.11.3 onwards: Used by MonTel32 and Notify32

Example:

MonFaxCostFirstandFollowerNATIONAL = 1.00, 0.50

If MonFaxUseCostPerPage is set to one, then for national (NATIONAL) or STD calls the values specified here will be used to calculate the cost of the fax based on the page count estimated or entered by the user.

MonFaxCostFirstandFollowerLOCAL

Used by: Client

Value range: $xxx.nn, $xxx.nn

2.11.3 onwards: Used by MonTel32 and Notify32

Example:

MonFaxCostFirstandFollowerLOCAL = 1.00, 0.50

If MonFaxUseCostPerPage is set to one, then for local (LOCAL) and 1300 calls the values specified here will be used to calculate the cost of the fax based on the page count estimated or entered by the user.

MonFaxCostFirstandFollowerMOBILE

Used by: Client

Value range: $xxx.nn, $xxx.nn

2.11.3 onwards: Used by MonTel32 and Notify32

Example:

MonFaxCostFirstandFollowerMOBILE = 1.00, 0.50

If MonFaxUseCostPerPage is set to one, then for mobile (MOBILE) (and GMS) calls the values specified here will be used to calculate the cost of the fax based on the page count estimated or entered by the user.

MonFaxCostFirstandFollowerFREE

Used by: Client

Value range: $xxx.nn, $xxx.nn

2.11.3 onwards: Used by MonTel32 and Notify32

Example:

MonFaxCostFirstandFollowerFREE = 1.00, 0.50

If MonFaxUseCostPerPage is set to one, then for free (FREE) or 1800 calls the values specified here will be used to calculate the cost of the fax based on the page count estimated or entered by the user.

MonFaxCostFirstandFollowerOTHER

Used by: Client

Value range: $xxx.nn, $xxx.nn

2.11.3 onwards: Used by MonTel32 and Notify32

Example:

MonFaxCostFirstandFollowerOTHER = 1.00, 0.50

If MonFaxUseCostPerPage is set to one, then for call not included in other call types (that is, UNDEFINED, UNKNOWN, NONE, PRS, INFOFAX, VAS, MAX2) the values specified here will be used to calculate the cost of the fax based on the page count estimated or entered by the user.