Amanda Work Group Administration Guide

							Appendix A: Setup Sheets103
    Setup Sheets
Mailbox Settings
Chain examples:
999 performs a hang-up;
991 returns to Instructions
Mail-
boxExten-
sion
Store 
Mes-
sages
Yes/NoDo Not 
Disturb
On/OffCall 
Screen-
ing
Yes/No
First NameLast NameRNA 
ChainBusy 
ChainDone 
Chain
—Master Copy—
      Make copies of this sheet prior to filling it out. 
						

							104 Administering [email protected]/Windows
    Setup Sheets
Notification Records
System actions to notify users of calls or messages in addition to ringing their extensions.
N
OTE:What do you dial to get an outside line? ____________
NameMailbox
(Mail-
box)Notify Method
How will the user be notified?
Voice, Message Lights, Pager, 
Relay, etc.
Notification Number 
(Variable)
Number or instructions 
for notification
(Pager, Extension, etc.)
Mary W.130Pager: 9, %V W(3,P)-% U#18005551212
—Master Copy—
      Make copies of this sheet prior to filling it out. 
						

							Appendix B:
Running Amanda from DOS
Starting Amanda from DOS
You can start Amanda from a DOS box—although you may never need to.
Important Note:You can run Amanda as either a service or an application in a 
DOS window. However, before starting Amanda in a DOS win-
dow, make sure that Amanda is not running as a service.
To start Amanda:
1. Open a DOS box. 
2. Change to the Amanda directory (CD C:\AMANDA).
3. Type AMANDA then press Enter.
Next Amanda displays:
Do you want to run [email protected]/Windows (Y/N)?
4. Press Y for Yes to start Amanda. If you do not make a selection within 30 seconds, 
Amanda starts automatically. This allows for unattended operation.
You see:
[email protected]/Windows is now up and running.
Type s to begin shutdown.
N
OTE:At step 3, press N to access system files or perform system tests with 
The Amanda Company representative. After performing those oper-
ations (or if you press N accidentally), restart Amanda by typing 
AMANDA at the DOS prompt.
During start up, if Amanda cannot load the files that store the dial 
codes, tone patterns, and integration patterns for your telephone 
switching system, the system displays a panic message and immedi-
ately shuts down. For Brooktrout voice boards, these are PBX and 
TON files.
N
OTE:You can type any of the following (then press Enter):
s To shut Amanda down
t To display a trace of Amanda’s activities
o To stop the trace to screen
p To display a list of active Amanda telephone ports
w To display a list of logged-on users 
						

							106 Administering [email protected]/Windows
k To disconnect a user. (Type in the name of the user when 
prompted for it.)
Using Command-line Options
Amanda can be run with a variety of command-line options. The brackets [  ] indicate 
when n is optional. Do not use the brackets in the command-line option. The value n is 
italicized because you must replace it with a number if you use it.
To change the command-line options, you can do either of the following:
 Alter the AMANDA.BAT file that runs Amanda. It is found in the root directory 
(C:). Use JOVE or another editor to change the line that starts with the name of 
Amanda’s executable, RAMANDA.
 Simply type the options after AMANDA as you start Amanda from the DOS 
prompt or with the Run command. (Your options are added to those already ap-
pearing on the RAMANDA line in the AMANDA.BAT file. If an option is used 
more than once, its last form is the one that goes into effect.)
Shutting Amanda Down in DOS
Amanda should always be shut down—not just powered off. You can shut down Amanda 
manually from the computer on which the system is running. This section explains how to 
do a manual shutdown. For information about automatic shutdowns, see Installing 
[email protected]/Windows.
To shut down Amanda:
1. Press s.
The password dialog box appears.
2. Type in the password. (The default is AMandA with only the first two and the last let-
ter capitalized.)
3. Press Enter.
4. Press Y (to confirm the shutdown).
5. Press Y again (to reconfirm).
6. After the DOS prompt C:\AMANDA> appears, wait 30 seconds before turning off the 
power.
/IRuns Amanda in what is called “demonstration mode.” Amanda does 
not answer calls, but you can change mailbox settings, notification 
records, and so forth.
/T[n]Causes Amanda to trace the activity on all ports, storing that informa-
tion in C:\AMANDA\TRACE.OUT. Specifying n causes Amanda to 
write to disk after every n lines. (By default, Amanda writes to the 
trace file every 1024 characters.)
/S[n]Limits the size of the trace file to the last n kilobytes of information.
/PnRestricts trace information to port n. Use two digits, such as 01 or 12, 
to indicate the port. 
						

							Appendix C:
