Amanda Work Group Installation Manual

							Chapter 18: Configuration Reference 197
integration_termA one-character string containing the character that terminates DTMF input. The de-
fault is the empty string. When Amanda sees the character that matches 
integration_term, she terminates the integration input. 
This can be used to speed up slow systems. The terminating character is not removed 
from the input, so be sure that your integration patterns include it or allow for it.
The default appears in install.cfg as:
set integration_term 
irqThe IRQ over which the voice board communicates with the Amanda system.
The default is 7. The range is 0-15, but do not change this setting unless instructed 
to by an Amanda Company employee. Most IRQs are unavailable because they are 
used by PC components.
The default appears in install.cfg as:
set irq 7
lcoffThe minimum necessary duration of loop current off before the voice board driver 
recognizes that the loop current is off. Corresponds to the Brooktrout global param-
eter LcOff.
Number of hundredths of seconds (from 1 to 6553) or the number -1 or 0. For exam-
ple 10 is .1 second. The default is -1.
When 0, the voice board’s default is used. The default is .1 seconds.
When -1, there is no wait.
The default appears in install.cfg as:
set lcoff -1
lcvalidThe length of time that the voice board driver ignores loop current transition events 
(on, off, and drop) after starting PCPM. Corresponds to the Brooktrout channel pa-
rameter LcValid.
Number of hundredths of seconds (from 1 to 255) or the number -1 or 0. For example 
10 is .1 second. The default is 0.
When 0, the voice board’s default is used. The default is 4 seconds.
When -1, this option is disabled and no events are ignored.
The default appears in install.cfg as:
set lcvalid 0
General Options (Continued)
Configuration OptionDescription 
						

							198 Installing [email protected]/DOS
lcwaitThe minimum time after dialing a digit string before the voice board driver decides 
the loop current drop is an answer. Corresponds to the Brooktrout channel parameter 
LcWait.
Number of hundredths of seconds (from 1 to 255) or the number -1 or 0. For example 
10 is .1 second. The default is 0.
When 0, the voice board’s default is used. The default is 100 ms (.1 seconds). 
When -1, this option is disabled and there is no minimum time.
The default appears in install.cfg as:
set lcwait 0
list_delayWhen a message is sent to a list, this is the delay between deliveries to mailboxes on 
the list. It has no effect on direct messaging or future deliveries. Slowing down the 
delivery rate makes sending to long lists less likely to slow down the system.
Number of tenths of a second. The default is 10 (which is 1 second). The range is 0 
to 255.
The default appears in install.cfg as:
set list_delay 10
lognamThe name of the file to be used as the system log file. It is stored in the C:\AMANDA 
directory. This log file contains start-up information, any execution error informa-
tion, DOS errors, disk errors, system actions, and shutdown information. 
The default filename is AMANDA.LOG.
N
OTE:
Since this file grows (slowly), archive or delete it once or twice a year when 
you perform preventative maintenance.
The default appears in install.cfg as:
set lognam AMANDA.LOG
lpt_portNumber of the printer port to which a printer is attached to Amanda. 
The default is 0, which means that no printer is attached.
While a printer can be attached to LPT ports 1, 2, or 3, use 1 for best results and at-
tach the printer to LPT1.
If you use a non-zero value, but no printer is attached, Amanda halts.
See also auto_report and auto_report_time.
The default appears in install.cfg as:
set lpt_port 0
General Options (Continued)
Configuration OptionDescription 
						

							Chapter 18: Configuration Reference 199
