Amanda Work Group Manual

							Chapter 6: Defining Tone Patterns 81
You can use this check box to terminate functions in real time when the tone is 
detected. When selected, the tone must use one of the first four filters listed in the Fil-
ter dialog box.
5. To stop AccuCall for Windows from testing the frequency of the tone, select the 
Cadence Only check box. 
This is useful if one or more of the tones in the PCPM table for the PBX has the same 
frequency.
Clear it to use both the frequency and the cadence.
6. To have AccuCall for Windows test whether the tone’s frequency is on the line for a 
specified duration of time, type that number of milliseconds in the Quick Count text 
box.
This is useful if the tone’s frequency is constant, (for example: a dial tone), or if the 
tone’s cadence is very short, (for example: fax or pager tones). 
Do not use this option if any tones in the PCPM table use the same filters. 
The value ‘-1’ turns this option off.
7. Click OK.
If you change a tone’s frequency, you will have to change the Filters window as well.
To add a new frequency to the Filters window:
1.  Select the Filters tab (or from the View menu, click Filters).
2. Add the new frequency and delete the old (unless it is used by another tone).
3. Type the frequency’s new value over its current value in the Filters box. 
If you designate a frequency as Terminating in the Edit Tone dialog box, you must 
type that tone in one of the first four text boxes.
4. After you have made the modifications you want to make, click Update.
Using Your PCPM Table
This procedure describes how to have the Brooktrout voice processing driver use your 
PCPM table.
To use your PCPM table:
1. Open the PCPM Table stored in your tone file (.TON).
2. On the VP menu, click Install Table to VP Driver. 
						

							82 Installing [email protected]/Windows
Recording a Tone
To record a tone:
1. From the Tools menu, click Record Tone.
The Record Tone dialog box appears.
A progress bar appears.
2. Click Stop at any time to stop the recording.
Understanding Call Progress Tones
Your PBX uses audible tones called call progress tones to indicate the progress of a call. 
These tones include the dial tone, busy tone, and ringing tone like those used by the public 
telephone network. Amanda and individual callers use call progress tones to determine 
how to respond during a call. For example, the busy signal indicates that the extension is 
busy. Different tones vary in frequency and cadence.
 A call progress tone usually has one or two frequencies, referred to as single-fre-
quency or double-frequency tones. Individual frequencies can range between 300 
Hz and 4000 Hz. 
 A cadence consists of the on time and off time. Tones can either have one cycle 
or two cycles, referred to as single cycle or double cycle cadences as shown in the 
following figure.
The following table shows some common tones for the US public telephone network.
Cadence
ToneFrequencyOn PeriodOff period 
						

							Chapter 6: Defining Tone Patterns 83
Recognizing Tones
Since PBXs use different frequencies and cadences for their tones, you need to train your 
Brooktrout board to recognize these specific tones.
AccuCall Wizard automatically trains your board to recognize the hangup, busy, and 
ringing tones of your PBX.
 The hangup tone indicates that the other line has gone onhook.
 The busy tone indicates that the line you called is busy. There are two types of 
busy signals: trunk busy and station busy. Trunk busy, also called fast busy, indi-
cates that all paths in the network are busy. Station busy means that the number or 
extension you called is busy.
 A ringing tone indicates to the called station that there is an incoming call. A sim-
ulated ringing signal is returned to the caller to indicate that a path has been estab-
lished and the called number or extension is being rung. The simulated signal is 
called ring back.
You can customize AccuCall Wizard to recognize custom tones such as dial tone or any 
other tones used by your PBX with a frequency of 300 Hz to 4000 Hz.
AccuCall Wizard stores information about each tone in a tone table. For each tone, the 
tone table contains the frequency, cadence, Programmable Call Progression Monitor 
(PCPM) number associated with the tone, and other tone-specific characteristics. 
AccuCall Wizard automatically assigns a PCPM number to the pre-configured tones.
Responding to Incoming Tones
When your Brooktrout board receives a call progress tone, it analyzes the frequency and 
cadence of the tone. Your driver compares the tone characteristics to those stored in the 
tone table. If it finds a match, the driver returns the PCPM number associated with the 
tone. The PCPM number conveys information about what type of tone it is and how 
Amanda should respond.
For example, if your Brooktrout board detects a busy tone, the driver compares the 
cadence and frequency of that tone to those stored in the tone table. When it matches the 
incoming tone to the stored busy tone, the driver reports to Amanda that a PCPM code of 
7 has be received. This lets Amanda know that the line is busy, and the system responds 
appropriately.
Trunk/Fast Busy480 Hz and 620 Hz250 msec.250 msec.
Station Busy480 Hz and 620 Hz500 msec.500 msec.
Ringing440 Hz and 480 Hz2 sec.4 sec. 
						

							84 Installing [email protected]/Windows 
						

							Chapter 7:
