Amanda Work Group Manual

							Chapter 13: Configuration Reference 201
gain_loudControls the volume of the custom busy message.
Number. The range is from -8 to 8 and the default is 0.
The default appears in install.cfg as:
set gain_loud 0
gain_normThe initial volume for all ports and the playback volume when the system answers the 
telephone.
Number. The range is from -8 to 8 and the default is 0.
The default appears in install.cfg as:
set gain_norm 0
guest_defaultsThe mailbox to use as a template when creating a new guest mailbox. 
The default is 996, but you can use any valid mailbox. -1 means no mailbox has been 
assigned. 
See also defaults_box which explains what fields are copied.
The default appears in install.cfg as:
set guest_defaults 996
guest_minThe starting mailbox for guest mailboxes. If this value is 90000, the first guest mailbox 
is 90000. The second is 90001, and so forth. 
See also guest_max. Guest_max must be larger than guest_min.
Any valid mailbox. The default is 90000.
The default appears in install.cfg as:
set guest_min 90000
guest_maxThe last mailbox for guest mailboxes. If this value is 90199, the highest possible number 
for a guest mailbox is 90199. Along with the guest_min, you limit the number of guest 
mailboxes that Amanda can create. Guest_max must be larger than guest_min.
A valid mailbox. The default is 90199.
The default appears in install.cfg as:
set guest_max 90199
hold_musicDetermines what music is played while a caller is on hold. You can select from 
Bluegrass, Country1, Country2, Jazz, Jennifer2 (a jazz composition by an eight-year-old 
named Jennifer), Rock1, Rock2, and Traditional.
The default, Traditional is stored in the hold.vox file, which you can overwrite with a 
music file of your own. The Amanda installation program install a hold.vox file only if 
one does not already exist. This prevents Amanda from overwriting your music file.
The default appears in install.cfg as:
set hold_music Traditional
id_calleeDetermines whether the “please hold” prompt includes the name and extension record-
ing for the person being called.
True of False. The default is False.
When True, Amanda says, “Please hold for name_ext_recording.”
When False, Amanda says, “Please hold while I try that extension.”
The default appears in install.cfg as:
set id_callee false
Global Settings (Continued)
ParameterDescription 
						

							202 Installing [email protected]/Windows