max_chainControls the number of digits the caller can enter for a mailbox. 
For example, if you have a three-digit extension plan, setting this parameter 
to 3 allows Amanda to transfer to the mailbox immediately after three digits 
have been dialed, instead of waiting for a timeout or the # terminator.
The default is 8, the largest number allowed in [email protected].
The default appears in install.cfg as:
set max_chain 8
max_dl_initsThe number of ports that can go off-hook simultaneously and dial the telephone 
switching system initialization code.
The range is from 1 to the number of ports defined for Amanda. The default is 2.
The PBX file option dl_init (What to dial on each port after the system starts) works 
on the ports specified here.
The default appears in install.cfg as:
set max_dl_inits 2
max_portsNumber of ports in use on the Amanda system. This option needs to be set when the 
number of ports available is greater than the number of ports in use. For example, if 
you have a four-port voice board but are currently using only three ports, set this op-
tion to 3 to ensure that Amanda does not try to use the fourth port.
The default is 24. The range is 1-24. If you are using all the ports that your voice 
boards can support, it is OK to have a number here that is greater than the number 
of ports you have.
The default appears in install.cfg as:
set max_ports 24
max_promptThe number of times Amanda repeats menu options before hanging up on a user who 
is logged in to a mailbox.
Number from 1 to 9. The default is 2.
The default appears in install.cfg as:
set max_prompt 2
General Options (Continued)
Configuration OptionDescription 
						

							200 Installing [email protected]/DOS
minmsgAmanda requires a minimum length for recorded messages. If a message is shorter 
than this, it is not saved. The most common reason for changing this parameter is 
when the Q() token is used and short answers are expected. If so, you should change 
this to 1 (0.1 seconds.) Otherwise, using a setting that is small results in an increased 
number of messages that contain only a hangup sound.
Number of tenths of seconds. The default is 10 (1 sec.).The range is 0 to 65535.
The default appears in install.cfg as:
set minmsg 10
minoffMinimum amount of time necessary for an inbound ring’s off period.
Number of tenths of seconds. The default is 5 (.5 second). The range is 1-655.
The default appears in install.cfg as:
set minoff 5
minringMinimum amount of time necessary for an inbound ring’s on period.
Number of tenths of seconds. 
The default is 0 which tells Amanda to use the voice boards default (which is 2 for 
Denmark or Holland and 3 elsewhere). Otherwise, the range is 1-655.
The default appears in install.cfg as:
set minring 0
General Options (Continued)
Configuration OptionDescription 
						

							Chapter 18: Configuration Reference 201
modified_call_
screeningWhen a mailbox has both call screening and called party identification on, this op-
tion controls whether Amanda announces only the name and extension of the called 
party or both that and the name and company of the caller. This is usually used only 
when more than one mailbox calls the same extension.
When call screening is on, Amanda plays the Call Screening menu when the tele-
phone is answered. Then the person who answers can accept some calls and reject 
others based on the information that he hears. Amanda treats the rejected calls as 
Ring No Answers.
Do not use Call Screening (modified or not) with a mailbox that performs unsuper-
vised (blind) transfers. These transfers have an H in the Extension field (for exam-
ple, 127H). When the call is unsupervised, no recording is played to the user.
True or False. The default is True.
When True, the person who answers hears the called party’s name and extension re-
cording. Amanda does not ask the caller for a “name and company.”
When False, the person who answers hears both the caller’s name and company and 
the called party’s name and extension recording. 
The following is an example where John (mailbox 111) and Mary (mailbox 112) 
share Extension 100. John is at lunch, and Mary is answering all calls at Extension 
100.
The caller enters 111 trying to reach John.
Amanda rings Extension 100 and Mary answers.
Amanda says, “This call is for John, Extension 111. To accept this call, press 1. To 
reject this call press 2 and hang up….” Mary presses 2. The caller hears John’s cur-
rent greeting.
N
OTE:
If a user wants Amanda to announce only for the caller’s name and compa-
ny, ID Call? should be NO (on Amanda standalone) or the Identify Called 
Party check box should be cleared (in Amanda Administrator for Amanda 
Voice Server).
The default appears in install.cfg as:
set modified_call_screening true
General Options (Continued)
Configuration OptionDescription 
						

							202 Installing [email protected]/DOS