Faxing
Using This Chapter
This chapter:
 Explains how to set up a fax modem or the Brooktrout TruFax/200 board for use 
with Amanda. This applies to any voice board supported by Amanda.
 Explains how to detect a fax machine automatically.
 Provides an overview of Amanda Fax, a fax driver for sending faxes from any 
Windows application that can print. Amanda Fax is an Amanda client.
Using a Fax Modem
You can use a fax modem on any [email protected]/Windows system.
The fax modem used in Amanda may be internal or external as long as it meets all of the 
following requirements:
 Class 2 or Class 2.0 compliant. (Be aware that Class 2 is different from Class 2.0.)
 Internal fax modems must have a UART 16550 serial interface, and external fax 
modems must be connected to UART 16550 serial ports. 
N
OTE:If you have a Class 2 modem, the default configuration settings for fax 
options should work well with your modem. If you have a Class 2.0 mo-
dem, change the setting for fax_send_reverse to F for False.
You must configure the fax modem for one of the following:
 COM1 with IRQ4 and no other devices on COM1 or using IRQ4
 COM2 with IRQ3 and no other devices on COM2 or using IRQ3
 COM3 with IRQ11 and no other devices on COM3 or using IRQ11
We recommend using COM1 and/or COM2 for fax modems. This port must be dedicated 
to the fax modem.
To configure a fax modem for Amanda:
1. From the Start menu, select Start⇒Amanda Server⇒Setup.
The Amanda Setup dialog box opens.
The Setup utility’s basic operation is explained in “Logging On to Amanda” on 
page 5. 
						

							86 Installing [email protected]/Windows
2. Select the Serial Port Settings tab.
3. Select a serial port that has not yet been assigned.
To prevent confusion, you can use Serial Port 1 for COM port 1 (COM1), Serial Port 
2 for COM port 2 (COM2), etc., but this is not necessary. The serial port is a logical 
port as understood by the Amanda system. The COM port is the physical port 
assigned to that logical port. For example, you can use define Serial Port 4 as COM 
port 1.
Remember the number of your serial port because you use it in step 5.
a. Use the spin buttons to select settings for the correct COM Port, Baud Rate 
(really bps—bits per second), Data Bits, and Stop Bits for your fax modem.
b. Select a parity type from the Parity drop-down list box.
4. Scroll the tab bar and select the FAX Settings tab. 
						

							Chapter 7: Faxing87
Scroll the dialog box to see additional fax parameters.
Check your modem manual for the information you need to set these parameters. 
						

							88 Installing [email protected]/Windows
5. Set Fax n Extension (where n is the number for the logical serial port) to the exten-
sion number where the fax modem is connected on the telephone switching system 
(this must be a single line extension).
You can have up to four fax modems connected to telephone extensions.
6. Set Dial Out Dialstring to the outside access code for the telephone switching system. 
(Adding a comma causes a 2-second pause.)
This parameter defaults to “9,” which works for most system.s
7. Set the Flow Control Command to the Class 2 command for the type of flow control 
used by your fax modem. For several modems, the default “&K3” works.
8. Set Fax ID to a number or a name used to identify your fax modem (for example, 
FAXA).
9. Many older Class 2 fax modems need a string of leading digits ‘1111’ for their Fax 
ID. By default, Amanda adds these digits.
However, if they appear on the receiving fax machine, set Fax ID Padding to true.
10. Set Longest Local Extension to the maximum number of digits contained in a local 
extension number. This is used when the “72” Fax retrieve command is selected so 
that Dial Out Dialstring (usually ‘9,’) will be applied only for outside calls.
N
OTE:You don’t need to change the default values for the other fax configura-
tion parameters. For a description of these settings, see “Fax Settings” on 
page 224.
To use the fax modem effectively, you must also use tokens to program 
the Extension fields for one or more mailbox. For more information, see 
“Allowing One-call and Two-call Faxbacks” on page 173.
Fax settings are stored in the install.cfg file.
Suggested Settings
The following modems have been used with Amanda with the following settings. This is 
not a comprehensive list, and many other modems work with Amanda. The following 
settings are not even guaranteed to work with your modem (even if your modem is one of 
those listed) because modem manufactures produce a variety of models and change their 
firmware from time to time. However, you may want to try them.
Zoom Modems:
Flow Control Command &K3
Dial Out Dialstring -
Rockwell-based Modems:
Flow Control Command &K3
Aceex Modems
Flow Control Command \Q3 &K3
Practical Peripherals Modems
Flow Control Command X3 &K3
SmartOne 1442 Faxmodems
Flow Control Command &K4 
						

							Chapter 7: Faxing89
