Amanda Work Group Installation Manual

							Chapter 6:
Running the Setup Utility
Running Setup
You must configure Amanda to work properly with your telephone 
switching system and to let Amanda know your customer’s voice mail and 
other preferences. The Amanda Company provides the Setup utility to make 
configuring Amanda easier. 
You run Setup to configure dial codes, tone patterns, DTMF integration 
patterns, and Amanda’s system configuration options.
To run Setup:
1. If Amanda is running, shut down the Amanda system.
a. Press Alt+S (if Amanda is running as a standalone) or s (if 
Amanda is running as a voice server).
b. Type in the password. (The default is AMandA with only the 
first two and the last letter capitalized.)
c. Press Enter.
d. Press Y (to confirm the shutdown).
e. Press Y again (to reconfirm).
2. Change to the AMANDA directory—unless you are there already. At 
the DOS prompt, type:
CD C:\AMANDA
Then press Enter. 
						

							50 Installing [email protected]/DOS
3. Now that the DOS prompt reads C:\AMANDA, type:
SETUP
Then press Enter.
The [email protected]/DOS Configuration Utility menu appears.
4. From this menu, you define the following for your telephone switching 
system and Amanda. Each is described in one of the next few chapters:
 Telephone System Dial Codes
 Telephone System Tone Patterns
 System Integration Patterns
 System Configuration Options
 System Configuration Options contains two sections: 
General ConfigurationDisplays dialog boxes that guide you through 
the options that are most often changed, wheth-
er they appear in the INSTALL.CFG file or the 
default template for mailboxes (normally mail-
box 997).
These dialog boxes are explained in “Chapter 
10: Configuring Amanda.”
Advanced ConfigurationAllows you to change any configuration setting 
in INSTALL.CFG. The options are divided 
into categories to make it easier to locate the 
options you need to change. The options are pa-
rameter lists. Each option is explained in 
“Chapter 18: Configuration Reference.” 
						

							Chapter 7:
Defining Dial Codes
Defining Dial Codes
To communicate with the telephone switching system, Amanda must know 
the switching system’s dial codes. Most Amanda systems are connected to 
only one switching system, but you can connect your system to two. 
By default, the 1001.PBX file is used to store dial codes. You can change 
this if you choose. However The Amanda Company has reserved the 
numeric names from 1002 to 2001, so do not use any number in that range as 
the name of your file.
As part of a new installation, the file 1001.PBX is created for you based on 
the Panasonic KX-T308/616/1232 telephone switching system. If you are 
upgrading your Amanda system, the file you used for dial codes in the past 
will be renamed to 1001 (and 2001 if two switches are used). Also, the Setup 
utility may not know what switching system your dial codes file is based on. 
The names of the switching systems appear in the .PBX files containing 
codes for these systems and are displayed by the Setup utility. Yours may be 
based on an older version of Amanda that did not have the switching system 
names in the files. If so, yours may be identified by Setup as “not defined.”
N
OTE:Instead of using Setup, you can edit your .PBX file in the 
C:\AMANDA\PBX.DB directory using the JOVE utility. 
See “Chapter 12: Utilities,” in Administering Aman-
[email protected]/DOS for information about JOVE. 
						

							52 Installing [email protected]/DOS
To define dial codes:
1. Run Setup as explained in “Running Setup” on page 49.
2. From the Configuration Utility menu, press 1 to select Telephone Sys-
tem Dial Codes.
The Telephone Switch Type screen lists 1001.PBX and 2001.PBX along 
with the names of the switching systems they are based on or identifies 
the switching system as not defined.
3. From the Telephone Switch Type screen, do one of the following:
 If the telephone switching system is the correct one (or if the tele-
phone switching system is the one you have used in the past—even 
though it is identified as not defined):
 Select the file to be edited then press Enter.
Setup displays the dial codes and their descriptions.
 If the telephone switching system is not the one listed:
a. Select one of the .PBX files.
b. Press F2 to display a list of switching systems.
c. Use the arrow keys to select the name of your system or the 
name of a system which has codes similar to yours then 
press Enter.
d. Press Enter again to display the dial codes and their descrip-
tions. 
						

							Chapter 7: Defining Dial Codes 53
4. To change any dial codes that do not apply to your system:
a. Use the following Dial Codes Table to understand each of the 
codes displayed on the screen.
b. Use the Up Arrow, Down Arrow, Tab, or Enter keys to select 
the code you want to change.
c. Type the new code over the current code (if there is one). 
(You can also use Backspace, Delete, spacebar, and the Right 
Arrow and Left Arrow keys to edit the code.)
d. When you are finished, press F10 to save your changes.
(To return to the Telephone System Dial Codes screen without sav-
ing your changes, press Esc.)
e. Repeat steps A through D for any other codes to be changed.
5. When you have finished defining the dial codes, press Esc to return to 
the Amanda Configuration Utility menu.
Dial Codes Table
Dial Code LabelDescription
What to dial to put the call-
er on transfer hold:The code Amanda dials to ask the telephone switching system to put the 
caller on transfer hold before she transfers a caller to an extension. 
Usually, this code is “F-” (a hookflash followed by a half-second pause). 
This may need to be changed to “F--” (a hookflash followed by a one-
second pause) or “F,” (a hookflash followed by a two-second pause) for 
telephone switching systems that are slow to provide a transfer dial tone 
after a hookflash. (Don’t use the quotation marks in the dial code.)
If tmo_dtwait is greater than 0, the number of dashes set for this option 
is irrelevant. Use the value 0 for tmo_dtwait for faster call processing. 
For more information about tmo_dtwait, see “What to dial to put the call-
er on transfer hold:” on page 53.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dl_dtwait option.  
						

							54 Installing [email protected]/DOS
What to dial when there is 
no transfer dial tone: The code Amanda dials to return to the caller if both of the following are 
true:
You configure Amanda to wait for a transfer dial tone before transferring 
a call to an extension
There is no transfer dial tone
In this case, Amanda treats the attempted transfer as though the exten-
sion was busy.
Some telephone switching systems use “F-”, others use “-”. (Don’t use 
the quotation marks in the dial code.)
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dl_ndtret option. 
What to dial to return to 
the caller after ring no an-
swer: During supervised transfers, if the extension rings the specified number 
of times but is not answered, Amanda dials this code to ask the telephone 
switching system to reconnect the caller to Amanda. (See the question-
naire in “Chapter 10: Configuring Amanda” for more information about 
configuring the number of rings.) 
Usually, this code is “F-”. (Don’t use the quotation marks in the dial 
code.)
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dl_rnaret option. 
What to dial to return to 
the caller after busy: During supervised transfers, Amanda dials this code to ask the telephone 
switching system to reconnect the caller to Amanda if the extension is 
busy. 
Usually, this code is “F-”. (Don’t use the quotation marks in the dial 
code.)
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dl_bsyret option. 
Dial Codes Table (Continued)
Dial Code LabelDescription 
						

							Chapter 7: Defining Dial Codes 55
What to dial after a call 
screening reject: The code Amanda dials to reconnect to the caller if all of the following 
are true:
Amanda is performing a supervised transfer
Call screening is ON
The user at the extension that was called rejects the caller
In this case, Amanda plays the mailbox’s current greeting.
Usually, this code is “F-”. (Don’t use the quotation marks in the dial 
code.)
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dl_hupret option. 
What to dial to connect a 
caller to an extension: During supervised transfers, Amanda dials this code to complete the call 
transfer after detecting an answer at the called extension. If call screen-
ing is ON, Amanda dials this code only after the user at the extension ac-
cepts the call.
Usually, this code is “H” (for Hang up). (Don’t use the quotation marks 
in the dial code.)
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dl_connect option. 
What to dial before the 
mailbox extension: If Amanda needs to dial something after dial tone detection, but before 
dialing the extension number, enter that code here. 
Usually this is left blank.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dl_prefix option. 
What to dial after the mail-
box extension: If Amanda needs to dial something after dialing the extension number, 
enter that code here. 
Don’t use an “H” for a blind transfer here because this setting is global. 
Sometimes you need “1-” to bypass the hands-free answer feature (voice 
announce) on some telephone systems. (Don’t use the quotation marks 
in the dial code.)
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dl_suffix option. 
Dial Codes Table (Continued)
Dial Code LabelDescription 
						

							56 Installing [email protected]/DOS
