Amanda Work Group Installation Manual

							Chapter 18: Configuration Reference 217
urgent_to_frontControls the priority of urgent messages. This is not supported in Aman-
[email protected]/DOS when the server is enabled.
True or False. The default is True.
When True, Amanda places urgent messages in front of other messages (new and 
old) for a mailbox. The user cannot press 4 to wrap from the first to the last message. 
He must listen to the urgent messages first.
When False, urgent messages are mixed in with other messages in the order that they 
were received.
See also play_new_first.
The default appears in install.cfg as:
set urgent_to_front true
use_pvcControls whether Amanda uses the positive voice control feature available on the 
Brooktrout voice board.
True or False. The default is True.
When True, Amanda detects a human voice faster, but there is a greater chance of 
identifying an unanswered call as answered and ending her supervision of the call 
too soon.
When False, Amanda may take more time to detect an answer during supervised 
transfers, but false answer detects are less likely.
See also voice_analysis_length.
The default appears in install.cfg as:
set use_pvc true
use_tutorialControls whether Amanda uses the tutorial for setting up mailboxes when 
users use the telephone user interface for the first time.
True or False. The default is True.
When True, Amanda suggests that the user use the tutorial to set up his or 
her mailbox. Amanda continues to make this suggestion until the mailbox 
has been set up.
When False, Amanda does not suggest that the user use the tutorial. 
Regardless of the setting, Amanda retains information about who has and 
hasn’t set up mailboxes so that anytime this configuration parameter is set 
to True, Amanda behaves correctly.
The default appears in install.cfg as:
set use_tutorial true
General Options (Continued)
Configuration OptionDescription 
						

							218 Installing [email protected]/DOS
user_logIf you provide a file name, Amanda creates that file and logs:
The date, time, and mailbox when any mailbox is accessed by DTMF. For example, 
whenever a caller enters a mailbox, that information is logged.
The file can be analyzed later for call distribution and access to mailboxes by date, 
day, and time.
The default is to not log data (because no file name is provided). We recommend 
using USER.LOG.
See also msg_log.
The default appears in install.cfg as:
set user_log 
voice_analysis_
lengthWhen positive voice control is used, this option specifies how long a noise must con-
tinue before Amanda decides that it is a voice answer and not just a glitch. 
Number of hundredths of seconds. The range is from 1 to 6553. The suggested range 
is 1 to 100. The default is 19.
N
OTE:
  The default (.19 seconds) appears to eliminate false answer detection on 
Panasonic and Samsung telephone switching systems, allowing them to 
work with the 5.54 Brooktrout driver.
See also use_pvc.
The default appears in install.cfg as:
set voice_analysis_length 19
General Options (Continued)
Configuration OptionDescription 
						

							Chapter 18: Configuration Reference 219
Fax Options
Configuration OptionDescription
fax_direct_
connectThe string to send (after AT) to the fax modem to make it connect to a ringing tele-
phone, play the CNG tone, and send the fax. Use a maximum of 20 characters. This 
option defaults to H1O0 which some Zoom modems require.
N
OTE:
The value of H1O0 contains four distinct characters:  alphabetic H, numer-
ic one, alphabetic O, and numeric zero.
The default appears in install.cfg as:
set fax_direct_connect H1O0
fax_dl_initWhen a user is listening to messages over the telephone and discovers that he has a 
fax message, he dials 72 to send the message to a fax machine followed by the tele-
phone number for the fax machine. Amanda dials this option before she dials the fax 
machines number. Usually, it is the dial code for accessing an outside line. The de-
fault is 9,. Use a maximum of 20 characters.
The default appears in install.cfg as:
set fax_dl_init 9,
fax_flow_controlDefines the Class 2 command to set the type of flow control for the fax modem. The 
default is &K3. Use a maximum of 20 characters. 
For Use
Rockwell-based fax modems &K3
Aceex modems \Q3 X3 &K3
Practical Peripherals modems X3 &K3
Zoom modems &K3
Smart One 1442 modems &K4
Boca 
modem M144EW&K3
The default appears in install.cfg as:
set fax_flow_control &K3
fax_idIdentifies your fax modem. Use the company name or the telephone number of your 
fax machine. Use a maximum of 20 characters.
By default, no identification is provided. When two faxes connect, they exchange 
and then display each other’s identifying strings.
The default appears in install.cfg as:
set fax_id  
						

							220 Installing [email protected]/DOS