immediate_play_msgIf the user has any messages at the time he or she logs on, this parameter can take that 
user directly to the menu from which messages can be played. 
True of False. The default is False.
When True, the user goes to immediately to the play messages menu. The user can press 
9 to go to the main menu.
When False, the user goes immediately to the main menu.
The default appears in install.cfg as:
set immediate_play_msg false
integration_greetingDetermines what greeting plays for integrated calls that have both rrr and sss (or rrrr and 
ssss) fields set. (The r’s indicate the number of digits in the extension of the user who 
was called but did not answer. The s’s indicate the number of digits in the extension of 
the user who made the call. See “Using Character Codes” on page 41 for more informa-
tion.)
True or False. The default is True.
When True, Amanda plays the RNA greeting for the mailbox identified by rrr.
When False, Amanda plays the system greeting.
In either case, a message is taken for rrr from sss.
The default appears in install.cfg as:
set integration_greeting true
lcoffThe minimum necessary duration of loop current off before the voice board driver rec-
ognizes that the loop current is off. Corresponds to the Brooktrout global parameter 
LcOff.
Number of hundredths of seconds (from 1 to 6553) or the number -1 or 0. For example 
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 parameter 
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 parameter is disabled and no events are ignored.
The default appears in install.cfg as:
set lcvalid 0
Global Settings (Continued)
ParameterDescription 
						

							Chapter 13: Configuration Reference 203
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 parameter 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 information, 
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_portString containing the name of the printer attached to Amanda, for example, 
\\elisea\hp4. The printer must be configured on the Amanda computer to output text 
by default and to be spooled. To set these parameters:
Select Start⇒Settings⇒Printers. 
Right-click the printer and select Properties from the pop-up menu.
Select the General tab.
Click Print Processor.
Make sure that TEXT is the selected Default Datatype.
Select the Scheduling tab.
Select the Spool Print Documents So Program Finishes Printing Faster option button.
Click OK to save these settings.
The default is the empty string, which means that no printer has been specified.
If you use a non-existing printer, reports aren’t printed.
See also auto_report and auto_report_time.
The default appears in install.cfg as:
set lpt_port 
Global Settings (Continued)
ParameterDescription 
						

							204 Installing [email protected]/Windows
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, in-
stead of waiting for a timeout or the # terminator.
The default is 8, the largest number allowed in [email protected]/Windows.
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 switch-
ing system initialization code.
The range is from 1 to the number of ports defined for Amanda. The default is 2.
The PBX file parameter 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 parameter 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 parameter 
to 3 to ensure that Amanda does not try to use the fourth port.
The default is 72. The range is 1-72. 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 72
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.
See also reask_sac.
The default appears in install.cfg as:
set max_prompt 2
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 mes-
sages 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 0, which uses the voice board’s setting for 
its parameter LSG_MIN_OFF, which defaults to 504 milliseconds (about a half second). 
The range is 1-655.
The default appears in install.cfg as:
set minoff 0
Global Settings (Continued)
ParameterDescription 
						

							Chapter 13: Configuration Reference 205
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 Den-
mark or Holland and 3 elsewhere). Otherwise, the range is 1-655.
The default appears in install.cfg as:
set minring 0
modified_call_
screeningWhen a mailbox has both call screening and called party identification on, this parameter 
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 telephone 
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 unsupervised 
(blind) transfers. These transfers have an H in the Extension field (for example, 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 record-
ing. 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 current greet-
ing.
N
OTE:If a user wants Amanda to announce only for the caller’s name and company, 
the Identify Called Party check box should be cleared in Amanda Administra-
tor.
The default appears in install.cfg as:
set modified_call_screening true
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 
Global Settings (Continued)
ParameterDescription 
						

							206 Installing [email protected]/Windows
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 exception of the 
special mailbox 999, which can connect multiple times. When 3, any mailbox can con-
nect multiple times. 
The default appears in install.cfg as:
set multiple_clients 3
n_aniThe number of Automatic Number Identification (ANI) digits to be read by Amanda be-
tween the first and second wink in a 2-wink T1 environment. 
The default is 0. The range is 0-255.
In a 2-wink T1 environment, Amanda may receive more digits than the Brooktrout buff-
er can hold. So Amanda reads up to n_ani digits between the first and second winks and 
starts processing them as part of the regular inband integration. After the second wink, 
Amanda reads the remaining digits.
The default appears in install.cfg as:
set n_ani 0
n_clientsAlong with client_activation_key, controls the number of client connections (logons) 
that can simultaneously connect to the Amanda voice server. This is normally set auto-
matically when the client connections are installed into the server. Do not edit this pa-
rameter.
The default is 0, which means 1 client. The range is from 0 to 2000.
The default appears in install.cfg as:
set n_clients 0
nam_maxlenThe maximum number of seconds to allow for recording a mailbox’s name and exten-
sion. Amanda plays the name and extension recording to provide callers with informa-
tion 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
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, Amanda 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 created 
list of mailboxes.
The default appears in install.cfg as:
set new_send true
Global Settings (Continued)
ParameterDescription 
						

							Chapter 13: Configuration Reference 207
non_relay_okDetermines the result of pressing # during a greeting.
True or False. The default is False.
When True, for any mailbox that does not have relay paging, pressing # (as well as ##) 
ends a greeting and goes directly to the beep for leaving a message. If the mailbox has 
relay paging, # invokes the relay and only ## ends the greeting.
When False, only ## ends the greeting, regardless of whether the mailbox has relay pag-
ing.
The default appears in install.cfg as:
set non_relay_ok false
notify_restrictionUsed to indicate what ports are in or not in the notification set.
Use True or False followed by a port number. False is the default.
When True, the specified port is in the set of notification ports. 
When False, the specified port is not in the set of notification ports.
You must put only one port in the notification set 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, with additional ports in the set, a message light might come on and stay on. 
If no ports are in the notification set, Amanda puts all ports in the set automatically. 
The default appears in install.cfg as: 
set notify_restriction false 
n
where n is a port number. The n is optional; when n is not used, the set of notification 
ports includes all ports, regardless of the use of True or False.
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
Global Settings (Continued)
ParameterDescription 
						

							208 Installing [email protected]/Windows
passwordSets the Amanda password. The password is case-sensitive, so uppercase letters are dif-
ferent from lowercase letters. That means that AMandA, Amanda, and amanda all rep-
resent 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 oper-
ate and shut down Amanda.
The default appears in install.cfg as:
set password AMandA
PBXThis parameter is described here in case you decide to change it by editing install.cfg. 
(However, setting this parameter is not recommended.) The PBX parameter (not to be 
confused with the pbx parameter) does not appear in the General Configuration section 
of the Setup utility because Setup makes changes to this parameter automatically. This 
parameter 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 parameter, 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 second, 
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 parameter 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 the system plays the 
message. Amanda plays the name and extension recording for the sender (if it exists). 
Amanda says the mailbox number (for example, mailbox 1-4-7) when there is no record-
ing. 
When False, Amanda only plays the message.
The default appears in install.cfg as:
set play_from false
Global Settings (Continued)
ParameterDescription 
						

							Chapter 13: Configuration Reference 209
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 True.
When True, pressing 1 plays the next new message and pressing 75 plays the messages 
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 auto_wrap.
The default appears in install.cfg as:
set play_new_first false
play_skipThe number of seconds to rewind or skip forward during message playback when a * (re-
wind) 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 transferring 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
please_hold2Controls the use of the second “Please hold” prompt.
True or False. The default is True.
The second “Please hold” prompt is slightly different from the first “Please hold” prompt 
to avoid monotony (as the caller has probably already heard the first prompt). To use or 
suppress it requires a second parameter.
When True, Amanda says “Your call is very important. Please continue to hold.” 
When False, Amanda says nothing.
The default appears in install.cfg as:
set please_hold2 true
product_activation_keyA number you receive from an Amanda Company sales representative to activate your 
system. If one or more of your voice boards were not purchased from The Amanda Com-
pany, you must also set activation_key. See “activation_key” on page 189.
If you change the first board in your system, you need another product activation 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
Global Settings (Continued)
ParameterDescription 
						

							210 Installing [email protected]/Windows
prompt_fileSpecifies the language that Amanda uses when a call first comes in on a given port.
ENGLISH or SPANISH. The default is ENGLISH.
You can change the prompt file for that port “on the fly” using the L() command from 
the Token Programming Language. Amanda can also change the language prompts for 
that port based on the DTMF sent by the telephone switching system or the central of-
fice. 
The ENGLISH.IDX file contains the English prompts. SPANISH.IDX is also available. 
Please contact your Amanda Marketing Partner, Solution Provider, or sales representa-
tive for more information and pricing.
The default appears in install.cfg as:
set prompt_file ENGLISH
prompt_speedControls the speed of the prompts. The range is from 50, which represents 50% or half 
the speed, to 200, which represent 200% or twice the speed. The default is 100, which is 
the normal speed.
Vantage-based voice boards can correct the pitch of the sound. With other boards, the 
pitch will become lower or higher as you slow down or speed up the sound.
The default appears in install.cfg as:
set prompt_speed 100
purgeControls how long messages that have been heard are stored before they are purged. 
Number of days. The range is from 0 to 99. The default is 0. 
If 0, no messages are purged. 
Otherwise, messages that have been heard are purged after the specified number of days. 
When users log in, Amanda tells them how many messages will be deleted when they 
exit. This number is the number of heard messages in excess of the number that can be 
stored.
N
OTE:Once a message is purged, there is no way to retrieve it.
The default appears in install.cfg as:
set purge 0
range1
range2
range3
range4If you have a range key (for example range1_key for range1 or range2_key for range2), 
you can activate 10000 mailboxes. Ranges and range keys are used for third-party appli-
cations that program a range of mailboxes to perform certain functions using the Token 
Programming Language. For more information, contact an Amanda Company sales rep-
resentative.
You set this parameter to the first number in the mailbox range. This number must be a 
multiple of 10000. 
The default is 10000 for range1, 20000 for range2, 30000 for range3, and 40000 for 
range4.
See also range1_key, range2_key, range3_key, and range4_key.
The defaults appear in install.cfg as:
set range1 10000
set range2 20000
set range3 30000
set range4 40000
Global Settings (Continued)
ParameterDescription