Glossary
Telephony terms, such as station side, CO, single-line, hunt group, pilot number, pickup group, 
coverage path, hookflash, call forward ring-no-answer, call forward busy, DTMF, and tone patterns.
RJ-XXRegistered Jacks. Telephone and data plugs that are registered with the 
Federal Communications Commission (FCC).
RJ-11Telephone jack (or plug) commonly used to connect telephones, mo-
dems, and fax machines. The red and green pair carry the conversation 
for one line. The black and white pair might light buttons, send sig-
nals, or go unused.
RJ-14Telephone jack (or plug) commonly used to connect telephones, mo-
dems, and fax machines. The red and green pair carry the conversation 
for one line. The black and yellow pair carry the conversation for the 
second line.
class of serviceA grouping of privileges and features assigned to a telephone in a sys-
tem. Each mailbox in an Amanda system can be given all or any subset 
of the available privileges and features. There are no classes of ser-
vice.
activation keyAn integer supplied by the The Amanda Company sales staff to acti-
vate Brooktrout boards purchased from a source other than The 
Amanda Company. A per-port activation fee is charged when this key 
is supplied.
alphanumeric characterA letter from the alphabet (A–Z, a–z), a space, or a digit (0–9).
analog telephoneSingle line telephone or 2500 set (as opposed to digital), the type of 
telephone most often seen in residential units. In a commercial setting, 
analog phones must be connected to analog (single line) ports (jacks) 
which can be limited or unavailable. All telephone ports must be con-
nected to analog (single line) ports off the telephone switching system.
ANIAutomatic Number Identification T1 line
ASCII American Standard Code for Information Interchange—a standard 
used by the computer industry to encode all characters (alphabetic, nu-
meric, etc.) as integers. This code represents 256 characters as integers 
0 through 255. For example, A is encoded as 65 and a is encoded as 97.
audiotextThe ability to play information (instructions) to the caller such as di-
rections to the office or the instructions recorded in mailbox 991. In 
Amanda, this is done by having the Do Not Disturb field set to ON.
automated attendantA computer loaded with software (such as Amanda) capable of an-
swering incoming lines and transferring calls to extensions based on 
DTMF entered by the caller. 
						

							108 Administering [email protected]/Windows