msg_logAmanda creates the specified file in the C:\AMANDA directory and logs:
The date and time every message is received
The date and time every mailbox is checked for messages along with the DTMF the 
user entered. 
The default is no filename, which means no log is written to. We recommend using 
MSG.LOG.
See also user_log. 
The default appears in install.cfg as:
set msg_log 
n_ochanAllows you to dedicate ports to notification. The default is 0 (no dedicated ports). A 
positive integer n dedicates the first n ports.
For example, when n_ochan is 2, ports 1 and 2 are dedicated and do not answer in-
coming calls. When using dedicated notification, be sure to direct incoming calls to 
ports 3 and up (in this case). 
Dedicated notification eliminates the notification collision (known as glare) caused 
when Amanda inadvertently begins a notification on a port receiving an incoming 
call. However, you can no longer use the port for incoming calls. 
When 0, Amanda does either roving or restricted notification (depending on the val-
ue of notify_restriction). With roving notification, Amanda starts with the last port 
in the hunt group and works backwards until she locates an idle port. Restricted no-
tification uses only one port, usually the last port in the hunt group. However, that 
port is not dedicated to notification. The port can still receive calls. 
N
OTE:
When using roving or restricted notification, program the ports to be in a 
linear hunt group (not a circular hunt group).
The default appears in install.cfg as:
set n_ochan 0
nam_maxlenThe maximum number of seconds to allow for recording a mailbox’s name and ex-
tension. Amanda plays the name and extension recording to provide callers with in-
formation from the employee directory and to identify who is being called.
A number of seconds. The range is from 1 to 99. The default is 5.
See also box_idx and modified_call_screening.
The default appears in install.cfg as:
set nam_maxlen 5
General Options (Continued)
Configuration OptionDescription 
						

							Chapter 18: Configuration Reference 203
new_sendDetermines whether a user can send a message to more than one user, when those 
users are not part of a single list.
True or False. The default is True.
When True, a user can send a message to several mailboxes “on the fly.” When the 
user presses 4 to send a new message, then 1 to select a mailbox destination, Aman-
da asks for the “next mailbox or the # sign to finish.” When the user presses 3 to 
send, or 5 to send with verification, the message is sent to every mailbox that was 
entered.
When False, the user can send a message only to one mailbox or to a previously cre-
ated list of mailboxes.
The default appears in install.cfg as:
set new_send true
non_relay_okNormally a caller presses ## to end the greeting and leave a message. With this op-
tion, the caller can simply press # (unless the mailbox does relay paging which is 
activated by the #).
True or False. The default is False.
When True and the mailbox does not have a relay paging notification record, press-
ing # takes the caller to the end of the greeting.
When False, the caller must press ## to end the greeting. 
The default appears in install.cfg as:
set non_relay_ok false
notify_restrictionIf you specify a port, Amanda restricts notification to that port. However, the port 
still takes incoming calls. 
Use any port number or 0. 0, the default, means that roving or dedicated notification 
is being used instead of restricted notification. You typically use the last port in the 
linear hunt group.
You must use this option if you install Amanda on a telephone switching system that 
requires the same port to turn message lights both on and off. In this case, roving 
notification could cause a message light to come on and stay on. 
Restricted notification does not eliminate the possibility of notification collisions 
(known as glare).
If notify_restriction is set to an invalid value, Amanda detects that during startup, 
resets notify_restriction to the highest port number, and logs that fact. See also 
n_ochan.
The default appears in install.cfg as: 
set notify_restriction 0
General Options (Continued)
Configuration OptionDescription 
						

							204 Installing [email protected]/DOS
