Amanda Work Group 7xx Installation Manual

							Chapter 9:
Faxing
Using This Chapter
If you plan to develop fax applications using Amanda, two call fax-on-
demand applications can be created with Amanda fax ports connected 
directly to Central Office telephone lines. One call fax-back and fax mail 
applications, on the other hand, will require that the fax ports be connected 
through the Norstar using Analog Terminal Adapter (ATA) equipment.
This chapter:
 Explains how to set up a fax modem for use with Amanda. This ap-
plies to any voice board supported by Amanda and applies to both 
Amanda Standalone and Amanda Voice Server.
 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 a client 
of Amanda Voice Server. It cannot be used with Amanda Standal-
one.
Using a Fax Modem
You can use a fax modem on any [email protected]/DOS system. 
However, you must install an Analog Terminal Adapter (ATA). An ATA 
connects a digital Meridian Norstar telephone port to a data communication 
device, such as a modem or facsimile machine. The ATA provides an on or 
off premise service. Contact your Norstar representative about pricing and 
installation information. 
						

							132 Installing [email protected]/DOS
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. 
The MSD.EXE program in DOS can verify whether or not your PC has these 
high speed serial ports. So can IS16550. (The syntax is IS16550 /x where x is 
the number of the COM port.)
N
OTE:If you have a Class 2 modem, the default configuration set-
tings for fax options should work well with your modem. If 
you have a Class 2.0 modem, change the setting for 
fax_send_reverse to F for False.
You must configure the fax modem for one of the following:
We recommend using COM1 and/or COM2 for fax modems. This port must 
be dedicated to the fax modem.
N
OTE:If you have a turnkey Amanda system, it comes with an in-
ternal modem which uses COM4 and IRQ5. This is used 
only by the host software on the Amanda computer that al-
lows you to control Amanda from a remote site using the re-
mote program. None of Amanda’s configuration options 
have anything to do with this modem, but the fax modem 
cannot be set to COM4 or IRQ5. Even if your system is not 
a turnkey system, we recommend that you install an inter-
nal data modem using the same COM port and IRQ so you 
can contact Amanda remotely. If you ever need customer 
support from The Amanda Company, this modem will 
make it possible to solve your problem much more quickly. 
See “Chapter 10: Accessing Amanda Remotely” for more 
information about host and remote software.
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 
						

							Chapter 9: Faxing 133
To configure a fax modem for Amanda:
1. Run the Setup utility.
2. From the Work.Group/DOS Configuration Utility menu, select System 
Configuration Options or press 2.
3. From the System Configuration menu, press A for Advanced Configu-
ration.
4. From the Advanced Configuration menu, press S for Serial.
The Serial Port Definition dialog box appears. 
(If you type a space, the Setup utility interprets it as a zero.)
5. Change:
serial_portn 0
To :
serial_portn y
The option maps Amandas logical port to a physical port on the PC.  
						

							134 Installing [email protected]/DOS
The n is the number of the logical serial port and the y is the physical 
serial port (for example, COM1). It is best to make n and y the same 
number. For example, map logical port 2 to COM2.
6. Modify the baudn, databitsn, stopbitsn, and parityn to 
match the correct values for the serial integration link you are receiving. 
The n is the number you used for n in step 5.
7. Press F10 to save your changes.
The Save All Data? dialog box appears.
8. Press Y for Yes.
9. From the Advanced Configuration menu, press F for Fax.
The Fax Configuration screen appears. 
(If you type a space, the Setup utility interprets it as a zero.) 
						

							Chapter 9: Faxing 135
10. (Skip this step if you dial 9 to access an outside line.) In the Fax section 
on Advanced Configuration, change:
fax_dl_init 9,
To :
fax_dl_init n
replace n with the outside access code for the telephone switching sys-
tem. (Adding a comma causes a 2-second pause.)
11.  (Skip this step if you have a Zoom modem.) Change:
fax_flow_control &K3
For Aceex modems, use:
fax_flow_control \Q3 X3 &K3
For Practical Peripherals modems, use:
fax_flow_control X3 &K3
This option has the Class 2 command for the type of flow control used 
by your fax modem.
12. Change:
fax_id 
To :
fax_id fax
where fax is a number or a name used to identify your fax modem (for 
example, FAXA) 
13. 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, change:
fax_id_pad T
To :
fax_id_pad F 
						

							136 Installing [email protected]/DOS