back-door attendantAn automated attendant answering specific incoming CO lines dedi-
cated to calls from those callers who do not wish to go through the live 
attendant (receptionist or operator).
blind transfer (unsupervised 
transfer)The execution of an H token (to accomplish a hangup) after dialing an 
extension. This, in effect, releases the call to the extension and is usu-
ally done to make the telephone port available for the next call more 
quickly. (Also, see supervised call transfer.)
Do not use Call Screening with an unsupervised transfer. If you do, the 
caller is screened, but the user never hears that recording.
cadenceA repeating cycle of ON and OFF tones such as ring, busy, fast busy.
call accountingAlso called SMDR. A system used to record information about tele-
phone calls, organize that information, and create reports. The infor-
mation gathered usually includes what extension the call is coming 
from, what circuit is used for the call, when the call started, how long 
it lasted, and the purpose of the call (usually what client or project 
should be billed). Requires a computer, a disk for storing data, and 
some software set up to monitor the telephone calls made. A serial port 
must be dedicated to it.
Caller IDAutomatically identifies the caller Trunk line.
case-sensitiveThe act of differentiating between lowercase (a–z) and uppercase (A–
Z) characters. Amanda uses case-sensitive passwords. AMANDA, 
Amanda, AMandA, or amanda are all different passwords. On the oth-
er hand, if you type these words at the DOS prompt, DOS treats them 
as the same command. 
Channel (port)Amanda software supports systems as small as 2 channels and as large 
as 24 channels.
characterA single symbol including letters from the alphabet, digits 0–9, or spe-
cial ones. For example: ! @ # $ % ^ & * ( ) - + < > [ ] { } \ / ? :  | ~ ` _ ,
clientA Windows based program developed for communicating with 
Amanda. Amanda Administrator, Amanda Monitor, Amanda Dialer, 
and Amanda Fax have been written for Windows for Workgroups 
Version 3.11, but are also compatible with Windows 95 and Windows 
NT. Amanda Unified Messenger and Amanda Call Control have been 
written for Windows 95 and Windows NT.
Client ConnectionAn active communication link from one of the clients to Amanda.
Client Connection Bank 
(CCB)A device, which contains a number of Client Connections, that is at-
tached to the back of Amanda for the purpose of upgrading the number 
of Client Connections allowed by that server.
c-like escape sequenceAny sequence of characters within a string which starts with a \. This 
refers to the C programming language developed at Bell Labs.
CO Telephone Company Central Office
componentEvery message contains one or more components. Components “de-
fine” a message. For example, if a message is forwarded from another 
mailbox with a Message Prefix attached, that message contains two 
components. Similarly, if that message is then forwarded to another 
mailbox with another Message Prefix attached, that message contains 
three components. 
						

							Appendix C: Glossary109
composeTo build a message that consists of components.
data corruptionWhen the contents of some memory location or portions of a file re-
siding on a disk or diskette is damaged and lost. This can occur due to 
power fluctuations, faulty hardware such as motherboard or memory 
chips, or software bugs.
dB levelDecibel level. Used to measure the volume of sound or noise.
DBF fileA file which is in dBase format. Amanda tokens can work with dBase 
format as well as ASCII files. A dBase format file must have a DBF 
extension if used with Amanda tokens.
dead/phantom callThe situation where the outside caller hangs up before the extension is 
answered by the user. This might result in the user hearing a fast busy 
(reorder tone) or just silence, depending on the telephone switching 
system and the CO.
dedicated notificationWhen the first port of Amanda is set aside for notification only. It is 
displayed as 1/A in Amanda Monitor and the port description is dis-
played as Notify.
The extension connected to port 1 of Amanda must have outside ac-
cess so that pager notification can be successful. You must make sure 
that no incoming calls are routed to port 1 and instead port 2 is desig-
nated as the first answer port. This is useful in eliminating notify col-
lisions (glare condition). To achieve a dedicated notify, set the 
n_ochan parameter in the System Configuration Options file to 1 in-
stead of 0.
default valuesThe values of parameters, variables, and user settings in Amanda 
when the system is first installed. The installer, the system administra-
tor, or the user can change the default values using the keyboard (or 
DTMF from the telephone).
defaults boxMailbox 997 is set up with reasonable default values for each Mailbox 
field. When creating a new mailbox, Amanda accesses the defaults 
box for basic mailbox settings. If you want to change the defaults, 
modify mailbox 997 and Save.
dial codesA set of codes that enable Amanda and the telephone switching system 
to communicate. These are set using Setup option 1 or by editing the 
ASCII file C:\AMANDA\PBX.DB\1001.PBX.
direct callDialing Amanda internally by calling one of her ports from an exten-
sion within the telephone switching system.
direct message codeA mailbox (usually mailbox 998) which functions as a code to skip the 
transfer to a user extension and go directly to the current greeting for 
that user. For example, entering 998#185# causes the caller to hear the 
current greeting for mailbox 185. The caller can then press # twice to 
skip the greeting and go directly to the recording mode. Additionally, 
if you set the short_direct_send parameter in the System Configura-
tion Options to true (its default is false) then using the direct message 
code mailbox causes the caller to hear the Name/Extension recording 
instead of the current greeting.
direct message mailboxA mailbox that allows you to record a message for another mailbox 
without having to execute the Extension field and/or hear the mail-
box’s greeting. This is particularly useful for an operator transferring 
callers directly to a user’s voice mail. 
						

							110 Administering [email protected]/Windows