fax_id_padControls whether 1111 is added to the front of the fax_id. Many older fax modems 
need some extra characters as padding. Otherwise, part of the identifying string is 
cut off.
True or False. The default is True, but if 1111 appears on the receiving fax machine, 
change this option to False (so no padding characters are added).
The default appears in install.cfg as:
set fax_id_pad true
fax_initString sent to initialize a fax modem (give it a known starting state). The default is 
&F0E0. Use a maximum of 20 characters.
Some modems require &F rather than &F0. The E0 insures that the modem is 
in non-echo mode, because the command that puts the modem into Class 2 or Class 
2.0 mode expects the fax modem to be in non-echo mode first. 
The default appears in install.cfg as:
set fax_init &FE0
fax_logUse this option to log data about files (not messages) that are faxed. Amanda creates 
a log file in the C:\AMANDA directory and logs: 
 The names of the files that were faxed 
 The telephone numbers to which the files were sent
By default, no filename is used and no log is written. Use a maximum of 20 charac-
ters. We recommend using FAX.LOG.
The default appears in install.cfg as:
set fax_log 
fax_max_retriesDefines the maximum number of times, after the first, to retry sending a fax file if it 
is unsuccessful. This is used only when sending the fax in two-call mode (where the 
caller enters a fax telephone number and the fax modem sends the file to that num-
ber).
The range is 0 to 9. The default is 1.
The default appears in install.cfg as:
set fax_max_retries 1
Fax Options (Continued)
Configuration OptionDescription 
						

							Chapter 18: Configuration Reference 221
fax_receive_reverseTrue or False. Depends solely on the fax modem you are using. For most Rockwell-
chipset-based Class 2 modems, this parameter should be True. For most other mo-
dems (including Class 2.0), it should be False.
If set incorrectly, received faxes cannot be retransmitted or viewed at all. Setting it 
to True reverses the bits within each received byte, correcting for an oddity in the 
Rockwell firmware.
The default appears in install.cfg as:
set fax_receive_reverse false
fax_receive_speedThe maximum speed for receiving faxes. 
The value can be 0, 1, 3. Use 0 for 2400 bps, 1 for 4800 bps, and 3 for 9600 bps.
Normally a value of 3 works for 486 CPUs at 25MHz or higher (and is the default). 
If you experience data loss on your faxes, lower this setting.
The default appears in install.cfg as:
set fax_receive_speed 3
fax_requeue_
intervalDefines the number of minutes to wait between retries.
The range is 1 to 99. The default is 5.
See also max_retries.
The default appears in install.cfg as:
set fax_requeue_interval 5
fax_resetDefines the reset command to send to your fax modem when DTR (Data Terminal 
Ready) is dropped. For most Rockwell-based fax modems, it should be &D3, which 
is the default.
Possible values: See your fax modem manual. Use a maximum of 20 characters.
The default appears in install.cfg as:
set fax_reset &D3
fax_send_reverseTrue or False, depends solely on your Class 2 or Class 2.0 fax modem. For most fax 
modems, this option should be False. 
The default appears in install.cfg as:
set fax_send_reverse false
Fax Options (Continued)
Configuration OptionDescription 
						

							222 Installing [email protected]/DOS
fax_send_speedThe maximum speed that Amanda uses to send faxes. 
The value can be 0, 1, 3. Use 0 for 2400, 1 for 4800, and 3 for 9600 bps. Nor-
mally a value of 3 works for 486 CPUs at 25MHz or higher (and is the default), but 
it depends on your computer.
If you experience data loss on your faxes, lower this setting.
The default appears in install.cfg as:
set fax_send_speed 3
fax_start_charControls whether the system waits for the start character or not.
True or False. The default is False.
When True, Amanda waits for the character.
When False, Amanda does not wait.
Early drafts of the CCITT Class 2 Specification require that, when sending a fax, the 
sender wait for the fax modem to send a control character indicating that it is ready 
for the data to begin. Some modems lose data if the computer starts sending before 
the fax modem indicates that its ready to receive. Unfortunately, not all Class 2 fax 
modems send the start character.
The default appears in install.cfg as:
set fax_start_char false
fax1
fax2
fax3
fax4Use these options to define the station, or extension, number to which your fax mo-
dem is connected. For example, if the first fax modem is connected to extension 101, 
set fax1 to 101.
By default, no extension is set for a fax modem. Use a maximum of 7 digits.
The defaults appear in install.cfg as:
set faxn
 
where n
 is logical serial port 1, 2, 3, or 4. See serial_portn.
max_local_
extensionThe maximum number of digits that can be considered an extension number. 
The default number is 6. The range is 1 to 6.
Users (at the message menu) can send fax messages they have received to a fax ma-
chine by entering 72 then a fax machine’s telephone number. Amanda applies 
fax_dl_init (usually 9 for an outside line) if the telephone number entered by the 
user has more digits than max_local_extension.
The default appears in install.cfg as:
set max_local_extension 6
Fax Options (Continued)
Configuration OptionDescription 
						

							Chapter 18: Configuration Reference 223