What to dial on each port 
after the system starts: If you want Amanda to dial some initialization codes when she first 
starts up, define those codes here. For example, you may want to remove 
call forwarding on the ports.
Usually this is left blank.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dl_init option. 
What to dial on each port 
before shutdown: If you want Amanda to dial certain codes when she shuts down, define 
those codes here. For example, enabling call forwarding on the ports lets 
a live operator take the calls when Amanda shuts down.
Usually this is left blank.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dl_stop option. 
What to dial when a port 
goes off-hook: If Amanda must dial some special codes as she goes off-hook to enable 
a special feature, define those special codes here. For example, you may 
enable special types of SMDI integration over a serial port.
Usually this is left blank.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dl_pickup option. 
What to dial to create or 
record a conference call:Controls how to do a conference call when the called party answers the 
telephone.
You provide the digits used to conference the caller, called party, and 
Amanda (for example, “*3”). (Don’t use the quotation marks in the dial 
code.) If your telephone switching system does not have this capability, 
leave it blank.
For example, if the Extension field for a mailbox contains 127KM, 
Amanda dials 127. When an answer is detected, Amanda dials the con-
ference dial code (such as “*3”) which conferences the caller, the called 
party, and Amanda. Instead of hanging up when she connects the two 
parties, Amanda records the conversation as a message in mailbox 127. 
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dl_conference option. 
Dial Codes Table (Continued)
Dial Code LabelDescription 
						

							Chapter 7: Defining Dial Codes 57
Number of seconds to wait 
for dial tone detection: This is the number of seconds Amanda waits for your telephone switch-
ing system to provide a continuous dial tone for one full second. If your 
system has few DTMF receivers or intercom paths for call transfers, one 
may not be immediately available for Amanda to transfer a call. In this 
case, this number should be greater than 0.
Use 0 when Amanda does not wait for a dial tone (as when the telephone 
switching system returns stutter dial tone or silence on a transfer). A 
good value is 4 (seconds) when she does wait for a dial tone. The range 
is 0–127.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the tmo_dtwait option. 
Number of 1/100 seconds 
to use for Flash time: Determines how long Amanda remains on-hook while performing a 
hookflash. The value is in hundredths of seconds.
The usual value is 55 (just over half a second).
When set too short, the hookflash does not happen; when set too long, it 
hangs up.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the flashtm option. 
Which DTMF tone to lis-
ten to for hangup detec-
tion: If your telephone switching system plays a specific DTMF tone or se-
quence of tones when a caller hangs up (to make hangup detection fast-
er), enter that DTMF digit here. 
If your telephone switching system has this capability, the code is usual-
ly the letter “d” which represents DTMF D. This may be a sequence of 
DTMF digits rather than a single DTMF digit. The maximum length is 
10 characters. If your system does not support this feature, leave it blank.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using 
Setup, this is the dt_hangup option. 
What to dial to turn on the 
message waiting indicator:If your telephone switching system has message waiting indicators, enter 
the code needed to turn the indicator on.
What to dial to turn off the 
message waiting indicator:If your telephone switching system has message waiting indicators, enter 
the code needed to turn the indicator off.
Dial Codes Table (Continued)
Dial Code LabelDescription 
						

							58 Installing [email protected]/DOS