Amanda @Work.Group/DOS Version 7.xx Installer's Manual

Hide thumbs Also See for Amanda@Work.Group/DOS Version 7.xx:
Table of Contents

Advertisement

Quick Links

Installing
Am
nd
@Work.Group/
A
A
DOS
Version 7.xx
Installer's Guide Edition 12/01/01

Advertisement

Table of Contents
loading

Summary of Contents for Amanda Amanda@Work.Group/DOS Version 7.xx

  • Page 1 Installing @Work.Group/ Version 7.xx Installer’s Guide Edition 12/01/01...
  • Page 2: Copyright And Trademark Notices

    90 days from the date the software is delivered. If a defect in the media should occur during this period, you may return the media to The Amanda Company and The Amanda Company will replace the media without charge.
  • Page 3: Fraudulent Usage Advisory

    Amanda software, is able to prevent such unauthorized usage. The Amanda software is likewise unable to prevent such uses as may constitute an invasion of privacy or other tort. THE AMANDA COMPANY...
  • Page 4: Conventions

    The name by which this manual refers to the Amanda@Work.Group/DOS system to make reading about the system easier. Because of the name Amanda, the system is also referred to as “she.” caller Someone who calls into Amanda. A caller of- ten obtains information, leaves a message for someone, and/or provides information.
  • Page 5 Depending on how you purchased our product or what voice boards you are installing, parts of this guide may not pertain to you. For example, if you purchased a turnkey solution comprised of Amanda preloaded onto a PC, you can skip all sections regarding the system requirements and the...
  • Page 6 Installing Amanda@Work.Group/DOS...
  • Page 7: Table Of Contents

    Introducing Amanda........
  • Page 8 Installing the MVIP Cable......... 33 Configuring Amanda to Use the ATI Board ......33 Chapter 4: Other Cards and Devices .
  • Page 9 Configuring Amanda ........
  • Page 10 Accessing Amanda Remotely........
  • Page 11 What to Do When… ..........238 Amanda Does Not Transfer the Call......238 Caller Doesn’t Hear the Busy Message or RNA Greeting .
  • Page 12 Installing Amanda@Work.Group/DOS...
  • Page 13: Introducing Amanda

    Chapter 1: Introducing Amanda Requirements At a minimum, the PC on which you install Amanda must have: • MS-DOS version 6.22 in the directory C:\DOS. • A 486SX processor running at a minimum of 25MHz. • A VGA card. •...
  • Page 14: Environmental Requirements

    An analog telephony interface using the Brooktrout RTNI-xATI board Some PCs are incompatible with Amanda. If you see the error “rdsp not located” or find that Amanda appears to come up but the boards do not answer, check your CONFIG.SYS file for the following line: X=ED00-EDFF This line indicates that your PC is NOT compatible with Amanda.
  • Page 15: General Uses

    Amanda is installed must be used only for Amanda. Depending on what lines from your PBX are connected to Amanda and when calls are sent to Amanda to be processed, Amanda can serve you or your customer in a variety of ways.
  • Page 16: Purpose Of This Guide

    24 hours a day). Information such as your address, available hours, directions to your offices, and so forth, might be better handled by Amanda. Amanda’s serial ports can access databases and other information stored in other computers, allowing Amanda to give callers information on account balances, train schedules, and so forth.
  • Page 17: Customer Service And Support

    Web Site: http://www.taa.com End User Support End user support covers the actual usage of Amanda through the telephone, such as picking up messages, sending messages, changing greetings, and using distribution lists. Registered Amanda sites receive free end user support for the life of their systems. Be sure to send in your registration card! System Administration Support System administration support covers the configuration of Amanda;...
  • Page 18: Installation Support

    Installing Amanda@Work.Group/DOS Installation Support Installation support covers the initial connection of Amanda to a telephone switching system as well as solutions to problems that occur when the system is reconfigured or Amanda is upgraded. The Amanda Company now offers installation support to any dealer who buys a turnkey system.
  • Page 19: Installing Rdsp/X32 Boards

    Installing RDSP/x32 Boards Installation Checklist Follow this checklist or use it to verify that you have completed all the necessary steps for connecting Amanda to the telephone switching system. Be sure to… Install properly addressed voice boards Install Amanda software without errors...
  • Page 20: Configuring Rdsp/X32 Voice Boards

    Installing Amanda@Work.Group/DOS Configuring RDSP/x32 Voice Boards Amanda recognizes each installed voice board by its unique address. The first voice board has address 300; the second, address 301; the third, address 302, etc. To set a voice board’s address, you must configure the pins on the voice board correctly using shorting jumpers.
  • Page 21 Chapter 2: Installing RDSP/x32 Boards The following table shows how to set the shorting jumpers for each possible voice board in Amanda. Leftmost Jumper Positions Rightmost Board Address Closed Closed Closed Closed Closed Closed Closed Closed Open Open Open Closed...
  • Page 22 Installing Amanda@Work.Group/DOS The next table show the jumper positions graphically. A Graphical View Board Address Jumper Positions Do not add or remove shorting jumpers while power is ap- AUTION plied to the board.
  • Page 23: Showjump Utility

    After making sure the address for the voice board is correct, you can install To install the voice board: If this is a new installation, go to step 2. Otherwise, shut down Amanda and turn off the computer: Press Alt+S (if Amanda is running as a standalone) or s (if Amanda is running as a voice server).
  • Page 24: Connecting Ports

    Connecting Ports You create a port by connecting a telephone line to a voice board. Amanda can support from 2 to 24 ports. On a Brooktrout voice board with two connectors, the top connector represents the first two ports and the bottom connector represents the second two ports for a total of four ports per board.
  • Page 25 Chapter 2: Installing RDSP/x32 Boards Ports are numbered consecutively from 1 to 24. Port 1 is connected to the lowest addressed voice board (usually address 300). Each connector on the voice board is linked to your telephone switching system by a standard 4- wire line cord to a standard RJ-14 modular jack which should represent two analog (single-line) extensions.
  • Page 26 Installing Amanda@Work.Group/DOS COM1 VGA Card Voice Ports Modem COM2 The above diagram shows the back of Amanda.
  • Page 27 Chapter 2: Installing RDSP/x32 Boards Voice Ports 1 & 2 Voice Ports 3 & 4 Telephone Phone Switch tline-R.cad The above diagram shows how the telephones, telephone switching system, and Amanda are connected.
  • Page 28 Installing Amanda@Work.Group/DOS...
  • Page 29: Installing Rdsp/Rtni Boards

    In addition, you must connect the RTNI board to the telephone network. Follow this checklist or use it to verify that you have completed all the necessary steps for connecting Amanda to the telephone switching system.
  • Page 30 Configure the IRQ Jumpers Configure the Line Interface Install the boards Install the MVIP cable Install Amanda software without errors Connect the line cords from the voice boards to the telephone switching system Test each voice board port for answering Run Setup to define dial codes 10.
  • Page 31: Requirements

    Chapter 3: Installing RDSP/RTNI Boards 11. Run Setup to obtain tone patterns 12. Run Setup to define telephone switching system integration patterns 13. Run Setup to define Amanda system configuration options Requirements Before installing the RDSP/x000 board, verify that the host system meets each of the following requirements: •...
  • Page 32 Installing Amanda@Work.Group/DOS The RDSP/x000 Board Jumper Block and Connector Information Table 1: Jumper Positions for Use with Amanda Label Type Description Jumper DSi MVIP Open Open Open Open Open Open Closed Open block stream Jumper DSo MVIP Open Open Open...
  • Page 33: Understanding Mvip Streams

    Chapter 3: Installing RDSP/RTNI Boards jumper. In the diagrams in this chapter, the blacked out pin positions represent closed positions. Installers often place shorting jumpers over only one pin when the position is Open. This does not connect the pins, but it does prevent losing jumpers.
  • Page 34: Configuring Mvip Streams

    (DSi0 through DSi7) and can transmit on one of the DSo streams (DSo0 through DSo7). Each RDSP/x000 board is factory-configured to use streams DSi6 and DSo6. The Amanda Company recommends that you keep these settings. The DSi stream jumper block consists of a pin position for each DSi stream.
  • Page 35: Configuring The Mvip Termination

    Chapter 3: Installing RDSP/RTNI Boards The settings should be as shown below: Only the second to last pin position should be closed with a shorting jumper. Do not add or remove shorting jumpers while power is AUTION applied to the board. Configuring the MVIP Termination Each RDSP/x000 can terminate the C2 MVIP and C4 MVIP bus signals.
  • Page 36 C4. If you look at the board with the bracket on your right, the pin position on the left corresponds to C4 and the pin position on the right corresponds to C2. The Amanda Company assumes that you are installing only one RDSP/x000 board and, therefore, that it should terminate both signals.
  • Page 37: Configuring The Base I/O Port

    I/O port conflict with another device. Each RDSP/x000 must use a base I/O port in the range 0000H through 3FFH. The Amanda Company assumes that you are installing only one RDSP board and recommends that you use base I/O port 300H.
  • Page 38: Configuring An Rtni-Xati Voice Board

    PCM prior to switching. This conversion is made by the board’s loop start module which links the MVIP bus and a trunk line. Amanda uses only the linking function and not the switching function of MVIP.
  • Page 39 Chapter 3: Installing RDSP/RTNI Boards Jumper Label Type Description Settings Jumpers EJ10 Jumper block Base I/O Address Open Open Closed Closed Closed Closed Open Closed Closed Closed Jumper block MVIP Termination Closed Jumper block MVIP Termination Closed Connectors Connector MVIP bus Connector Telephony Cable Closed means that two pins are covered/connected by the shorting jumper,...
  • Page 40: Configuring The Mvip Termination

    C4. The top pin position (labeled W1) corresponds to C4 and the next pin position (labeled W2) corresponds to C2. You should close both pin positions. The Amanda Company assumes that you are installing only one RTNI-xATI board along with an RDSP/x000 board.
  • Page 41: Configuring The Line Interface

    Amanda Company recommends that you use 308H. To set the base I/O port: Locate the base I/O port jumper block. It is labeled EJ10. For use with Amanda, set the jumpers as shown below. EJ10 Do not add or remove shorting jumpers while power is AUTION applied to the board.
  • Page 42: Physical Connections

    After you have installed the board (as explained in “Installing the Boards” on page 32), use the cable supplied with the RTNI-xATI board to connect the Amanda system to the telephone network. Connect the 62-pin connector to the RTNI-xATI board and the Amphenol 50-pin connector to a 66 Block.
  • Page 43: Showjump Utility

    T13: Channel 13 Tip-black/ green BAT-: Negative battery terminal-gray/ violet ShowJump Utility Brooktrout provides the ShowJump utility which also shows how to configure the jumpers on various types of Brooktrout boards. On Amanda, this utility is stored in the C:\PLATFORM directory.
  • Page 44: Installing The Boards

    Use the following procedure to install one or more RDSP/RTNI boards. To install the board: If this is a new installation, go to step 2. Otherwise, shut down Amanda and turn off the computer: Press Alt+S (if Amanda is running as a standalone) or s (if Amanda is running as a voice server).
  • Page 45: Installing The Mvip Cable

    Configuring Amanda to Use the ATI Board There are a couple of Amanda’s configuration options that must be set correctly when you are using an RTNI-xATI voice board. See “Running Setup” on page 49 for information about using the Setup utility to set or check these advanced configuration options.
  • Page 46 Installing Amanda@Work.Group/DOS Be aware that RTNI-xATI voice boards cannot detect rotary. If you use an RTNI-xATI voice board, you must leave the rotary configuration option set to false.
  • Page 47: Other Cards And Devices

    Other Cards and Devices Installing a LAN Card To use Amanda as a voice server, you must install a LAN card, also called a network interface card (NIC). The card must be NE2000 compatible. If you have any problems with the installation and you purchased the NIC from The Amanda Company, please contact Customer Service.
  • Page 48: Using A Ups

    The Amanda Company strongly recommends the installation of an uninterrupted power supply (UPS) with every Amanda system. It provides clean power to Amanda and keeps the probability of a computer lockup (and the resulting loss of data or even loss of the system) as low as possible.
  • Page 49 Amanda system or compared to the loss of confidence from callers and internal Amanda users. For more information about what causes power irregularities and what damage they can do to Amanda, call to be faxed Technical Note 10, “The Importance of a UPS.”...
  • Page 50 Installing Amanda@Work.Group/DOS...
  • Page 51: Installing Amanda Software

    “Chapter 2: Installing RDSP/x32 Boards” • “Chapter 3: Installing RDSP/RTNI Boards” If you are installing Amanda as a voice server, have your MS Workgroup Add-on for DOS disk at hand. To start the Amanda installation program: Insert the disk labeled “Amanda@Work.Group/DOS, Installation Disk 1 of 5”...
  • Page 52 Installing Amanda@Work.Group/DOS You see a screen similar to the following: Correct operation of an Amanda Call Processing system depends on accurate time and date settings in the computer. To assure correct operation, please verify these now. Here are the present time and date: Current time is 3:13:04.99p...
  • Page 53 Chapter 5: Installing Amanda Software Information similar to the following appears on the screen. This program installs or un-installs Amanda@Work.Group/DOS Version 7.xx Revision X on your computer system. You may press the [Esc] key at any time to stop the installation.
  • Page 54 Select the action that you want to be performed. Use the arrow keys to make a selection; then press Enter. Re-install Amanda@Work.Group/DOS Version 7.xx Revision X Un-install the existing Amanda@Work.Group/DOS 7.xx Revision X system Test configuration of this machine only Exit this installation program now UPDATE MENU Amanda@Work.Group/DOS Version 7.xx Revision X using RH-RDSP...
  • Page 55 I am not sure; stop so I can find out first Use the arrow keys to select the appropriate style of Brooktrout voice board then press Enter. The next screen asks whether you are installing Amanda as a standalone system or as a voice server.
  • Page 56 If you plan to use Amanda client software to configure Amanda and allow users to access messages from their computers as well as their telephones, you need to install Amanda as a voice server, select the sec- ond option “The LAN card is installed. Configure Voice Server system.”...
  • Page 57 Chapter 5: Installing Amanda Software Since this is a new installation, a new CONFIG.SYS file will be created; you do not need to take any action yourself. Press [Esc] to quit, any other key to continue ... Checking your computer for the proper components and conflicts .
  • Page 58 : Color Available disk space : 176295936 Press [Esc] to quit, any other key to continue ... Your original installation of Amanda@Work.Group/DOS 7.xx Revision X is nearly finished. The system will next reboot and the initial memory configuration will begin.
  • Page 59 You remove the 272. The EMS memory limit is the only solitary number in the DEVICE statement. 10. Set up Amanda to work with your telephone switching system and according to your voice mail preferences. Use the next few chapters to define dial codes, define tone and integra-...
  • Page 60: Updating Amanda

    If you installed Amanda as a voice server, make the recommended changes to both C:\AMANDA\DOSMODE\CONFIG.SYS and C:\AMANDA\NETMODE\CONFIG.SYS. Depending on the mode in which you run Amanda, the CONFIG.SYS file (and other files) are copied to the root directory (C:\) from either C:\AMANDA\DOSMODE or C:\AMANDA\NETMODE. Changing the CONFIG.SYS in the root directory only is like not changing the file at all because it will be replaced every time you start Amanda.
  • Page 61: Running The Setup Utility

    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.
  • Page 62 SETUP Then press Enter. The Amanda@Work.Group/DOS Configuration Utility menu appears. 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 •...
  • Page 63: Defining Dial Codes

    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.
  • Page 64 Installing Amanda@Work.Group/DOS To define dial codes: Run Setup as explained in “Running Setup” on page 49. 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.
  • Page 65 Dial Code Label Description What to dial to put the call- The code Amanda dials to ask the telephone switching system to put the er on transfer hold: caller on transfer hold before she transfers a caller to an extension.
  • Page 66 Dial Code Label Description What to dial when there is The code Amanda dials to return to the caller if both of the following are no transfer dial tone: true: You configure Amanda to wait for a transfer dial tone before transferring...
  • Page 67 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.)
  • Page 68 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 If you want Amanda to dial certain codes when she shuts down, define before shutdown: those codes here. For example, enabling call forwarding on the ports lets a live operator take the calls when Amanda shuts down.
  • Page 69 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.
  • Page 70 Installing Amanda@Work.Group/DOS...
  • Page 71: Defining Tone Patterns

    Chapter 8: Defining Tone Patterns Using this Chapter You can use either GetTones, an Amanda Company utility, AccuCall Plus, a Brooktrout utility, to define tone patterns. Both are explained in this chapter. Neither work with the RDSP/RTNI two-board combination. These utilities do not know how to make MVIP connections to the DSP resource in order to dial.
  • Page 72 (time or weather lines are good choices to call). • Define a non-Amanda extension that has a telephone connected, is not forwarded, and will not be answered. This becomes your Ring No Answer (RNA) test station.
  • Page 73 444 or 777 or any number that generates a fast busy tone pattern. Then press Enter. Ring No Answer Type a non-Amanda extension that has a tele- station number phone connected and is not answered or call forwarded. If voice-announce or call-announce...
  • Page 74: Using Accucall Plus

    To run AccuCall Plus: If Amanda is running, shut down the Amanda system: Press Alt+S (if Amanda is running as a standalone) or s (if Amanda is running as a voice server). Type in the password. (The default is AMandA with only the first two and the last letter capitalized.)
  • Page 75 Chapter 8: Defining Tone Patterns When the C:\AMANDA prompt appears, you can start running Accu- Call Plus. Change directory to C:\ACCUCALL by typing: cd c:\accucall Press Enter. You can create a new 1001.TON file or edit an existing file. To create a new 1001.TON file, run AccuCall by typing: accucall To edit an existing 1001.TON file, run AccuCall by typing:...
  • Page 76 Installing Amanda@Work.Group/DOS Select “AUTO RUN” by pressing F6.
  • Page 77 Chapter 8: Defining Tone Patterns To define the Ring No Answer (RNA) tone pattern: Type a telephone number for an extension in the Phone No. field. This extension number must not be forwarded, not in a hunt group, not in hands free/speaker phone mode, and not be answered by anyone.
  • Page 78 12. Then press F10 to save this information and return to the main screen. : All the listed frequencies must be at least 40 Hz apart so Amanda can distinguish them. To define the Busy tone pattern: Fill in the telephone number for an extension that is offhook and connected to either another internal extension or to an outside line.
  • Page 79 Chapter 8: Defining Tone Patterns Select Full (the default) as the value for the Frequency Range field. The possible values are: Full (300 Hz to 1700 Hz) High (800 Hz to 1700 Hz) This is the range of frequencies that AccuCall Plus listens to. The Frequencies Detected Window displays the frequencies detected by AccuCall Plus to characterize the tone.
  • Page 80 Make sure that the busy frequencies are listed in the first four positions in the table (these positions are for terminating tones). When a tone is a terminating tone, Amanda does not wait for it to be repeated before tak- ing control of the call.
  • Page 81 Chapter 8: Defining Tone Patterns The Frequencies Detected Window displays the frequencies detected by AccuCall Plus to characterize the tone. The Cadence Detected Window displays the cadence that AccuCall Plus detected to characterize the tone. (This is displayed as a horizontal bar graph.) Press F9 to begin the test.
  • Page 82 12. Then press F10 to save this information and return to the main screen. To finish AccuCall Plus: Press F7 to save the tone file. Type the file name C:\AMANDA\PBX.DB\1001.TON. Press F8 to save the file. AccuCall Plus will not allow you to save to file unless you have defined all the filters.
  • Page 83: Defining Integration Patterns

    Make sure you define dial codes before performing the procedures in this chapter. Otherwise you will overwrite all the integration information as the Setup utility creates the 1001.PBX file for you using The Amanda Company’s predefined .PBX file for the PBX that you select.
  • Page 84: Setting Up The Trace File

    Installing Amanda@Work.Group/DOS Setting Up the Trace File To check that trace files are being created: If Amanda is running, shut down the Amanda system. At the DOS prompt, type the following to go to the root directory: Then press Enter.
  • Page 85: Creating Test Patterns

    After enabling the Trace capability and restarting Amanda, the telephone switching system must be programmed to perform the following capabilities: • Select an extension that forwards on Ring No Answer to Amanda. • Select another extension that forwards to the above extension on Ring No Answer.
  • Page 86: Running The Tests

    Create a Direct Inward Line by having an outside CO trunk line ring at an extension that will forward on Ring No Answer and Busy to Amanda. Tests 5 and 6 below do not have CO line identification en- abled. Tests 7 and 8 do.
  • Page 87: Reading The Trace File

    • Call in on the CO line that is directed to an extension that is forward- ed to Amanda on Ring No Answer. Make sure that CO Line ID is disabled. Once Amanda receives the call, hang up. Test 6 •...
  • Page 88 #123 The # sign indicates a Ring No Answer forwarded call, and the 123 (for example) is the extension that forwarded the call to Amanda. These dig- its could be any combination of DTMF digits. For example, the AT&T Partner sends:...
  • Page 89 11. Repeat steps 8 through 10 until all 9 integration stings have been recorded. Some of the strings may be identical (although the extension may be different if you tested from different stations). 12. To return to the C:\Amanda> prompt, press the following key combina- tions: Ctrl+X Ctrl+C To decide what integration strings to add to 1001.PBX:...
  • Page 90 Installing Amanda@Work.Group/DOS If not, then your switch sends a unique busy forwarded integration to Amanda. For example, the string may look like “*123”. The “*” denotes a busy forwarded call, and the “123” is the extension that forwarded. Replace the “123” with lower case b’s. Your string would now look like “*bbb”.
  • Page 91: Adding Integration Strings

    Chapter 9: Defining Integration Patterns 10. It is extremely important that there are no duplicate integration patterns. To make sure that each pattern is different, list them on a piece of paper, then rewrite them changing all character codes to zeros. What is left are dial code masks which must all be different.
  • Page 92 Type a number of tenths of seconds in the Timeout box. A value of 0 prevents integration. Any other value is the amount of time that Amanda will wait for information from the telephone switching sys- tem. A suggested value for this timeout is 10 (which equals 1 second). In some cases you may need a value of 15 or 20.
  • Page 93 Chapter 9: Defining Integration Patterns Do one or more of the following: • Verify that the existing patterns are accurate by checking the man- ual for your telephone switching system. • Edit the existing patterns manually. (Select one, use the arrow keys to move around, and type over anything that needs to be changed.) For example, if the Ring No Answer pattern is #6rr, the rr stands for any two-digit extension.
  • Page 94: Using Character Codes

    Each character code represents a call state, the position of the extension number in the pattern, and the number of digits in the extension. When inband signaling strings come from the telephone switching system, Amanda compares them to the defined integration patterns and decides how to handle...
  • Page 95 (or bbbb) or the system busy message. ANI or Caller ID digits When a string of c’s appears in the integration pattern, Amanda stores the DTMF characters at those locations in the port variable %H. With token programming the %H can be used to identify callers and so forth.
  • Page 96 Trunk call or CO line ID; this can also be used for dynamic port alloca- tion When ttt (or tttt) appears in the integration pattern, Amanda processes mailbox ttt (or tttt) normally. Whenever a call comes in on trunk line 3, for example, mailbox 3 is processed.
  • Page 97: Running Integration Helper

    Enable your telephone switching system for voice mail integration. • Program a test extension for call coverage, or call forwarding on Ring No Answer and Busy, to Amanda. The following procedure as- sumes that this extension is 111, but it can be any extension. •...
  • Page 98: Placing Test Calls

    (111) for Ring No Answer: From the available extension (127), select an outside CO line and call in to where you are installing Amanda. When the receptionist answers, ask to be blind transferred to the test extension (111), which should forward to the...
  • Page 99: Forward From Ring No Answer Example

    Make the test extension (111) busy. From the available extension (127), select an outside CO line and call the company where you are installing Amanda. When the receptionist answers, ask to be blind transferred to the test extension (111), which should forward to the Integration Helper immediately.
  • Page 100: Direct Call Example

    Installing Amanda@Work.Group/DOS This takes care of extensions that have exactly three digits (such as 111 and 127). To handle four-digit extensions, for example, you would have used: #02#ssss#rrrr# #03##rrrr Direct Call Example As a result of the Direct test call, one pattern should be labeled “Direct call…”...
  • Page 101: Configuring Amanda

    Using This Chapter This chapter contains a questionnaire that helps you determine exactly how your customer needs his Amanda system to be set up. It also guides you as you configure an Amanda system for the first time. Fortunately, The Amanda Company has configured Amanda so that over 90% of the configuration options need no change whatsoever.
  • Page 102 Location column directions assume that you are already logged on to Amanda Administrator and are displaying the Mailbox window. If not, use one of the following procedures to display the default mailbox template. To display the Mailbox window (if you are not logged onto Amanda Administrator): Start Amanda Administrator.
  • Page 103 Chapter 10: Configuring Amanda To display the Mailbox window (if you are already logged onto Amanda Administrator but displaying another window): Click the Mailbox menu and select mailbox. The mailbox List dialog box appears. Enter 997 (or the mailbox for the default template).
  • Page 104 Options Advanced one ring on each port. phone within a certain number of Configuration (Amanda is being set up as a primary rings? Per Port. attendant.) (This decision can vary from port to Amanda parameter is port.)
  • Page 105 10) When a user listens to messag- NEXT NEW In the Setup utility, select Set the Play Next New Message check es, should Amanda start with his MESSAGE System Configuration box to T for True. first new (unheard) message or the...
  • Page 106 12) Do you want Amanda to tell the In Amanda, select Users Set the D/T option to YES. user the date and time a message...
  • Page 107 Chapter 10: Configuring Amanda Standalone Questionnaire (Continued) Circle Location and Amanda Question Response Parameter (if applica- Action ble) 16) Do you want Do Not Disturb In Amanda, select Users Set Do Not Disturb to ON. initially ON or initially OFF? menu, then enter 997 in mailbox.
  • Page 108 21) If YES to 20, do you want to use SYSTEM In Amanda, select Users Set Current Greeting to 0, which is the Amanda’s system greeting or a menu, then enter 997 in default. company-wide custom greeting mailbox. when a telephone is not answered? CUSTOM Set Current Greeting to 1.
  • Page 109 Use the COPY command shown above after the IDs have been created. 24) Do you want Amanda to let the In Amanda, select Users Set ID Call? to YES. user know who the call is for? menu, then enter 997 in mailbox.
  • Page 110 For example, if the user’s CUSTOM Set Name/Ext. to YES. Each user mailbox is 143, Amanda says “For should make a recording. Until a user makes his recording, the system re- mailbox 1-4-3.”) cording is used.
  • Page 111 Amanda parameter is prompt_file 32) Will Amanda be connected to a In the Setup utility, select Set the Printer Attached To LPT value printer so that you can print reports? System Configuration to 1.
  • Page 112 See Action for Question 37. sages, they accumulate. Do you System Configuration want to get rid of messages that have Options Advanced Set Amanda parameter purge to 0, been listened to and have been Configuration which is the default. around for a long time? General (Settings).
  • Page 113 3 to record the busy-hold music. Make your recording. It be- comes the file C:\AMAN- DA\HOLD.VOX and is played by Amanda to callers on hold. If you create HOLD0.VOX, HOLD1.VOX, etc. Amanda plays them after HOLD.VOX if the extension remains busy.
  • Page 114 Configuration Incoming Calls. Set the Amanda Says “Please Hold Do you want Amanda to say “Please While…” check box to F for False hold….?” Amanda parameter is You can also bypass this message for...
  • Page 115 Options Advanced one ring on each port. phone within a certain number of Configuration (Amanda is being set up as a primary rings? Per Port. attendant.) (This decision can vary from port to Amanda parameter is port.)
  • Page 116 10) Do you want Amanda to tell the From the Mailbox win- From the Options group box, select the user the date and time a message dow in Amanda Adminis- Play Date &...
  • Page 117 Adjust Maximum Rings is cides the user is unavailable? 0, which means 4 rings. trator, click the (After these rings, Amanda takes a If the circled number is not 4, select button after the mailbox message, reroutes the call, or does the Adjust Maximum Rings check box box.
  • Page 118 16) Do you want call screening ini- From the Mailbox win- From the Options group box, select the tially ON or initially OFF? dow in Amanda Adminis- Call Screening check box. trator, click the From the Options group box, clear the button after the mailbox Call Screening check box.
  • Page 119 To create a company-wide custom greeting, record a greeting for some mailbox (e.g., 445), then use DOS on the Amanda server after shutdown to copy it (e.g., C:\VMB.DB\5\445 \GRT1.VOX) as GRT1.VOX for each mailbox assigned to a user. For 3-digit...
  • Page 120 21) If YES to 20, do you want to use SYSTEM From the Mailbox win- From the Personal Greetings group Amanda’s system busy greeting or a dow in Amanda Adminis- box, clear the Custom Busy check box. custom busy greeting?
  • Page 121 Question Response Parameter (if applica- Action ble) 22) Do you want Amanda to let the From the Mailbox win- From the Options group box, select the user know who the call is for? dow in Amanda Adminis- Identify Called Party check box.
  • Page 122 Amanda parameter is prompt_file 30) Will Amanda be connected to a In the Setup utility, select Set the Printer Attached To LPT value printer so that you can print reports? System Configuration to 1.
  • Page 123 32) If YES to 31), do you want WEEKLY In the Setup utility, select Select the Once A Week On [TUE] At Amanda to shutdown once a week Write a day System Configuration [01:30] option. The default is Tuesday or everyday? and a time.
  • Page 124 3 to record the busy-hold music. Make your recording. It becomes the file C:\AMAN- DA\HOLD.VOX and is played by Amanda to callers on hold. If you create HOLD0.VOX, HOLD1.VOX, etc. Amanda plays them after HOLD.VOX if the extension remains busy. Each one is created as HOLD.VOX,...
  • Page 125: Configuring A New Installation

    Chapter 10: Configuring Amanda Configuring a New Installation Amanda has over 200 configuration options. They are what make Amanda so powerful and flexible. You will probably leave over 90% of those options set to their default settings. However, armed with the answers to the First Use Questionnaire, you should review the most commonly changed options (those in the General Configuration section of the Setup utility).
  • Page 126 Installing Amanda@Work.Group/DOS For each check box, select T for True or F for False. Type an asterisk (*) to select an option button. (Press F1 for help with any setting you aren’t sure about.) Press F10 to save your settings and Esc to return to the General Config- uration screen.
  • Page 127 Press F10 to save your settings and Esc to return to the General Config- uration screen. 10. Press P for Password. The Password screen appears. Current Password is display-only. 11. Type the new password for Amanda in the Enter New Password text box.
  • Page 128 Installing Amanda@Work.Group/DOS 12. Press F10 to save your settings and Esc to return to the General Config- uration screen. 13. Press G for General Defaults. The General Defaults screen appears. Language is an example of a list. Pressing F2 displays a list of choices from which you select the language to be used.
  • Page 129 15. Press F10 to save your settings and Esc to return to the General Config- uration screen. 16. If you have installed Amanda as a Voice Server, press Esc to return to the System Configuration menu. 17. Press A for Advanced Configuration.
  • Page 130: Selecting A Type Of Notification

    • Restricted With roving notification, Amanda tries to use the last port in the hunt group (for example, port 4 on a 4-port system) for notification. If the last port is busy, Amanda tries the second-to-last port (for example, port 3), and so forth.
  • Page 131: Using Default And Recommended

    The following is a complete list of the default (and recommended) mailboxes in case you need to change (or set) them. If two departments share an Amanda system, you might use these mailboxes for one department and create another set for the other department. (For more information about sharing an Amanda system, see “Sharing Amanda”...
  • Page 132 Mailbox that acts as a shortcut to mailbox 998. Mailbox 8 makes it easier to send callers directly to voice mail. Live op- erators press transfer, call Amanda, dial 8# followed by the mailbox number, and hang up. The caller goes directly to voice mail.
  • Page 133 In most cases, only one hot_box is defined to detect fax tones and the remainder are unused. However, you cannot separate these for compa- nies or departments that share Amanda. future_delivery Mailbox that stores messages to be delivered at some time in the future.
  • Page 134 Installing Amanda@Work.Group/DOS Default and Recommended mailboxes (Continued) Configuration Mailbox Option Purpose (no option) Mailbox for system administration and for a quick hangup. Mailbox 999 has been created for you. You cannot separate these for companies or departments that share Amanda.
  • Page 135: Faxing

    Using a Fax Modem You can use a fax modem on any Amanda@Work.Group/DOS system. The fax modem used in Amanda may be internal or external as long as it meets all of the following requirements: • Class 2 or Class 2.0 compliant. (Be aware that Class 2 is different from Class 2.0.)
  • Page 136 We recommend using COM1 and/or COM2 for fax modems. This port must be dedicated to the fax modem. : If you have a turnkey Amanda system, it comes with an in- ternal modem which uses COM4 and IRQ5. This is used...
  • Page 137 0 serial_portn y The option maps Amanda's logical port to a physical port on the PC. The n is the number of the logical serial port and the y is the physical serial port (for example, COM1). It is best to make n and y the same number.
  • Page 138 Installing Amanda@Work.Group/DOS Press F10 to save your changes. The Save All Data? dialog box appears. Press Y for Yes. From the Advanced Configuration menu, press F for Fax. The Fax Configuration screen appears. (If you type a space, the Setup utility interprets it as a zero.) 10.
  • Page 139 (for example, 'FAXA') 13. Many older Class 2 fax modems need a string of leading digits ‘1111’ for their fax_id. By default, Amanda adds these digits. However, if they appear on the receiving fax machine, change: fax_id_pad T fax_id_pad F 14.
  • Page 140: Suggested Settings

    The following modems have been used with Amanda with the following settings. This is not a comprehensive list, and many other modems work with Amanda. The following settings are not even guaranteed to work with your modem (even if your modem is one of those listed) because modem manufactures produce a variety of models and change their firmware from time to time.
  • Page 141: Detecting A Fax Machine Automatically

    Boca modem M144EW fax_flow_control &K3 Detecting a Fax Machine Automatically Amanda can detect and accept incoming faxes automatically. To automatically detect and accept an incoming fax: • The fax connect tone must be in the PCPM tone table. The tone information is stored in C:\AMANDA\PBX.DB\1001.TON.
  • Page 142: Creating The Hot Box Mailbox

    Creating the Hot Box Mailbox The Amanda Company recommends using mailbox 994 as the first hot_box, but you can use any valid mailbox. Use the Users screen of Amanda Standalone or the mailbox window of Amanda Administrator to create the mailbox that will process the PCPM tone.
  • Page 143 The caller dials a user and presses the Start button on his fax machine during the user’s greeting. Amanda recognizes the tone and processes mailbox 994. mailbox 994 tells Amanda to create a fax message for the user who was called. The Extension field for mailbox 994 contains tokens similar to the...
  • Page 144: Setting The Hot Box Options

    Installing Amanda@Work.Group/DOS Setting the Hot Box Options You must let Amanda know the mailbox that will process the PCPM tone by setting the hot_box configuration option. To designate a mailbox to accept incoming faxes: Run the Setup utility. At the DOS prompt, from the directory...
  • Page 145: Sending Faxes

    Chapter 11: Faxing Sending Faxes If you are using Amanda as a voice server, you can install Amanda’s fax driver—Amanda Fax. You can use Amanda Fax from any Windows application that has a Print command. You can send documents, spreadsheets, pictures, or anything else that the application can print. You can: •...
  • Page 146 Installing Amanda@Work.Group/DOS...
  • Page 147: Using Serial Integration

    For example, the telephone switching system can tell Amanda why the call was transferred to Amanda, which extension the call is or was intended to go to, and possible which extension the call is coming from. If you call Amanda from an internal extension, Amanda recognizes you and asks only for your security code.
  • Page 148: Bellcore Standard Smdi

    Run Setup as explained in “Chapter 6: Running the Setup Utility.” : As an alternative, you can use the JOVE utility to access the configuration options in C:\AMANDA\INSTALL.CFG. From the Work.Group/DOS Configuration Utility menu, select System Configuration Options. You press 4.
  • Page 149 0 serial_portn y The option maps Amanda's logical port to a physical port on the PC. The n is the number of the logical serial port and the y is the physical serial port (for example, COM1). It is best to make n and y the same number.
  • Page 150 Installing Amanda@Work.Group/DOS Press Y for Yes. 10. From the Advanced Configuration menu, press I for SMDI. The SMDI Configuration screen appears. (If you type a space, the Setup utility interprets it as a zero.) 11. In the SMDI section of Advanced Configuration, change...
  • Page 151 15. You can also set smdi_delay n, where n is the number of tenths of seconds that Amanda waits after the call is answered before looking for integration information. This allows more than one packet to be sent to a port per telephone call.
  • Page 152 : To modify the above for another digit plan, use the appro- priate number of r's, b's, s's, e's, and x's. Also, while 30 is used in the example (causing Amanda to timeout after 3 seconds if the packet has not been received), you may use some other number.
  • Page 153: Nec 2000 And Nec 2400

    Chapter 12: Using Serial Integration : The message codes above are for a 4-digit and 3-digit sta- tion plan. To modify to another digit plan, use the appropri- ate number of 0's. These examples use logical serial port 1 for other ports, the 1’s would have to be replaced. NEC 2000 and NEC 2400 This section covers serial integration for NEC 2000 and NEC 2400 systems.
  • Page 154 Amanda waits that long after the call is answered before looking for integration information. This allows more than one packet to be sent to a port per telephone call. Amanda uses the last (most recent) packet. The default is 0.
  • Page 155 : To modify the above for another digit plan, use the appro- priate number of r’s, b’s, s’s, e’s, and x’s. In the example, 20 is used (causing Amanda to timeout after 2 seconds if the packet has not been received) because it works for all serial integration.
  • Page 156: At&T System 75 Or Definity-G3

    Amanda to wait that long after the call is answered before looking for integration information. This allows more than one packet to be sent to a port per telephone call. Amanda uses the last (most recent) packet. The default is 0.
  • Page 157 Chapter 12: Using Serial Integration You must modify your C:\AMANDA\PDX.DB\1001.PBX file to properly integrate the 7404D set information. Using either the Amanda Setup utility or the JOVE utility, verify that your integration lines are: integration 10 'xxxxxxxxxxxxxx*xxxxxxxxxxxxxxxxrrr D' integration 10 'xxxxxxxxxxxxsssxxxxxxxxxxxxxxxxrrr D'...
  • Page 158: Ericsson Md-110

    Installing Amanda@Work.Group/DOS Mailbox 990 is the default Company Greeting mailbox. If you have redefined the Company Greeting mailbox for any of the ports, use that mailbox instead of 990. Light ON: *4%U Light OFF: #4%U : The examples use %U (for mailbox), but you may prefer %E (for Extension field) or %V (for Variable field).
  • Page 159 Amanda waits that long after the call is answered before look- ing for integration information. This allows more than one packet to be sent to a port per telephone call. Amanda uses the last (most recent) packet. The default is 0.
  • Page 160 Installing Amanda@Work.Group/DOS Use an <available> entry for each string you are adding. (See “Using Character Codes” on page 82 for more information about the codes such as rrr or rrrr.) 4-Digit Station Plan 3-Digit Station Plan Forward no answer: 80rrrrxx...
  • Page 161: Generic

    In the example, 10 is used (causing Amanda to timeout after 1 second if the packet has not been received) because it works for all serial integration. The number is in tenths of seconds.
  • Page 162 Installing Amanda@Work.Group/DOS To set configuration options for generic serial integration: Follow steps 1 through 11 in the Bellcore Standard SDMI procedure “To modify configuration options for use with Bellcore Standard SMDI,” in the “Bellcore Standard SDMI” section. Change the smdi_type option to:...
  • Page 163 Chapter 12: Using Serial Integration You can also set smdi_delay n, where n is the number of tenths of seconds that Amanda waits after the call is answered before looking for integration information. This allows more than one packet to be sent to a port per telephone call.
  • Page 164 Installing Amanda@Work.Group/DOS...
  • Page 165: Miscellaneous

    AC voltage to the telephone ringer. You can also connect Amanda to Direct Inward Dialing (DID) lines with an appropriate DID interface unit. Amanda assumes that you have a DID interface unit, such as Exacom DID-200 Series, that processes a hookflash as battery reversal.
  • Page 166: Telephone Line Options Diagrams

    Installing Amanda@Work.Group/DOS Telephone Line Options Diagrams...
  • Page 167: Sharing Amanda

    Chapter 13: Miscellaneous Sharing Amanda Sometimes more than one company or department share an Amanda system. Specific ports are assigned to specific groups. For example, on a two-port system shared by two companies, one company receives calls on port 1 and another on port 2.
  • Page 168: Using The Box_Grt Configuration Option

    CO line ID number.) This tenant services feature is based on dynamic port allocation, which means that any Amanda port can receive the calls for any company shar- ing the Amanda system. This eliminates the need for dedicating ports to each company.
  • Page 169: Using Incoming Trunk Call And Co Line Ids

    To create the appropriate integration string using a digit grabber: Place a trunk call into Amanda over a CO line (for example CO line 701). Write down the exact character string sent (as reported by the digit grab- ber).
  • Page 170 Press Down Arrow again. The description should read “:Direct call from CO trunk.” Press F10 to save, then Esc to return to the C:\Amanda prompt. 10. Next you must create a mailbox with the same ID number. See “To pro-...
  • Page 171 The Description should read “Unknown/Invalid integration.” Press F10 to save, then Esc to return to the C:\AMANDA prompt. Start Amanda. Place a trunk call into Amanda over a CO line (for example CO line 701). After the call is answered, hang up.
  • Page 172 Installing Amanda@Work.Group/DOS 12. Write down the inband digits. 13. Press Ctrl+X then Ctrl+C to return to the C:\AMANDA prompt. 14. Return to the Setup utility and replace the string of c’s with the correct digits—except for the CO line ID which you replace with t’s.
  • Page 173 Chapter 13: Miscellaneous The figures below show mailbox 701 as an example.
  • Page 174 Greeting 1 for mailbox 990 (the default Company Greeting mailbox), then both mailbox 701 and mailbox 702 should have the following in their Extension fields: @G(990) This token string tells Amanda to play Greeting 1 from mailbox 990 when a call comes in on LINE701 or LINE702.
  • Page 175 For example, if Company A uses the default Company Greeting mailbox (990) and the default Caller Instructions mailbox (991), mailbox 990 should look like the mailbox in the figures below. Record the greetings for each company using your telephone or Amanda Messenger.
  • Page 176 Installing Amanda@Work.Group/DOS The following figures show how this looks in Amanda Administrator and Amanda standalone.
  • Page 177: Using Multiple Employee Directories

    In the Per Port section of Advanced Configuration, change the mail- box for the employee directory on a per port basis. For example, for a four-port Amanda system shared by two companies, box_idx for ports 1 and 2 might be set to mailbox 411, while box_grt for...
  • Page 178: Using Multiple Direct Messaging Mailboxes

    In the Per Port section of Advanced Configuration, change the mail- box for the direct messaging on a per port basis. For example, for a four-port Amanda system shared by two companies, box_snd for ports 1 and 2 might be set to mailbox 998, while box_grt for...
  • Page 179: Accessing Amanda Remotely

    You can control and configure Amanda@Work.Group/DOS remotely from another computer using the Host and Remote programs. Host runs on Amanda (server or standalone) and Remote runs on the computer that is accessing Amanda remotely. You also need either a null modem cable to connect the computers or a modem on each computer.
  • Page 180 REMOTE.COM. For example, it allows you to copy files from the host computer to the remote computer and vice versa. WinRem is not shipped with Amanda@Work.Group/DOS, but works with Amanda@Work.Group/DOS. Contact your sales representative for more information.
  • Page 181: Setting Up Amanda's Computer As A Host

    REM ECHO…. You might also have to change the number of the COM port to be used by the null modem cable or by the modem in Amanda’s computer. If the line is missing, add it as the first line of the AUTOEXEC.BAT file.
  • Page 182: Setting Up The Remote Computer

    (Your floppy disk drive may be b: rather than a:.) Then you can insert the floppy disk into the remote computer and copy the file to that computer. If Amanda is running as a standalone, you can copy the file using the Alt+F (Filecopy) command from the Main screen. Simply answer the Copy From:...
  • Page 183: Connecting By Null Modem Cable

    Remote Version 2.0 You can run Setup and other programs on Amanda’s computer while sit- ting at the remote computer. (If the screen is blank because of Amanda’s screen saver, press the spacebar to exit the screen saver.) To end the Remote session, press Alt+X.
  • Page 184: Connecting By Modem

    To connect via data modem, both Amanda’s computer and the computer that will be accessing Amanda remotely must be running and have a modem that is connected to both a serial port and a telephone line. The data modem must be connected to either a dedicated telephone number (this works best) or its own telephone system station.
  • Page 185 Type JENNIFER in uppercase letters, then press Enter. You can run Setup and other programs on Amanda’s computer while sit- ting at the remote computer. (If the screen is blank because of Amanda’s screen saver, press the spacebar to exit the screen saver.) When you have finished, type Alt+X to end the connection.
  • Page 186 Installing Amanda@Work.Group/DOS...
  • Page 187: Installing The Clients

    A token is a sequence of one or more characters that represents an action that Amanda can perform. The tokens that you use most often are simple and perform routine actions such as dialing an extension. However, a program can be much more complicated than that.
  • Page 188: Installing From A File Server

    Unless told to do otherwise, she listens for call progress tones and an answer. The @ stops Amanda from performing the dial code that puts a caller on transfer hold (also known as the dl_dtwait dial code). As explained in Installing Amanda@Work.Group, you use the Setup utility (selection 1) to...
  • Page 189: Installing From A Floppy Drive On Windows 95

    When all the tokens have been performed successfully in an Extension field, Amanda goes to the RNA Chain field. If the RNA field is blank, she goes to the Done Chain field for the company greeting mailbox (usually mailbox 990).
  • Page 190: Adding Client Connections

    Tracing Token Execution Amanda’s trace files can let you know where and how a token program is failing. This is an invaluable debugging tool. Amanda creates trace files as she runs, because the following trace command should be in the AUTOEXEC.BAT file.
  • Page 191: Kinds Of Tokens

    So JAMES DOLE becomes 'JAMES DOLE' or "JAMES DOLE". "9," is a string that Amanda might dial for an outside line. It consists of the DTMF digit 9 followed by the comma for a pause.
  • Page 192: Reviewing Client Connections

    Port variables are controlled by you. Their names range from %S0 to %S19. Port variables provide 20 locations in which to store information on a per- port basis. The %S0 accessed by Amanda while using one port is not the same location as the %S0 accessed by Amanda while using another port.
  • Page 193 For example, you might assign the value of 65 to %G4 and the value "Amanda" to %S9. Assigning a value to a variable copies that value to the variable’s storage location.
  • Page 194 Installing Amanda@Work.Group The command P(0745,T) tells Amanda to say the number 0745 as a time. It also has the command name P, but it has two parameters: the number 0745 and the literal T.
  • Page 195: Configuration Reference

    Amanda needs in order to perform the action that you requested. For example, Amanda might need the name of the file in which to store a fax or the telephone number for a pager. You supply the input parameters and make sure that the information in them is correct.
  • Page 196 Installing Amanda@Work.Group within a string if you delimit that string with quotation marks. You cannot use a number from 0 to 9 after %S1 in a string because Amanda assumes that you meant the variable %S10 or %S11, etc. Most system variables do not have parameters. However, a couple of system variables have parameters that affect the contents of that system variable.
  • Page 197 Chapter 15: Programming Amanda %I() has three parameters: field, msg_no and mailbox. Because the %I and parentheses are bold, you know that you have to include them in the command. The commas are bold, but the one in front of mailbox is inside brackets […], which surround optional parts of the syntax.
  • Page 198 If you need more than 65 characters for your program, you use: • A command that reads additional tokens from a file • The G() command to tell Amanda to go to the Extension field for an- other mailbox and process the tokens she finds there...
  • Page 199: Files And Directories

    You can use variable names as parts of the file name. For example, if %S1 is C:, and %S2 is Amanda, you can use "%S1\\%S2\\FOOBAR.TXT". Amanda can read text files (also called ASCII files) as well as files in dBase format. The former have file names that usually end with .TXT, and the latter have file names that end with .DBF.
  • Page 200 Amanda the name of the field instead of its number. When Amanda reads data from a dBase file, she deletes any spaces at the end of the data as she stores the data into a variable. For example, if the field contains "MARY...
  • Page 201 I() command determines that the variable is equal to 3. If you want Amanda to process the tokens for 151 until a certain value is entered by the caller, you store the caller’s input in a variable and use the I() command to branch when the variable finally contains the value you are waiting for.
  • Page 202: Customizing The Employee Directory

    Installing Amanda@Work.Group T1 Lines If you are using a T1 line, the only tokens you can use are: • Any DTMF digit (0–9, A, B, C, D, # , *) • Any system, port, or global variable (any token that starts with %) •...
  • Page 203 The caller enters three digits representing the first three letters in either the first or last name of the person he wants to call. If more than one employee matches the digits, Amanda asks the caller to choose. For example, Amanda might say “For Steve Smith, press 1; for Stella Clark, press 2.”...
  • Page 204 Installing Amanda@Work.Group Determine what three digits would match each name: Example: Steve Forest mailbox 105 JoAnn Johnson mailbox 106 Knapp mailbox 107 Create mailboxes for each of the sets of three-digits. Example: Create mailboxes 783, 367, 562, 564, and 262.
  • Page 205 In the Extension field, puts: @M(G1,1,30) This command causes Amanda to play Greeting 1 and waits for the caller to enter a digit indicating a choice from the menu. If the caller does not enter a digit within 30 seconds, Greeting 1 repeats.
  • Page 206: Token Reference

    Installing Amanda@Work.Group When more than one employee matches the digits that the caller enters, you can add 9 to the menu (with mailbox 411) and append the greeting to end with: “…press 9 to return to the employee directory.” Then, if the caller doesn’t want any of the people mentioned in the greeting, he can try an- other name.
  • Page 207 Chapter 15: Programming Amanda Quick Token Reference (Continued) Function/Purpose of Token Syntax Caller hang-up H( mailbox ) Caller ID Comment %F( field[ , mailbox] ) Condition I( value , operator , value , mailbox ) Conference call ext_no KM Creating message notification file...
  • Page 208 Installing Amanda@Work.Group Quick Token Reference (Continued) Function/Purpose of Token Syntax dial tone dial tone, wait for W( n ,T[, mailbox] ) Directory Name field %F( field[ , mailbox] ) Disk space P[ repetition] (D) Dollars P[ repetition] ( amount,currency[,hangup] )
  • Page 209 Chapter 15: Programming Amanda Quick Token Reference (Continued) Function/Purpose of Token Syntax Fax, incremental <( phone_no ) >( file ) Fax, initialization Fax, receive J( file_or_box , phone_no[ , tokens] ) Fax, send T( file , phone_no[ , tokens] )
  • Page 210 Installing Amanda@Work.Group Quick Token Reference (Continued) Function/Purpose of Token Syntax Files, read { file } V( file , field , value{ , field , variable}[ , n] [( file ) N( file , field , value{ , field , variable} )
  • Page 211 Chapter 15: Programming Amanda Quick Token Reference (Continued) Function/Purpose of Token Syntax I( value , operator , value , mailbox ) Import, file { file } Information mailboxes M( greeting[#mailbox] , repetition , delay ) %I( field , msg_no [,mailbox])
  • Page 212 Installing Amanda@Work.Group Quick Token Reference (Continued) Function/Purpose of Token Syntax Message count, new for current user Message waiting indicator, creating X[( file )] Message waiting indicator, deleting Y[( file )] Message waiting indicator, testing for Z[( file )] Message waiting indicators, on/off...
  • Page 213 Chapter 15: Programming Amanda Quick Token Reference (Continued) Function/Purpose of Token Syntax Pauses W(n) Pesos P[ repetition] ( amount, P[, hangup] ) Playing, absolute value P[ repetition] ( number ,N[, hangup] ) Playing, currency P[ repetition] ( amount,currency[,hangup] ) Playing, date...
  • Page 214 Installing Amanda@Work.Group Quick Token Reference (Continued) Function/Purpose of Token Syntax Playing, voice file P[ repetition] (X, file[,hangup] ) Ports S( port ,[ string ,[ variable] ,[ termination] , [length],[timeout]) Ports, change volume ^( volume_change ) Port, current connect time Port number, current...
  • Page 215 Chapter 15: Programming Amanda Quick Token Reference (Continued) Function/Purpose of Token Syntax Search, file ?( line , file , mailbox ) N( file , field , value{ , field , variable} ) V( file , field , value{ , field , variable}[ , n]...
  • Page 216 Installing Amanda@Work.Group Quick Token Reference (Continued) Function/Purpose of Token Syntax Time, connect time Time, current Timed break recall Tokens, processing Tones Total messages P[ repetition] (M[, mailbox[,hangup]] ) Transfer code for current port Transfer, unsupervised (blind) [ext_no]H Transfer, supervised ext_no...
  • Page 217 Chapter 15: Programming Amanda Quick Token Reference (Continued) Function/Purpose of Token Syntax Mailbox, total message count %M[( mailbox )] Mailbox, value of field %F( field [,mailbox]) Variable field P[ repetition] (V) Variables [( file ) ]( file ) |( file )
  • Page 218 A string or variable containing a valid DOS file name for the text file to be searched. Use the complete path to the file unless the file is in C:\AMANDA. There is no limit to the number of lines in the file. mailbox A valid mailbox or a variable containing a mailbox.
  • Page 219 Alphabetical Token Reference (Continued) Token Syntax Description Literal that causes Amanda to process the Extension or Notify Method field as a set of tokens instead of processing the field normally. Normal processing for the Extension field: Amanda plays “Please hold while I try that extension,”...
  • Page 220 If the file does not exist, Amanda just goes on to the next token. file A string or variable containing a valid DOS file name for the text file to be read.
  • Page 221 Chapter 15: Programming Amanda Alphabetical Token Reference (Continued) Token Syntax Description Ctrl+B. Added for Ericsson MD-110 serial integration. For the MD-110, Ctrl+B is the Start of Transmission (STX) character. Can be used in strings. Example: @S(3,"\B06%Emm\N") which controls message waiting indicators.
  • Page 222 If the volume is 5, and you apply a change of 4, the volume goes to 9. If you apply a change of 6, the volume goes to 9 and Amanda ignores the fact that you asked for more volume than was available.
  • Page 223 Use the complete path to the file unless the file is in C:\AMANDA. Example: |(C:\\AMANDA\\PORTVARS.TXT) causes Amanda to add a line to PORTVARS.TXT. You can use this to add a line to PORTVARS.TXT every time the port you are tracing changes the value of a variable. Later you can review the file.
  • Page 224 This command is used only in Extension fields. Example: <(9,7144525570)>(C:\\AMANDA\\PRICES.TXT)> (C:\\AMANDA\\OPTIONS.TXT)>(C:\\AMANDA\\OPTIONS.TXT) causes Amanda to call (714)452–5570 (after dialing 9 for an outside line and paus- ing). Then Amanda faxes two files. Duplicate files are ignored. Failure: Does not fail...
  • Page 225 Chapter 15: Programming Amanda Alphabetical Token Reference (Continued) Token Syntax Description Command that gives the specified variable the specified value. Use start and end =( variable , value to assign only part of the string (a substring) to the variable.
  • Page 226 System variable that contains the percentage of free disk space. Example: I(%D,<,20,171) causes Amanda to transfer to mailbox 171. In this case, 171 would have Do Not Disturb ON and Store Messages NO. The caller would hear a greeting that plays a warning about disk space being low.
  • Page 227 Setup utility. See also recall. Failure: Does not fail The Amanda system has 10 global variables (%G0–%G9). Initially, each variable is equal to the empty string. The values of %G0–%G9 are the same no matter what port is current.
  • Page 228 Series of DTMF digits that indicate an extension number. Example: 151H causes Amanda to transfer the call to extension 151 and hang up (without wait- ing for a voice or busy signal) when Amanda is processing a call. Failure: Invalid extension number...
  • Page 229 Example: H(614) causes Amanda to go to mailbox 614 when a caller hangs up. Because you are tracking the number of hang ups, the Extension field for mailbox 614 has tokens that add one to the variable with which you are counting the hang-ups, for example, +(%G4).
  • Page 230 If a message is from an outside caller, the From field of that message is equal to -1. If the message is from a caller who is logged on to Amanda, the From field contains the caller’s mailbox.
  • Page 231: Fax Options

    I( value , operator , value , mailbox ) fied values and operator create a condition that is true, Amanda continues process- ing at the specified mailbox. If the condition is false, the next token after this command is executed.
  • Page 232 J("C:\\FAXES\\FAX1","") makes Amanda set up one of her fax modems to wait for a call and accept a fax called C:\FAXES\FAX1. You can use this to fax files to your own Amanda system. For example, if you print a text file that contains information for customers and then fax it to Amanda, Amanda can fax that information out to customers using the T() command.
  • Page 233 If these values are not pre-defined for your system, you can set them using Amanda’s Setup utility. Example: KA(1) causes Amanda to dial the string specified in the dial codes for "What to dial to set the message waiting indictor on." Failure: Does not fail...
  • Page 234 KC( mailbox , tents of a variable. If there is a match, the command is successful. For callers who variable ) do not know the security code, Amanda continues processing using the mailbox in the Done Chain field. mailbox Any valid mailbox or a variable containing a mailbox.
  • Page 235 KD(5) deletes message 5 of the current mailbox. KD(10,212,1) deletes message 10 of mailbox 212. If message 10 does not exist, Amanda lets you know she was unable to do that and process the Done chain because the command failed.
  • Page 236 Example: KJ(128,5) causes Amanda to record a message and then send it to the users on mailing list 5 for mailbox 128. Failure: Invalid mailbox or list number or out of disk space Command that logs the current caller on to the specified mailbox.
  • Page 237 Series of DTMF digits that indicate an extension number. Example: 128KM causes Amanda to transfer the call (if she is processing a call) to extension 128, starts a conference call, and records the conference call as a message for mailbox 128.
  • Page 238 It contains either a mailbox indicating whose message it is or a val- id DOS file name. Use the complete path to the file unless the file is in C:\AMANDA. recording_info A number from 0 to 3 indicating whether the caller hears a beep (to start recording) and the post record menu.
  • Page 239 0 (zero). If the caller presses DTMF 0, Amanda sets the port to detect only DTMF digits and proceeds. If the caller dials rotary 0, Amanda learns it and sets the port to detect only rotary digits.
  • Page 240 10. I(LEN[%S1],=,4,%S1) checks the length of the DTMF entry stored in %S1 because all extensions have 4 digits. If %S1 contains a mailbox, Amanda goes to that mailbox. See the I() com- mand for more information. Failure: Does not fail...
  • Page 241 M(G1#111,2,30) plays Greeting 1 from mailbox 111. If there is no response from the caller, Amanda plays Greeting 1 again after a 3 second pause. If there is still no response, Amanda executes the next token in the Extension field.
  • Page 242 A string or variable containing a valid DOS file name for the text or DBF file. Use the complete path to the file unless the file is in C:\AMANDA. No line in the file should exceed 143 characters. There is no limit to the number of lines in the file.
  • Page 243 Despite this format, the date is read in the order that most speakers of the prompt language (specified using the Setup utility) expect to hear it. If the year is the current year, Amanda does not read the year. hangup Optional.
  • Page 244 Installing Amanda@Work.Group Alphabetical Token Reference (Continued) Token Syntax Description Command that tells Amanda to say the specified number as an amount of P[repetition] money. (amount, currency repetition The number of times to repeat amount. The default is 1. [,hangup]) amount A number from 0 to 999 million.
  • Page 245 Chapter 15: Programming Amanda Alphabetical Token Reference (Continued) Token Syntax Description Command that tells Amanda to say the specified number as a time of day. P[repetition] (time,T repetition The number of times to repeat the contents of the port variable. The [,hangup]) default is 1.
  • Page 246 Example: P(G1) causes Amanda to play Greeting 1 for the current mailbox. Failure: Invalid mailbox Command that tells Amanda to say the total number of messages for the P[repetition] specified or current mailbox. (M[,mailbox Using this command cancels any pending Notify actions for the specified [,hangup]]) message automatically.
  • Page 247 Example: P3(M1,212) causes Amanda to play message 1 for mailbox 212 three times. Failure: Invalid mailbox P[repetition] Command that tells Amanda to play all new messages for the specified or (MN[,mailbox current mailbox. [,hangup]]) repetition The number of times to repeat the message. The default is 1.
  • Page 248 Amanda to play the Name/Extension recording for the current mailbox. Failure: Invalid mailbox Command that tells Amanda to say a number as DTMF digits. This is P[repetition] usually used for repeating the number corresponding to the DTMF tones (DTMF) entered by a caller.
  • Page 249 Chapter 15: Programming Amanda Alphabetical Token Reference (Continued) Token Syntax Description Command that tells Amanda to look for the specified prompt number in the P[repetition] current system language file. Then Amanda plays the prompt associated (prompt_no,V with that number. [,hangup]) repetition The number of times to repeat the prompt.
  • Page 250 Amanda to play the Name/Extension recording for the current mailbox. If it doesn’t exist, Amanda says the digits for the mailbox. Failure: Invalid mailbox Command that tells Amanda to say the digits in the Variable field of the P[repetition](V) Notification record.
  • Page 251 Each question is record- [#mailbox][,E]}) ed as a greeting which Amanda plays back with a tone. Then Amanda records a response and goes on to the next question. Up to 20 questions are allowed. To ask more than 7 questions (after using Greetings 1 to 7 for the current mailbox) you can use greetings from other mailboxes by specifying which mailbox’s greeting to ac-...
  • Page 252 This token is used only in Notify Method fields. Example: 9,%VW(9,V)P(U)P(R) causes Amanda to call someone at home and say the telephone number and other information in the relay variable. Command that plays a greeting from the current or specified mailbox and R(greeting stores the caller’s DTMF entry as a number in the specified variable.
  • Page 253 %S0. =(%S12,714) assigns the area code 714 to %S12. I(%S12=714,555) causes Amanda to go to the Extension field for mailbox 555 because the condition is true (%S12 does equal 714). Failure: Invalid variable name (such as %S52)
  • Page 254 Alphabetical Token Reference (Continued) Token Syntax Description Command that gives Amanda access to other computers via the serial ports. Aman- S( port ,[ string] , da can send a string to and/or receive a string from the remote computer. When re-...
  • Page 255 Example: S(2,%S3,%S4,,,50) both sends and receives. The command uses COM port 2. %S3 stores the string to be sent. %S4 stores the string that is received. Amanda waits a half second for the first character and between characters. S(2,%S3) only sends. The command uses COM port 2. %S3 stores the string to be sent. This command has non-standard syntax.
  • Page 256 Amanda wait for a call to ring into the fax port. tokens Optional. A string or variable that defines the actions Amanda takes to connect the call to the fax port. For more information, please see the ex- ample for the J() command.
  • Page 257 U-144 causes Amanda to call extension 144 (if Amanda is processing a call). If the exten- sion rings, she transfers the call and hangs up. If the extension is busy, Amanda lets the caller know that. Failure: Does not fail System variable that contains the value of the Variable field in the current Notifi- cation record.
  • Page 258 A string or variable containing a valid DOS file name for the text or .DBF file. Use the complete path to the file unless the file is in C:\AMANDA. No line in the file should exceed 143 characters. There is no limit to the number of lines in the file.
  • Page 259 DTMF digits to be displayed on the pager. W(4,V,111) makes Amanda wait up to four rings for a voice. If a voice is detected, processing continues with the next token. Otherwise, control is transferred to mailbox 111. Failure: Invalid mailbox...
  • Page 260 A user’s message waiting indicator toggles on and off. For the first message, Amanda should turn the indicator on. The indicator should be left on for the second and later messages (until they are all listened to). So you use: •...
  • Page 261: Troubleshooting

    LIGHT.ON in the mailbox’s directory. Example: Z()X() causes Amanda to check for LIGHT.ON. If it is not there, the X() command causes Amanda to create it. See also the X() command. Failure: Does not fail...
  • Page 262 Installing Amanda@Work.Group @P(G2, your_personal_mailbox) in the Extension field for 4001, then you know which string fails based on which of your personal greetings Amanda plays.
  • Page 263: System Paging Of A User For Special Callers

    When callers access this mailbox, Amanda pages you over the telephone paging system in your office. After letting you know that you have an important call, Amanda transfers that call to your extension through a “backdoor” even if your regular extension mailbox (for example, 111) might have its Do Not Disturb setting ON.
  • Page 264: Switching And Maintaining Languages

    This example illustrates how you can completely over-ride Amanda’s standard processing. Amanda has the ability to support multiple languages simultaneously on any port. The only requirements are that you install an alternative language prompt file and you configure the mailboxes to allow a caller to change to the alternate language.
  • Page 265 (realize that you can have additional language selections as additional menu choices). However, after the caller selects Spanish by pressing 1, when they access a mailbox, Amanda still says in English, “Please hold while I try that extension.” We have changed which...
  • Page 266 The token to change system prompts is L(). To change to the Mexican Spanish system prompts, use L(MEXICAN) provided that the Mexican Spanish system prompts file resides in the Amanda directory and is named MEXICAN.IDX (if your system has a Rhetorex voice board) or MEXICAN.BDX (if your system is connected to a Norstar KSU).
  • Page 267: Another Consideration

    This works for most situations. However, there is one final consideration. What happens if the caller enters an invalid extension or choice? By definition, an invalid mailbox has no Done Chain. As a result, Amanda defaults to using the Done Chain of the Company Greeting mailbox on that port.
  • Page 268 "MEXICAN" into %S1. =(%S1,"MEXICAN") To determine which language Instruction mailbox to access, we could use the I() token, often called the If token, which allows Amanda to con- tinue processing at the correct mailbox. For example, I(%S1,=,"MEXI- checks the value of %S1 for "MEXICAN"...
  • Page 269: Order Shipment Information

    This configuration now changes Amanda’s standard processing and keeps the caller connected to the correct language Instruction mailbox. It works because whenever a new call is answered, Amanda initializes the %S tokens to "" (the empty string). Therefore, if the caller never presses 1 for Spanish, then %S1 is never set to the value "MEXICAN"...
  • Page 270 If the order has not shipped, inform the caller. Otherwise, tell the caller the date the order was shipped. In order for Amanda to determine an order’s shipped status and its ship date, she needs to retrieve information from some source. One possible way she can obtain the data is by using the serial, S(), token to request it from another computer.
  • Page 271 (%S1), ?(%S1,C:\\SHIPPED,mailbox) which contains the order number, is in a file SHIPPED. If it is, Amanda continues processing with mailbox mailbox. If the order number is not in the file SHIPPED, Amanda continues pro- cessing at the token after the ?() token.
  • Page 272: Sending Faxes To Amanda

    Amanda before the following examples can work. Sending Faxes to Amanda Before you can send faxes from Amanda, the data to be faxed must be stored on the hard drive. Because Amanda uses a proprietary fax format, you must fax the data to her.
  • Page 273 For example, if you type in 32, the fax is stored as C:\FAX\32. : You must have created the C:\FAX directory previous- ly. Amanda does not create this directory for you. One-call Faxback To set up a one-call faxback, you need to use one mailbox for each document.
  • Page 274 Installing Amanda@Work.Group Mailbox 92000 contains the menu. It should have the following settings and greetings: Extension Field: blank DND: Store Messages: NO Greeting 1: If you are calling from your fax machine, please press the number corresponding to the technical report you are interested in.
  • Page 275 Chapter 16: Programming Examples : All the quotation marks in these token examples are single quotation marks (although double quotation marks can be used). Forward slashes are used (although double back- ward slashes \\ can also be used with this token). Two-call Faxback This example allows the caller to select one or more fax documents, and leave his fax number.
  • Page 276 Installing Amanda@Work.Group Menu 2: 1000 Menu 3: Mailbox 1001’s Extension field contains the tokens that determine whether or not the entered area code is local (assuming that the local area code is 714). If the area code is not local, it stores the long distance dialing digit '1' in the variable %S0.
  • Page 277 Chapter 16: Programming Examples Mailbox 1004 contains a menu that lists the available documents. It should have the following settings and greetings: Extension Field: @<('9,%S0%S1%S2')M(G1,2,30) DND: Store Messages: NO Greeting 1: Please press the number corresponding to the technical report you are interested in. For report #1 on SMDI, press 1.
  • Page 278: Ivr And Voice Form Applications

    This section provides guidelines for writing effective IVR (Interactive Voice Response) and voice form applications. It also provides examples of how to use Amanda’s menus, greetings, and messages as well as the Q(), M(), R(), and P() commands from Amanda’s Token Programming Language.
  • Page 279: Making The User Comfortable

    Chapter 16: Programming Examples Making the User Comfortable To make users feel that they are in control of the application rather than at the mercy of it, the greetings should perform the following tasks in order: Identify the company or service so that the user can determine whether he has placed his call correctly.
  • Page 280: Using Menus

    Installing Amanda@Work.Group Using Menus As you create your menus, do the following: • Find logical topics for menus • Offer topics in order: most likely to be selected to least likely. Make an exception to this rule when the topic itself contains a number.
  • Page 281: Providing Information And Feedback

    Chapter 16: Programming Examples For single-digit responses, you can use a greeting as a menu. For multi-digit responses, you can use the R() command to convert the DTMF tones to an ASCII number. For voice forms, you can use the Q() command to save the responses for up to 20 questions as a message.
  • Page 282 Installing Amanda@Work.Group • Repeat the current greeting when there is no response. If there is still no response, provide a message explaining what is happening and ei- ther connect the call to an attendant or disconnect it. • Play an error message, status message, or tone.
  • Page 283: Using The Telephone Keypad

    Chapter 16: Programming Examples Using the Telephone Keypad If the users enter their choices via the telephone keypad, follow these guidelines: • Assign keys consistently. This is especially true for Delete and other destructive options. For example, don’t use 3 for Delete on one menu and Save on another. •...
  • Page 284: Choosing Tokens

    The menu fields associated with the mailbox. The mailbox allows the caller to enter either a one-digit response to the menu or another mailbox. Amanda waits long enough to be sure that the caller has fin- ished. (For this method, turn Do Not Disturb ON.) •...
  • Page 285 Chapter 16: Programming Examples After using the product, the stylist calls again to answer a series of questions. For services rendered, the stylist is mailed a small fee or a free case of the product. Later, the survey company analyzes the data and reports back to the manufacturer.
  • Page 286: Gathering Testing Information

    881 (via the Done Chain). Mailbox 881 has: Extension Field: @M(G1,2,30)G(0) Amanda plays the menu in Greeting 1. If there is no re- sponse from the caller, Amanda plays Greeting 1 again after a three-second pause. If there is still no response, Amanda executes the next token in the Extension field (which goes to the operator).
  • Page 287 (%S2). This message number becomes associated with the stylist for the duration of the survey. Then Amanda plays the menu in Greeting 3. If there is no response from the caller, Amanda plays Greeting 3 again after a three-second pause. If there is still no re- sponse, Amanda executes the next token in the Exten- sion field (which goes to the operator).
  • Page 288 Menu 0: Mailboxes 1002, 1003, … have: Extension Field: @=(%S3,%S2)+(10000,%S3) |(C:\\TESTERS\\TESTX.TXT)P(G1)G(999) Next Amanda makes a copy (%S3) of the message number (which identifies the stylist) and adds 10000 (or some other product differentiating number) to it. This becomes the test ID.
  • Page 289 Amanda@Work.Group/DOS by loading the Amanda Clients. You can install the Amanda Clients by going from desk to desk with the installation disks, or you can copy the software onto a network file server and then install it on each workstation from the file server.
  • Page 290 You may need to contact your network system administrator for assis- tance. To install the users’ client files from the file server: If any previously installed Amanda Clients are running, close them. Access the network drive. Open the directory where the clients are stored.
  • Page 291 Follow the directions given by the setup program to finish the installa- tion process. Unless modified by the installer, the directory C:\AMACLNTS contains the clients. The Amanda group of clients appears in the Programs section of the Start menu. The Amanda group contains all the clients installed on this workstation.
  • Page 292 Now that users have the Amanda@Work.Group/DOS clients, you must add the appropriate number of Client Connections to the Amanda Voice Server. Only one client connection comes with Amanda Voice Server. If you add no client connections, only one client can access the voice server at a time.
  • Page 293 , turn the com- C:\AMANDA> puter off. Next, attach the CCB to the parallel port on the back of Amanda Voice Server. The CCB contains a number of Client Connections, some (or all) of which can be transferred to this Voice Server.
  • Page 294 When he logs off, the client connection is returned to the pool and is available for the next person who logs on. As more users are added to Amanda, some users may not be able to log on because all client connections are in use.
  • Page 295 Cancel. 10. View the file using a text editor. The value for n_clients is the maximum number of clients the Amanda server currently accepts. Do not edit this value and recopy install.cfg to the voice server. Changing this value will corrupt the file.
  • Page 296 Installing Amanda@Work.Group/DOS...
  • Page 297 Allows you to shorten the system greeting. True or False. The default is False. When True, Amanda says, “Please leave a message at the tone.” This is the short- ened version of the system greeting. When False, Amanda says, “Please leave a message for” followed by the name and extension recording.
  • Page 298 The caller presses * to go on hold and must press * periodi- cally to stay on hold. When False, Amanda is set up for inactive hold. The caller indicates that he wants If the caller does to be on hold only once.
  • Page 299 The default appears in install.cfg as: set advertising 'Buy more Amandas!' ati_mode Allows Amanda to be used with a Brooktrout x000 board and an ATI board. An ATI board requires a version 7.x Brooktrout driver. True or False. The default is false.
  • Page 300 The name of a previously saved report file in the RPT.DB subdirectory within the AMANDA directory which can be executed and printed once each day. When not set, no auto reporting is done. Use the name of a report file with the extension .RPT. The default is an empty string which means that no report file is executed.
  • Page 301 The file (in the C:\AMANDA directory) which stores call accounting (SMDR) data that comes from the port in ca_port. The data is collected from the telephone switch- ing system, stored while Amanda runs, and then (after a shutdown) read by a call accounting package that analyzes and manipulates the data.
  • Page 302 10 connect_tone When an answer is detected and Amanda is not identifying the called party for the current mailbox, this option determines whether Amanda plays a beep. (On the Stan- dalone system, the mailbox’s ID Call? field is set to NO, and on the Administrator client, the mailbox’s Identify Called Party check box is cleared.)
  • Page 303 Makes Amanda lock each record in a file as it is accessed. No other port or program can access that record of that file. This is used within the context of using tokens to read and write to ASCII or dBase files.
  • Page 304 For exam- ple, use 20 to have Amanda notify you when the remaining disk space falls below Number (for a percentage). The range is from 1 to 99. The default is 20.
  • Page 305 Amanda waits to read a sequence of DTMF digits from the port prior to doing PCPM. The range is 0 to 255. The default is 0, which disables this and the following parameters.
  • Page 306 When True, the buffer is not cleared. Make sure the telephone switching system can send DTMF before a ring prior to changing this to True. When False, Amanda clears the buffer when a ring is detected. You must use False for Brooktrout 2132 and 4132 because they cannot detect DTMF while on-hook.
  • Page 307 If dtmf_dt is not an empty string, and if tmo_dtwait (the dial code that determines how long to wait for a dial tone or its equivalent) is > 0, Amanda dials dl_dtwait (the dial code that puts the caller on transfer hold) and then waits for the dtmf_dt digits to come from the switch.
  • Page 308 Caller Instructions mailbox has Do Not Disturb turned off. True or False. The default is False. When True, Amanda verifies that the caller is still on the line after playing the Caller Instructions and not hearing any DTMF. Amanda asks the caller to “Say ‘yes’ at the tone”...
  • Page 309 (whether greetings or messages) and play the post-record menu. The range is from 0 to 9 and also includes * and #. The default is '#'. Remember that the # key always causes Amanda to stop recording, even when it is not the value of exit_digit.
  • Page 310 The 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 num- ber of guest mailboxes that Amanda can create. Guest_max must be larger than guest_min.
  • Page 311 The 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.
  • Page 312 10 lognam The 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.
  • Page 313 The 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.
  • Page 314 Minimum 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 board's default (which is 2 for Denmark or Holland and 3 elsewhere). Otherwise, the range is 1-655.
  • Page 315 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.
  • Page 316 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.
  • Page 317 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.
  • Page 318 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:...
  • Page 319 If you must change this option, use a number greater than 2001 or a non-numeric name. Amanda's 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.
  • Page 320 Controls 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.
  • Page 321 Description prompt_file Specifies 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.
  • Page 322 20000 set range3 30000 set range4 40000 range1_key If you buy a third-party application that was customized for Amanda using the To- range2_key ken Programming Language, you import the mailboxes programmed for that appli- range3_key cation with the import utility.
  • Page 323 When True, Amanda checks the values of begin_rec_prompt and end_rec_menu to determine what to say. When False, Amanda does not prompt the caller to leave a message at the tone nor the user to record a greeting at the tone. She also does not play the post-record menu that allows the caller or user to review and re-record.
  • Page 324 The default appears in install.cfg as: set rotary false screen_save The file in the C:\AMANDA directory in which screen traces are saved. Whenever you use screen trace, the data is saved to the designated file. Otherwise, the data ap- pears only on the screen.
  • Page 325 The minimum length of a user’s security code (when changed by a user over the tele- phone or when using Amanda Messenger). This does not affect the length of security codes that are entered from Amanda standalone or from Amanda Administrator. The administrator can use any password of 8 or fewer characters.
  • Page 326 Controls how long Amanda waits after the last keystroke before blanking the Main screen (to prevent screen burn-in). Amanda blanks the screen only if the Main screen is displayed. A value of 0 stops Amanda from ever blanking the screen. (This option does not apply to Amanda voice server.) Number of minutes.
  • Page 327 If the value is 0, the prompt is not played. If you use a number greater than 0, Amanda waits that number of seconds for a response from the caller. The default is 2.
  • Page 328 This is necessary when a telephone system does not release a station that is connected to Amanda even after Amanda has gone on-hook (a rare occur- rence). When 0, Amanda does not go off-hook and back on-hook if a port is idle. The default appears in install.cfg as: set tmo_idle 0...
  • Page 329 Description tmo_rna For some PBXs, Amanda assumes that the called party is not going to answer the telephone if there is no answer after a certain length of time. The amount of time she waits is the product of this setting times the maximum number of rings for a Ring No Answer.
  • Page 330 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.
  • Page 331 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.
  • Page 332 When positive voice control is used, this option specifies how long a noise must con- length 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.
  • Page 333 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 machine's number. Usually, it is the dial code for accessing an outside line. The de- fault is '9,'.
  • Page 334 The default appears in install.cfg as: set fax_init '&FE0' fax_log Use 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 •...
  • Page 335 Chapter 18: Configuration Reference Fax Options (Continued) Configuration Option Description fax_receive_reverse True 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.
  • Page 336 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.
  • Page 337: Hot Box Options

    Configuration Option Description hot_box Defines 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.
  • Page 338: Network Options

    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.
  • Page 339 'AMANDASERVER' tmo_call_screening The 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.
  • Page 340: Outdial Options

    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.
  • Page 341: Per Port Options

    1 to 24. box_idx Sets the mailbox for the employee directory. This is set per Amanda telephone port by assigning a mailbox to the port. The employee directory contains the names of all...
  • Page 342 Description box_snd Indicates what mailbox serves as the direct message mailbox. This is set per Amanda telephone port by assigning a mailbox to the port. The direct message mailbox al- lows you to leave a message for a mailbox without processing the mailbox. Amanda does not execute the Extension field’s tokens or play a greeting.
  • Page 343 Per Port Options (Continued) Configuration Option Description n_rings Sets the number of rings that Amanda waits before answering a call on a given port. To have port 7 answer after the second ring use . This is n_rings 2 for port 7 useful for those telephone switching systems that do not allow incoming lines to ring in a station hunt group or do not provide delayed ringing.
  • Page 344: Serial Port Options

    Installing Amanda@Work.Group/DOS Serial Port Options Configuration Option Description baud1 The bps (bits per second) for the logical serial port with the same number. For ex- baud2 ample, baud1 gives the bps for serial_port1. (Serial_port1 can be mapped to any baud3 COM port.)
  • Page 345 Only after this matching can Amanda communicate with devices, such as SMDI in- terfaces, connected to her COM ports. For example, serial_port1 2 matches serial_ port1 (Amanda’s first logical serial port) to the physical COM port 2 of the PC. However, it is less confusing to use serial_port1 1, matching logical and physical ports with the same number.
  • Page 346: Smdi Options

    The number should allow enough time for all the strings to arrive, forcing Amanda to use only the last (most recent) one. (The integration time specified in the 1001.PBX configuration file can be zero or near zero, because Amanda has already waited for smdi_delay time to pass.)
  • Page 347 Chapter 18: Configuration Reference SMDI Options (Continued) smdi_port The logical serial port (represented by serial_portn) to use for SMDI integration. The port should already have been configured as a serial port using the options in the Serial section of Advanced Configuration. The range is 0 to 4.
  • Page 348 The default appears in install.cfg as: set smdi_term '' smdi_type Indicates which SMDI integration protocol Amanda is to use. For Bellcore Standard, use 'smdi'. For AT&T System 75 or Definity-G3, use 's75'. For NEC 2000 Message Center Interface use 'necmci'.
  • Page 349: T1/Did Options

    In a 2-wink T1 environment, Amanda may receive more digits than the Brooktrout buffer 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.
  • Page 350 Indicates whether Amanda expects a loop start or a DID interface line. True or False. The default is True. When True, Amanda expects a loop start line, and new calls are indicated by ring voltage. When False, Amanda expects a DID interface line, and new calls are indicated by loop current.
  • Page 351: Troubleshooting Amanda

    Resetting a Port from the Main Screen Amanda standalone uses the Main screen primarily to display information about the system. However, Amanda also allows you to reset a port from the Main screen so that the system does not have to be completely shut down.
  • Page 352: What To Do When.

    • You see the message: RDSP Not Located at any Interrupt Vector Amanda Does Not Transfer the Call If Amanda does not transfer the call, one of the following may be causing the problem. Problem: The mailbox has Do Not Disturb turned ON.
  • Page 353 Review the tokens and insert a hookflash where needed. When the Ex- tension field starts with @, a F- or %X will not enable PCPM. Amanda does not listen for call progress tones. The W() token can be used to listen for voice.
  • Page 354: Caller Doesn't Hear The Busy Message Or Rna Greeting

    The integration patterns are incorrect. Solution: Run a trace on the system to see if the integration strings coming across the port match the ones Amanda is expecting. (Run the Setup utility, se- lection 3.) Problem: The Busy and Ring No Answer integration patterns are identical, so Amanda treats both types of calls the same.
  • Page 355: Notification Does Not Work Correctly

    If using roving notification, make sure that all single line ports connected to the voice board ports get dial tone when they go off-hook and also program the phone system to grant all Amanda ports outside dial tone, when a 9 or some other code is dialed.
  • Page 356: Host/Remote Programs Do Not Work

    Installing Amanda@Work.Group/DOS Host/Remote Programs Do Not Work If the Host and Remote programs do not work, one of the following may be causing the problem. See “Chapter 14: Accessing Amanda Remotely.” Problem: Both modems used have a bps higher than 2400.
  • Page 357: System Halts

    The 727 Brooktrout driver is installed and the rotary configuration option is set to true. Solution: The 727 Brooktrout driver (shipped with Amanda version 6.02) does not support rotary. You can switch to the 537 drivers. First save VOICEC- NF.EXE as VOICECNF.727 and RHETDRV.EXE as RHETDRV.727.
  • Page 358 Installing Amanda@Work.Group/DOS...
  • Page 359: Troubleshooting The Clients

    Appendix B: Troubleshooting the Clients NIC Configuration If you purchase a NIC other than the preconfigured NIC from The Amanda Company, you may have to run the Setup program for that NIC. The Amanda Company’s default settings for its NIC are: •...
  • Page 360: Common Error Messages

    Installing Amanda@Work.Group/DOS Common Error Messages Problem: NetBIOS Not Available Solution: The protocol required to run the Amanda Clients is NetBIOS. To define the NetBIOS protocol in Windows 3.11: From the Program Manager, select Network. Select Network Setup. Select Drivers. Highlight Microsoft NetBEUI.
  • Page 361 Problem: Client Connection unavailable. Solution: Not enough Client Connections activated on the Amanda Voice Server. To review or change the number of clients, see “Adding Client Connec- tions” on page 178 and “Reviewing Client Connections” on page 180. Please contact your Amanda Company representative for a new CCB.
  • Page 362 Session (connection with server) has ended abnormally. Solution: The server and client were never connected or have become disconnect- ed. You need to log back on to Amanda Voice Server. Amanda Admin- istrator, Amanda Monitor, and Amanda Messenger have Log On… commands on their first menus.
  • Page 363: Index

    %V token activating minimum port number 183, 206 Numerics Amanda mailboxes Amanda upgrades 51, 71 1001.PBX SMDI Amanda Voice Server modes adding integration patterns activation key activation_key analog 120, 227 active_hold telephone switching sys- prompt for transfer addressing tems RDSP/x000 voice boards...
  • Page 364 Installing Amanda@Work.Group auto_queue time between transfer at- center auto_report tempts voice messaging auto_report_time treated as Ring No Answer changing AUTOEXEC.BAT CONFIG.SYS load Host program Busy chain character codes automated attendant busy extensions integration patterns Automatic Number Identifica- busy message characters...
  • Page 365 Amanda dates deleting incoming calls abbreviated mailboxes language forwarded messages messages messages said by Amanda deliveries notification db_locking in future passwords dealer sales delivering 118, printers dedicated notification message in future RDSP/x000 voice boards departments...
  • Page 366 Installing Amanda@Work.Group dial tone detection minimum port number dl_pickup_on_ring dl_bsyret dl_prefix dl_conference dialer_max_port dl_rnaret dl_connect dialer_min_port dl_stop 55, 240 dl_dtwait dialtone detection dl_suffix dl_hangup tmo_dtwait Do Not Disturb 153, 235 dl_hupret documents 154, 155, 235 dl_init did_dtmf faxing 154, 155, 235...
  • Page 367 Index dtmf_gate fax_direct_connect dtmf_on fax_dl_init gain_loud dtmf_ring fax_flow_control gain_norm dtmf_xfer fax_id generic fax_id_pad serial integration fax_init GetTones utility character code fax_log greetings earth recall fax_max_retries ended with # employee directories fax_receive_reverse integrated calls mailboxes fax_receive_speed per port per port fax_requeue_interval recording employee directory fax_reset...
  • Page 368 Bellcore Standard keys ports Definity-G3 activating Amanda ignoring DTMF digits keys, activating Amanda loop current Ericsson MD-110 keys, activating range of mail- immediate record generic boxes character code greetings keys, activating SMDI in band integration patterns...
  • Page 369 Index security codes caller instructions maximum time lights company greetings Name and Extension re- message created as read-only cording default recording a list comment default templates line interface deleting maximums RTNI-xATI boards direct messaging number of ports lines employee directories ports for Dialer loop start future delivery...
  • Page 370 118, 203 modems restricted patterns bps rate roving integration 239, 240 connecting computers Type tone modes notification records Amanda Voice Server Ring No Answer 51, 71 modified_call_screening Notify Max Times PBX.DB msg_log Notify Type PBXs multiple_clients notify_restriction ports for MVIP streams...
  • Page 371 MVIP cable in use prompt MVIPbuses initial volume transferring caller to user’s RDSP/x32 mailbox during connecting ports maximum RDSP/x32 voice boards maximum for Amanda Di- prompt_file installation checklist aler prompts read-only message lights for recording mailboxes minimum for Amanda Di- language...
  • Page 372 Installing Amanda@Work.Group recognizing Rhetorex MVIPbuses loop current drop AccuCall Plus utility RTNI-xATI boards loop current off busy notification base I/O ports record driver line interface 193, character code options and defaults RTNI-xATI voice boards 197, 198, 210 record menu installing...
  • Page 373 System 75 Setup utility space serial integration running warning system administration sharing Amanda Spanish support short_direct_send special system dial codes shortening options defining system greeting starting system greeting 11, 31...
  • Page 374 Installing Amanda@Work.Group system initialization automatic reports waiting for peripheral dl_init before integration timeout system integration patterns between disk space checks inband integration character codes timeouts Integration Helper between DTMF tones call screening test calls between menu repetitions timers system shutdown...
  • Page 375 59, 62, 216, partially supervised utilities Rhetorex supervised GetTones Troubleshooting Host/Remote voice boards, not from The error messages Setup Amanda Company 11, 31 183, 206, 232 NIC Configuration ShowJump 216, 217 trunk voice control character code verifying time Type...
  • Page 376 Installing Amanda@Work.Group voice mail volume warranty mailbox custom busy message web site voice messaging center initial wild card voice processing system character code voice responses, storing W token winks, t1 lines voice server waiting configuring before integration questionnaire for DTMF...

This manual is also suitable for:

Work.group/dos 7

Table of Contents