Hot Box Options
Configuration OptionDescription
hot_boxDefines the mailboxes to which Amanda goes when she detects special PCPM tones. 
You can have up to 10  hot_boxes. For example, you can configure a hot_box to de-
tect connections from TDD machines for deaf communications. 
In most cases, only one hot_box is defined to detect fax tones and the remainder are 
unused. 
You provide a mailbox next to the corresponding PCPM code (12 to 21). The default 
mailbox is -1, which means no mailbox. We recommend using 994 as the first 
hot_box mailbox, but you can use any valid mailbox.
N
OTE:
To add a specific tone to the tone table, it must be one of the first four tones 
defined, and it must be marked as a terminating tone. Call to be faxed Tech-
nical Note 8, “Special Tone Detection.”
The defaults appear in install.cfg as:
set hot_box -1 n
where n
 is either -1 or the PCPM code minus 12. (For example, for PCPM code 12, 
you use 12-12 which is 0. The range for n is from -1 to 9.) 
						

							224 Installing [email protected]/DOS
Network Options
Configuration OptionDescription
client_activation_
keyActivation key that validates the value specified by n_clients. It is normally gener-
ated automatically as the client connections are installed. If you change or add a 
board later, you need another activation key because the key is based on the serial 
number for the first board. The first board is based on its low I/O port number (the 
first Brooktrout board is usually 300H). Get the key from your Amanda Company 
sales representative. 
The default is 0, which means there is no client activation key. 
See also n_clients.
The default appears in install.cfg as: 
set client_activation_key 0
dialer_max_portSpecifies the highest Amanda telephone port to be considered for use when Amanda 
Dialer dials a number. The range is 0 to the highest port number available. 
The default is 0. When dialer_min_port and dialer_max_port are both 0, Amanda 
uses all ports. 
The default appears in install.cfg as:
set dialer_max_port 0
dialer_min_portSpecifies the lowest Amanda telephone port to be considered for use when Amanda 
Dialer dials a number. The range is 0 to the highest port number available. 
The default is 0. When dialer_min_port and dialer_max_port are both 0, Amanda 
uses all ports. 
The default appears in install.cfg as: 
set dialer_min_port 0
dir_formatDetermines how names associated with mailboxes in the employee directory are for-
matted for the client applications. “%1” expands to the “Directory Name 1” field, 
“%2” to the “Directory Name 2” field, and “%c” to the “Comment” field. Other 
characters (such as space) are taken literally. The most common value is %1 %2. 
The default is %1 %2. 
The default appears in install.cfg as:
set dir_format %1 %2 
						

							Chapter 18: Configuration Reference 225
multiple_clientsControls whether multiple connections (logons) are allowed from the same mailbox. 
The default is 3.The range is from 1 to 3. When 1, only one connection is allowed 
per mailbox. When 2, only one connection is allowed per mailbox, with the excep-
tion of the special mailbox 999, which can connect multiple times. When 3, any 
mailbox can connect multiple times. 
The default appears in install.cfg as:
set multiple_clients 3
n_clientsAlong with client_activation_key, controls the number of client connections 
(logons) that can simultaneously connect to the [email protected]/DOS serv-
er. This is normally set automatically when the client connections are installed into 
the server. 
The default is 0, which means 1 client. The range is from 0 to 99 (99 is 100 clients).
The default appears in install.cfg as:
set n_clients 0
service_nameThe servers NETBIOS name. 
The default is AMANDASERVER. 
The default appears in install.cfg as:
set service_name AMANDASERVER
tmo_call_screeningThe number of seconds that Amanda waits for the user to accept or reject a call. This 
applies to call screening and to waiting call processing.
The default is 30. The range is 0 to 255. 
The default appears in install.cfg as:
set tmo_call_screening 30
 
Network Options (Continued)
Configuration OptionDescription 
						

							226 Installing [email protected]/DOS
Outdial Options
Configuration OptionDescription
box_outdialControls special mailbox options.
You provide a mailbox for each telephone digit that becomes a special mailbox op-
tion. 
While logged into a mailbox, a user presses 7 to reach special options, then a digit, 
0-9, depending on what you specify here. Then Amanda executes the tokens in the 
extension field of the mailbox you specify for that digit.
Setting the mailbox to -1 disables that special mailbox option. For example, to allow 
users to press 7 then 5 to call for the time of day, you might type 149 next to the digit 
5. In this case, 149’s Extension field should contain the telephone number Amanda 
dials for the weather (perhaps 9,8531212). Later, users log into their mailboxes and 
press 75 for the current time. Afterwards they continue other mailbox options. 
The defaults appear in install.cfg as:
set box_outdial -1 x
where x is a digit from 0 to 9
C
AUTION:
If you use box_outdial to give users an outside line, you might want to 
use telephone lines that are toll restricted.