disconnect (hangup) super-
visionThe ability of the telephone switching system to inform Amanda that 
a hangup has occurred on the line. This is normally accomplished by 
the voice board driver, monitoring the loop current and informing 
Amanda of loop current OFF or loop current DROP events. This is be-
cause the default value for the hangup_supervision parameter in the 
System Configuration Options is true. If this parameter is set to false, 
Amanda ignores these events.
disk notificationA type of notification used to warn the system administrator (mailbox 
999) that the hard disk space has fallen below a predefined threshold. 
This is set in Setup, Option 4, set diskwarn xx. The default is 20, mean-
ing the Disk notify activates when free disk space is less than 20 per-
cent of total disk space.
Done ChainAfter Amanda is finished processing a mailbox, the system continues 
processing the call by going to the mailbox specified in the Done 
Chain. If this field is blank, Amanda uses the Done Chain of the Com-
pany Greeting, or starting greeting mailbox (generally 990). Usually, 
the Done Chain of 990 is set to 991. Therefore, the default Done Chain 
is usually mailbox 991 (The Caller Instructions).
DTMFDual Tone Multi Frequency (Touch Tone) tones generated by most 
phones when you dial a telephone number. However, the fact that a 
telephone has a dial pad with 12 keys (0–9,*,#), does not guarantee 
that it can generate DTMF.
edit blockA solid colored, or reversed video block seen on the screen (selecting 
the field or the line you are editing) within Amanda or the Setup util-
ity.
employee directory mailboxIf you designate a mailbox using the box_idx configuration option, 
Amanda builds an employee directory which lists all the users based 
on the contents of the Directory Name 1 and Directory Name 2 fields. 
This allows callers to use their telephones to spell the names of the us-
ers they want to reach. Digits 7 and 9 should be used for letters Q and 
Z respectively.
empty stringA string containing no characters at all. To represent an empty string 
you can use  when using tokens.
execution errorA fault which can cause a program to crash and shutdown or produce 
an incorrect result. The error might be due to a logical error in the soft-
ware, faulty hardware, or corruption of memory location caused by 
other programs.
exit code or errorlevelBefore the completion of a program (e.g., RAMANDA.EXE), an in-
teger code can be generated (default is 0) by that program. This code 
can be used by another program or the batch file (e.g., AMAN-
DA.BAT) which started that program in order to determine what to do 
next. This is used by the Auto Shutdown mechanism of Amanda. 
When an Auto Shutdown occurs (by default every Tuesday at 1:30 
AM), RAMANDA.EXE exits (completes execution) with errorlevel 3 
which when passed on to AMANDA.BAT, causes control to be trans-
ferred to the section labeled: AUTO
flash timeThe amount of time Amanda must remain on-hook while performing 
a hookflash usually set to 55 (0.55 seconds).
flash-hookSee hookflash. 
						

							Appendix C: Glossary111
floppy disk driveA storage device, typically referred to as the A or B drive, capable of 
reading and writing information to diskettes (3.5-inch or 5.25-inch). 
Amanda and its associated utilities are distributed on 3.5-inch 1.44 
MB diskettes only. Therefore, the PC designated for Amanda must 
have at least one 3.5-inch 1.44 MB floppy disk drive (A or B).
general protection faultA fault that can cause a program to crash or produce an incorrect re-
sult. The error might be due to a logical error in the software, faulty 
hardware, or corruption of memory location caused by other pro-
grams.
glareThe collisions between incoming calls and notifications. For example, 
a port might try to execute a notification record and accept an incom-
ing call simultaneously.
hard drive/hard diskA long-term storage device, typically referred to as the C drive, on 
which Amanda is installed. The Amanda Company recommends us-
ing IDE hard drives with a 12ms access time or faster to insure optimal 
processing of calls. Consider large capacity hard disks if a high vol-
ume of outgoing and incoming messages is expected. A 540 MB hard 
disk is estimated to provide 33 hours of messages.
hookflashA momentary on-hook condition which lasts anywhere from 0.25 sec-
onds to 0.85 seconds (usually set to 0.55 seconds.) which is normally 
required to put a caller on hold before Amanda can transfer to an ex-
tension. This is also used when Amanda determines a Ring No An-
swer or Busy extension. A second hookflash (or hook-flash) makes 
Amanda able to get the caller back and play the current greeting or 
Busy message for that user.
inband signalingThe telephone switching system’s ability to send DTMF tones to a 
telephone port as soon as it answers (goes off-hook), informing Aman-
da of the nature of the call as well as the extension or CO line which 
is calling. This helps Amanda make the correct decision in processing 
the call (i.e., play a Busy message, play the current greeting, enter the 
log on mode, or play the company greeting by processing mailbox 
990). This is useful in conjunction with a blind transfer when the call 
volume is very heavy and you wish to make telephone ports available 
for handling the next call as quickly as possible.
informational mailboxA mailbox which usually does not accept messages from callers; in-
stead, its greeting is played to callers to provide them with various 
pieces of information. To accomplish this in Amanda, the Do Not Dis-
turb field must be ON.
integerA whole number with no decimal point or fractions. For example, 24,-
32768,1,8,-30,32767,-1 are integers.
Integration HelperA program accessed by selecting option 3 within the Setup utility and 
pressing the F1 key. This program can assist an installer in determin-
ing the DTMF coming from a telephone switching system using in-
band signaling. An alternative is using an Amanda trace file (either 
C:\AMANDA\TRACE.OUT or C:\AMANDA\SCREEN.OUT).
integration timeoutThe pause after Amanda goes off-hook to allow for the arrival of 
DTMF sent by the telephone switching system using inband signaling. 
It also serves as an inter-digit timer after the arrival of the first digit. 
You can set this timer by modifying the first line of the screen access-
ed by selecting option 3 of Setup. The default is 0 which means inband 
signaling is disabled. Use 10 to specify 1.0 second, 15 for 1.5 seconds 
and so on. 
						

							112 Administering [email protected]/Windows
Interactive Voice Response 
(IVR)A way in which callers can obtain information from a computer data-
base through the use of DTMF. This is common in the banking indus-
try. For example, if you want to know your account balance, you enter 
your account number and your personal identification number when 
prompted. The system you are communicating with confirms your ac-
count number and security code and accesses a database to retrieve 
your account balance.
jumper pinsPins found on the voice board used to set the correct address for 
boards.
LANLocal Area Network. A short distance data communications network 
used to link computers and peripheral devices under some form of 
standard control. 
LANALocal Area Network Adapter. A PC-compatible circuit card that pro-
vides the PC-to-LAN hardware connection.
LANA numberA number that is assigned to the logical network with which Amanda 
communicates when using the NetBIOS over NetBEUI protocol.
List CommentA comment describing a mailing list that is recorded by the user who 
creates the list. The comment should help you distinguish one list from 
another and remember whose extensions are on the list.
LoginsThe total number of times the mailbox was accessed by a user by 
pressing the * key.
long pauseUsing , within a token string causes Amanda to pause for 2 seconds.
mailboxThe user options, messages, mailing lists, and other data identified by 
a mailbox.
menu barLists a program’s choices. It is found at the top of the screen of any 
Amanda screen or Windows application.
MFMulti-frequency. An inband address signaling method which uses ten 
decimal digits and five auxiliary signals are each represented by se-
lecting two frequencies and combining them into one sound.
monitored transferSame as supervised transfer.
NDISNetwork Driver Interface Specification. A device driver which pro-
vides hardware and protocol independence for network drivers.
NetBEUINetBIOS Extended User Interface. One of the network protocols 
available to Amanda.
NetBIOSNetwork Basic Input/Output System. A layer of software which links 
a network operating system with specific hardware. It allows applica-
tion programs to communicate with the network.
networkSee LAN
non-empty stringA string containing 1 or more characters.
notification templateA general notification action which can be used for any number of no-
tification records belonging to any number of mailboxes. For exam-
ple, message waiting light ON and message waiting light OFF 
notification actions should be saved as templates.