off_dlyAmount of time after a line goes off-hook before the voice board notifies Amanda 
that the line is off-hook.
Number of hundredths of seconds. The default is 50 (.5 sec.). The range is 1-6553. 
The numbers 0 and -1 have special meanings.
When 0, Amanda uses the voice boards default (which is also 50). 
When -1, there is no delay.
The default appears in install.cfg as:
set off_dly 50
partial_q_okDetermines what messages are saved when the Q() command is used to get answers 
from a caller.
True or False. The default is False.
When True, Amanda saves a message even if the caller hangs up before answering 
all the questions.
When False, Amanda does not save a message using the Q() command unless all the 
questions have been answered. 
The default appears in install.cfg as:
set partial_q_ok false
passwordSets the Amanda password. The password is case-sensitive, so uppercase letters are 
different from lowercase letters. That means that AMandA, Amanda, and amanda 
all represent different passwords.
Use a text string with a maximum length is 8 characters. The default is AMandA. 
If you use the null string (that is, no password), you must use a dealer password to 
operate and shut down Amanda.
The default appears in install.cfg as:
set password AMandA
General Options (Continued)
Configuration OptionDescription 
						

							Chapter 18: Configuration Reference 205
PBXThis option is described here in case you decide to change it by editing install.cfg. 
(However, setting this option is not recommended.) The PBX option (not to be con-
fused with the pbx option) does not appear in the General Configuration section of 
the Setup utility because Setup makes changes to this option automatically. This op-
tion indicates a number for a PBX and a name for its .PBX and .TON files.
Setup assigns the number 1 to your first PBX and the number 2 to your second (if 
you have a second PBX). 
Setup automatically assigns a name (up to 8 characters) to the .PBX and .TON files 
that Amanda uses with your telephone switching system. By default, Setup uses 
1001 for the first PBX and 2001 for the second. You can use any name in install.cfg, 
but it is best to use the defaults. If you must change this option, use a number greater 
than 2001 or a non-numeric name.
Amandas Setup utility provides a list of PBXs. When you select your first telephone 
switching system, information about that switch’s known dial codes, integration pat-
terns, and so forth is automatically copied to 1001.PBX. When you select the sec-
ond, information bout that switch is copied to 2001.PBX.
Then you modify those files to suit your needs. 
If you run Setup or Diag to discover tone patterns, the patterns are stored in 
1001.TON and 2001.TON respectively. 
See also pbx in the Per Port section.
The defaults (which do not start with the word set) appear in install.cfg as: 
PBX 1 1001
play_fromWhen playing your messages, this option controls whether Amanda identifies the 
Amanda user who sent (or forwarded) each message. 
True or False. The default is False.
When True, Amanda indicates who sent an internal message before she plays the 
message. She plays the name and extension recording for the sender (if it exists). She 
says the mailbox number (for example, mailbox 1-4-7) when there is no recording. 
When False, Amanda only plays the message.
The default appears in install.cfg as:
set play_from false
General Options (Continued)
Configuration OptionDescription 
						

							206 Installing [email protected]/DOS
play_new_firstDetermines what message is played next when the user has logged on to his mailbox 
to play messages.
True or False. The default is False.
When True, pressing 1 plays the next new message and pressing 75 plays the mes-
sages in order, regardless of whether they have been heard.
When False, pressing 1 plays the messages in order and pressing 75 plays the next 
new message.
See also urgent_to_front which affects the order of the mailbox’s message.
The default appears in install.cfg as:
set play_new_first true
play_skipThe number of seconds to rewind or skip forward during message playback when a 
* (rewind) or # (skip forward) is pressed. 
The range is from 1 to 99. The default is 5. 
The default appears in install.cfg as: 
set play_skip 5
please_holdControls the use of the “Please hold” prompt.
True or False. The default is True.
When True, Amanda says “Please hold while I try that extension” before transfer-
ring a caller. 
When False, Amanda says nothing and immediately puts the caller on transfer hold.
The default appears in install.cfg as:
set please_hold true
product_activation_
keyA number you receive from your Amanda Company sales representative to 
activate your system. If one or more of your voice boards were not pur-
chased from The Amanda Company, you must also set activation_key. See 
“activation_key” on page 183.
If you change the first board in your system, you need another product ac-
tivation key because the key is based on the serial number for the first 
Amanda Company board.
The default is 0, which means there is no product activation key.
The default appears in install.cfg as:
set product_activation_key 0
General Options (Continued)
Configuration OptionDescription