Direct Connect Command H1O0
fax_receive_reverse T
Maximum Retries &D3
Reverse Send F
Boca modem M144EW
Flow Control Command &K3
Using the Brooktrout TruFax/200 Board
The Brooktrout TruFax/200 board is a two-port ISA board. Its driver supports up to 6 
boards, giving Amanda the ability to have as many as 12 industrial-strength fax ports, in 
addition to 48 voice ports. You cannot simultaneously use both fax modems and TruFax 
boards. Amanda’s support for them is mutually exclusive.
To use TruFax boards:
1. Configure the board that you will be using.
As with Brooktrout voice boards, all the fax cards can be jumpered to use the same 
IRQ interrupt number, but they should all have unique I/O addresses set via the 
Address dip switches. 
Make sure that the IRQ and I/O addresses that you choose do not conflict with any 
other devices in the computer, and configure the system’s BIOS’s plug-and-play set-
tings so that it is aware that a Legacy ISA device will be using the IRQ you have cho-
sen. Then it will not subsequently try to assign another device to that same IRQ.
2. Install the TruFax driver from the Amanda installation CD by executing TruFax.exe 
and following its prompts. 
N
OTE:The TruFax board does not use DMA, so you should input -1 in re-
sponse to that question. Be sure to choose Yes to have the driver start 
automatically when you start the computer.
3. Test your installation by running the faxinit.exe program manually from the command 
prompt. The driver normally finds all the TruFax/200 boards automatically, but some-
times you have to create a configuration file listing the I/O addresses of the boards 
that you have installed. This prevents the driver from searching other I/O addresses 
and becoming confused by other devices it happens to find at those addresses. If you 
have four boards at 304, 308, 30C, and 310, the configuration file would read 
addr 304
addr 308
addr 30C
addr 310
Type the name of this configuration file on the command line after faxinit.
I
MPORTANT:If a configuration file is necessary, you must run the “In-
stall TruFax Driver” again so that you can change your an-
swer to the last question (which asks what arguments 
should be passed to faxinit when the driver is starting). Oth-
erwise, the driver will continue to use your new configura-
tion file each time the system starts. 
						

							90 Installing [email protected]/Windows
4. When using the TruFax boards from Amanda, only the following fax parameters are 
used:
 Fax ID, an up to 20-character string used to identify your Brooktrout TruFax/200 
board. Use the company name or the telephone number of your fax machine.
 Log Filename, the name of the log file that records data about files (not mes-
sages) that are faxed. The Amanda Company recommends using FAX.LOG.
 Maximum Retries, the number of times (from 0 to 9) to attempt to resend a fax 
after an unsuccessful transmission.
Fax n Extension (where n is 1, 2, 3, or 4), parameters that specify the extension 
numbers that the telephone switching system uses for first four fax ports (the fax 
ports on the first two TruFax cards). If there are more than four TruFax ports, 
then their extensions must be consecutive and are determined from Fax 4 Exten-
sion. For example, the 5th fax port is assumed to be the next extension; the 6th 
the one after that, etc.
The remaining fax parameters apply only to fax modems, so they are not used by the 
TruFax boards.
Hot box settings are stored in the install.cfg file.
5. You can set fax_monitor, a global setting parameter that notifies the sending mailbox 
about the success or failure of a fax transmission.
Global settings are stored in the install.cfg file.
Integration settings are stored in the 1001.PBX or 2001.PBX file.
6. Finally, you can set tmo_dtwait, the dial code parameter that determines whether a 
TruFax board waits for a dialtone before dialing. If this parameter’s setting is positive, 
the TruFax board will wait for a dialtone.
Dial code settings are stored in the 1001.PBX or 2001.PBX file.
Detecting a Fax Machine Automatically
Amanda can detect and accept incoming faxes automatically.
To automatically detect and accept an incoming fax:
 The fax connect tone must be in the PCPM tone table.
The tone information is stored in C:\AMANDA\PBX.DB\1001.TON.
The tone must be one of the first four tones or frequencies defined, and it must be 
marked as a terminating tone. The PCPM code associated with the tone must be in the 
range 12–21.
 A mailbox (usually 994) must be set up to process faxes. To learn how to create 
that mailbox, see Administering [email protected]/Windows.
 That mailbox must be specified in the hot_box configuration option. See “Creat-
ing the Hot Box Mailbox” on page 91.
Hot box settings are stored in the install.cfg file.