14. Change:
faxn 
To :
faxn ext
where n is the number for the logical serial port and ext is the extension 
number where the fax modem is connected on the telephone switching 
system (this must be a single line extension). 
15. This defines the maximum number of digits for a local extension. This is 
used when the “72” Fax retrieve command is selected so that fax_dl_init 
(usually ‘9,’) will be applied only for outside calls.
Change:
max_local_extension 6
To :
max_local_extension n
where n is the maximum number of digits in a telephone extension on 
your telephone switching system.
N
OTE:You don’t need to change the default values for the other 
serial port and fax configuration options.
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 the sections on one and two-call 
faxbacks in “Chapter 11: Programming Examples,” in 
Administering [email protected]/DOS.
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. 
						

							Chapter 9: Faxing 137
Zoom Modems
fax_flow_control &K3
fax_dl_init -
Aceex Modems
fax_flow_control \Q3 &K3
Practical Peripherals Modems
fax_flow_control X3 &K3
SmartOne 1442 Faxmodems
fax_flow_control &K4
fax_direct_connect H1O0
fax_receive_reverse T
fax_reset &D3
fax_send_reverse F
Boca modem M144EW
fax_flow_control &K3
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 fax tone information is stored in C:\AMANDA\PBX.DB 
1001.GTD.
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 and program that mailbox, see Administering Aman-
[email protected]/DOS.
 That mailbox must be specified in the hot_box configuration option. 
						

							138 Installing [email protected]/DOS
Modifying the PCPM Tone Table
The file 1001.GTD is predefined to use PCPM Tone 13 for fax purposes. 
SmartCall, one of the utilities available from the Diag utility creates and/or 
changes settings in .GTD files. You should not need to modify the tone table 
for the voice board. However, the following procedured is provided—just in 
case.
To modify the tone table for the voice board:
1. Run DIAG. 
For more information, see “Using Tone Files” on page 67.
2. To detect a FAX tone, use the following:
All other values can remain at their defaults.
N
OTE:Remember to insert the FREQ1 value of 1100 into the filter 
table in one of the first four positions. Only frequencies in 
the first four positions are used for terminating tones.
NAME:FAX CNG TONE
TYPE:OTHER
TERMINATING:YES
CADENCE:NO
FREQ1:1100
FREQ2:NONE
PCPMCODE:13 (12 through 21 are acceptable)
QUICKCOUNT:400
ON TIME:528
OFF TIME:2976 
						

							Chapter 9: Faxing 139
Creating the Hot Box Mailbox
The Amanda Company recommends using mailbox 994 as the first hot_box, 
but you can use any valid mailbox. Use the Users screen of Amanda 
Standalone or the Mailbox window of Amanda Administrator to create the 
mailbox that will process the PCPM tone. See Administering 
[email protected]/DOS for information about creating mailboxes.
Scenario #1: Blind transfer to fax machine
After calling Amanda, the caller presses the Start button on his fax machine 
during the Company greeting (or some other greeting). Amanda recognizes 
the tone and processes mailbox 994. mailbox 994 performs a blind transfer 
to the fax machine. The Extension field for mailbox 994 must contain the 
extension connected to the fax machine followed by an H (hangup).
Example Extension field:
1000H
where extension 1000 is connected to the fax machine
Scenario #2: Fax message left for user (who can view the fax using 
Amanda Messenger)
The caller dials a user and presses the Start button on his fax machine during 
the user’s greeting. Amanda recognizes the tone and processes mailbox 994. 
mailbox 994 tells Amanda to create a fax message for the user who was 
called. The Extension field for mailbox 994 contains tokens similar to the 
following:
Example Extension field:
@J(%P,’’,’%X%F-H’)
which translates as the following:
@ Indicates to Amanda that she is to perform token programming
J() token Command that allows a fax to be received as a file or as a 
message for a mailbox
%P Indicates that the owner of the most recently processed mailbox 
is to receive the fax message
‘’
Makes Amanda wait until a call rings into a fax port 
						

							140 Installing [email protected]/DOS
%X System variable that contains the codes needed to transfer dial 
tone on the current port
%F The extension of the fax port being used
-H A hangup (after pausing a half second to complete a blind 
transfer)
Setting the Hot Box Options
You must let Amanda know the mailbox that will process the PCPM tone by 
setting the hot_box configuration option.
To designate a mailbox to accept incoming faxes:
1. Run the Setup utility. At the DOS prompt, from the directory 
C:\AMANDA, type:
SETUP
Then press Enter.
2. From the main menu,  press 2.
The System Configuration Options menu appears.
3. From the System Configuration menu, type:
A
(for Advanced Configuration).
4. From the Advanced Configuration menu, type:
H
(for Hot Boxes).
5. Select the number that corresponds to the PCPM code. In this case, you 
use 13.
6. Type the mailbox number next to the code.
Your typing replaces previous setting (by default -1 for no mailbox).
7. Press F10 to save.