Amanda Work Place Instructions Manual

							Chapter 5: Defining Tone Patterns 23
To define the Reorder/Fast Busy/Error tone pattern:
1. Type a telephone number for an invalid extension in the Phone No. field. This 
extension number must return the reorder tone. For example, you might use 777 or 
888. Test this tone from a single-line telephone before you run this test.
2. Type 3 in the Verification Count field. This is the number of times you want to run the 
test.
3. Type 10 in the Minimum Cycles field. This is the number of rings AccuCall Plus will 
listen to before completing the test cycle.
4. 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.
5. The Frequencies Detected Window displays the frequencies detected by AccuCall 
Plus to characterize the tone.
6. The Cadence Detected Window displays the cadence that AccuCall Plus detected to 
characterize the tone. (This is displayed as a horizontal bar graph.)
7. Press F9 to begin the test.
8. After AccuCall Plus has determined the system tone pattern, you can customize the 
tone description using the Edit Tones box:
Name: Example:  Panasonic Reorder Tone
Type: Busy if normal reorder
Terminating: YES
Cadence: NO
Frequency1: Determined by test
Frequency2: Determined by test
PCPM Code: 7 (always for busy tones)
Quick Count: None
On Time: Determined by test
On Max Variation: Determined by test
On Min Variation: Determined by test
Off Time: Determined by test
Off Max Variation: Determined by test
Off Min Variation: Determined by test
9. Save the tone by pressing F8 (twice).
10. From the main screen, press F3 to go to the Filters screen. The Undefined Tone Fre-
quencies box on the right side of the screen lists any undefined frequencies that were 
found by the test.  
						

							24 Installing [email protected]
11. Add these frequencies to the Filter table on the left side. Write each frequency in the 
Filter table, replacing the word “none” with the frequency.
Make sure that the reorder frequencies are listed in the first four positions in the table 
(these positions are for terminating tones).
12. Then press F10 to save this information and return to the main screen.
To finish AccuCall Plus:
1. Press F7 to save the tone file.
2. Type the file name C:\AMANDA\PBX.DB\1001.TON.
3. Press F8 to save the file. 
AccuCall Plus will not allow you to save to file unless you have defined all the filters. 
It will also refuse to save to file if any two frequencies are within 40Hz of each other.
If you have two frequencies that are closer than 40Hz, the best strategy is to select a 
value that is between them and then go back to edit every tone pattern that contains 
the two frequencies and replace them with that value. To edit tones press  from 
the main menu.
4. Exit the AccuCall Plus program by pressing F10. 
						

							Chapter 6:
Defining Integration Patterns
Using the Trace File for Integration
If your telephone switching system supports DTMF integration (also called inband 
integration), you can:
1. Perform tests that add integration information to the TRACE.OUT file.
2. Convert that information to a set of integration strings.
3. Add the integration strings to the 1001.PBX file in the C:\AMANDA\PBX.DB direc-
tory using the Setup or JOVE utilities. 
N
OTE:See “Chapter 12: Utilities,” in Administering [email protected] 
for information about JOVE.
Depending on the telephone switching system you selected when you defined dial codes 
(see “Defining Dial Codes” on page 11), some of the integration patterns might be already 
filled in. Many telephone switching systems are programmable, so existing patterns on the 
System Integration Patterns screen may still need modification.
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.
Setting Up the Trace File
To check that trace files are being created:
1. Shut down Amanda if it is running
2. At the DOS prompt, type the following to go to the root directory:
CD\
3. Then press Enter. 
4. Edit the Amanda.bat file by typing:
JOVE AMANDA.BAT
5. Then press Enter.
The JOVE editor appears on the screen. Towards the bottom of the page is a line that 
starts RAMANDA. You are ready to proceed if the line reads: 
						

							26 Installing [email protected]
RAMANDA /t5 /s1300 %1 %2 %3
If not, edit the line so that it is identical to this line. 
6. To save and close the file, press the four following key combinations in order:
Ctrl+X 
Ctrl+S 
Ctrl+X 
Ctrl+C
7. At the DOS prompt, change directories to the pbx database by typing:
 CD\AMANDA\PBX.DB
Then press Enter. 
8. Edit the Pbx file by typing:
JOVE 1001.PBX
9. Then press Enter. 
10. Press Page Down display the lower portion of the file where the integration (if any) is 
displayed. 
11. Use Down Arrow to move the cursor to the bottom of the file to a blank line. 
12. Type the following:
integration 10  ‘rrrrrrrrrr’ 
This new integration string will capture up to 10 digits of In Band Signaling that will 
be displayed in the trace file for later inclusion in 1001.PBX.
13. To save and close the file, press the four following key combinations in order:
Ctrl+X 
Ctrl+S 
Ctrl+X 
Ctrl+C
14. At the DOS prompt, type:
CD\
15. Then press Enter. 
16. Start Amanda by typing:
AMANDA
17. Then press Enter.  
						

							Chapter 6: Defining Integration Patterns 27
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.
 Select a third extension that forwards on Busy to Amanda.
 Select a fourth extension that forwards to the third extension on Busy.
 Select a fifth extension that forwards all calls to Amanda.
 If applicable, create a hunt group that will forward back to Amanda if the hunt 
group is busy or rings without answer.
 Create a Direct Inward Line by having an outside CO trunk line ring at an exten-
sion that will forward on Ring No Answer and Busy to Amanda. Tests 5 and 6 be-
low do not have CO line identification enabled. Tests 7 and 8 do.
Running the Tests
To run the tests:
1. Start Amanda by typing the following at the DOS prompt:
amanda
2. Then press Enter.
Te s t  1
 Place a call to the extension that forwards on Ring No Answer to Amanda. Once 
Amanda has received the forwarded call, hang up.
Te s t  2
 Place a call to the second extension that is forwarded to the first extension. When 
Amanda has received the call, hang up.
Te s t  3
 Place a call to the third extension that forwards on Busy to Amanda. Make sure 
that the extension is offhook and connected to another extension or outside line. 
Once Amanda has received the busy forwarded call, hang up.
Te s t  4
 Place a call to the fourth extension that is busy forwarded to the third extension. 
Make sure that both extensions are offhook and either connected to each other, or 
to outside lines. Once Amanda has received the busy forwarded call, hang up.
Te s t  5
 Call in on the CO line that is directed to an extension that is forwarded to Amanda 
on Ring No Answer. Make sure that CO Line ID is disabled. Once Amanda re-
ceives the call, hang up.
Te s t  6
 Call in on the CO line that is directed to an extension that is forwarded to Amanda 
on Busy. Make sure that the CO Line ID is disabled. Once Amanda receives the 
call, hang up. 
						

							28 Installing [email protected]
Te s t  7
 Repeat test 5 with CO Line ID enabled.
Te s t  8
 Repeat test 6 with CO Line ID enabled.
Te s t  9
 Call directly into Amanda from any extension. When Amanda answers the call, 
hang up.
Reading the Trace File
To read the trace file:
1. Shut down Amanda.
2. At the C:\AMANDA> prompt, type:
JOVE TRACE.OUT
3. Then press Enter.
The first line should read similar to:
Oct 09 15:51:00 Begin trace of Amanda…
4. Press Ctrl+S to perform a search.
5.  Type the following search text:
Using dtmf
6. Then press Enter.
The JOVE editor searches for the first call’s integration string. The cursor should 
move to the trace line that reads similar to:
Oct  09 15:53:00 ichan01: Using dtmf data:  #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 digits could be any combina-
tion of DTMF digits. For example, the AT&T Partner sends:
#03##123#
The #03## is the Ring No Answer code, and the 123# is the extension number that 
forwarded. Different telephone switching systems (and often different models) send 
different digits.
7. WRITE DOWN THE INTEGRATION INFORMATION FOR THIS CALL.
8. Press Ctrl+S again.
9. Keep the same search string by just pressing Enter.
You should progress to the next call’s digits. 
10. WRITE DOWN THE INTEGRATION INFORMATION FOR THIS CALL. 
						

							Chapter 6: Defining Integration Patterns 29
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 combinations:
Ctrl+X 
Ctrl+C
To decide what integration strings to add to 1001.PBX:
1. Look at the integration string from Test 1. This represents a Ring No Answer call that 
forwarded to Amanda. Locate the characters that match the extension number that 
forwarded. On your notepad, rewrite the string so that the extension number is 
replaced by the lower case letter r’s. For example, if your string was  “#123”, then 
your new string would be “#rrr”. In the case of the Partner example, the “#03##123# 
would be changed to “#03##rrr#.
N
OTE:You may have 2, 3, 4 or more digits in your extension numbers. The 
number of r’s will match the number of digits in your extension dial 
plan.
2. Go to the integration string for Test 2. It may be similar to the one above, or it may 
contain a more complex string that has both the first and second extensions listed. If 
the string is identical to the previous string (for example, #03##123#), draw a line 
through it on your notepad. 
If both extensions are listed, determine which number was the first extension (origi-
nally called) and which was the second extension. If your string looks similar to 
“#122123”, then the 122 was the second extension, and 123 was the first extension. 
On your string, replace the first extension with the lower case r’s and the first exten-
sion with lower case s’s. Our example would look like “#sssrrr”. The Partner would 
change from “#03##122#123#” to #03##sss#rrr#”. 
3. The integration string from Test 3 may be identical to the string from Test 1 (except 
for the extension number). If so, draw a line through it. 
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”. 
4. The integration string from Test 4 may be identical to the one from Test 3. If so, draw 
a line through it. 
If not, then identify the first extension number and replace the number with lower 
case b’s. Identify the second extension number and replace the number with lower 
case s’s. Your string may have looked like “*122123” and should now look like “*sss-
bbb”.
5. The integration string from Test 5 is to differentiate a trunk based call from a station 
based transfer if the switch offers this level of differentiation. If this string is identical 
to string one or three, draw a line through it. 
If not, evaluate the new string to see what other information was sent in addition to 
“123” which is the forwarding extension. If the integration string contains the trunk 
ID number (even though it is supposed to be disabled), replace the numbers with 
either x’s (if the trunk ID is insignificant). 
						

							30 Installing [email protected]
6. Repeat step 5 for the string from Test 6, but replace the extension number with b’s 
rather than r’s.
7. Repeat step 5 for Test 7. If the string is identical to the one from Test 5, draw a line 
through it.
8. Repeat step 5 for Test 8, but replace the extension number with b’s rather than r’s. If 
the string is identical to the one from Test 6, draw a line through it.
9. Test 9 captures the signaling for a direct call into voice mail. The integration string 
probably includes a prefix (usually 1 digit—but it could be several digits) and the 
extension number of the calling user. Replace the extension number with e’s.
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 differ-
ent. For example, using the following dial codes:  
1***eee, #02#sss#rrr#, and 
#03##rrr#, the dial code masks are 1***000, #02#000#000#, and #03##000#, 
which are all different. If any dial code masks are the same, you must modify the 
duplicates or delete them. 
Adding Integration Strings
You can define integration patterns using either one of the following:
  The Setup utility
 The JOVE editor to edit 1001.PBX.
To define DTMF integration patterns using the Setup utility:
1. Run Setup as explained in “Chapter 3: Running the Setup Utility.”
2. From the Configuration Utility menu, press 3 to select Telephone System Integration 
Patterns.
The Telephone Switch Type screen appears.
3. From the Telephone Switch Type screen, select the name of your .PBX file then press 
Enter. 
						

							Chapter 6: Defining Integration Patterns 31
The Integration Patterns screen appears. Its first line tells the name and code (a num-
ber between 1001 and 2001) for your switching system (if they appear in the .PBX 
file). The following example shows a Toshiba model.
4. 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 system. A suggested value for 
this timeout is 10 (which equals 1 second). In some cases you may need a value of 15 
or 20.
Depending on the telephone switching system you selected when you defined dial 
codes (See “Defining Dial Codes” on page 11), some of the integration patterns might 
be already filled in.
N
OTE:To move from the timeout field to the integration patterns and vice 
versa, press Ctrl+Home.
5. Many telephone switching systems are programmable, so existing patterns on the 
System Integration Patterns screen may still need modification.
Do one or more of the following:
 Verify that the existing patterns are accurate by checking the manual 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. If the #6 is accurate, but you plan to have three or four-digit 
extension numbers, you must do some editing. For three-digit numbers, change 
the Ring No Answer pattern to #6rrr instead of #6rr.  (See “Using Character 
Codes” on page 32 for more information about rrr and other codes.)
 Delete a pattern by deleting all the characters in it.
To add integration strings to 1001.PBX using JOVE:
1. At the prompt, type:
CD PBX.DB
2. Then press Enter. 
						

							32 Installing [email protected]
3. Type:
JOVE 1001.PBX
4. Then press Enter. This is the same file we edited earlier.
5. Press Down Arrow until you select the line that reads:
integration 10  ‘rrrrrrrrrr’
6. Press Delete to remove this line.
7. Take the integration strings you created in the previous procedure. Type each one on a 
separate line in 1001.PBX. For example:
integration 10  ‘#03##rrr#
integration 10  ‘#03##sss#rrr#
integration 10  ‘#00#ee#
N
OTE:The 10 is a suggested value for the timeout. 10 equals 1 second. Any 
other value is the amount of time that Amanda will wait for informa-
tion from the telephone switching system. In some cases you may 
need a value of 15 or 20. A value of 0 prevents integration. 
These are in addition to the dial codes and any other integration strings that may have 
been in the original file. Enter them at the end of the file. Do not duplicate lines, but 
do remove any lines that are inaccurate.
8. To save and close the file, press the four following key combinations in order:
Ctrl+X 
Ctrl+S 
Ctrl+X 
Ctrl+C
To  r e s t a r t  A m a n d a :
1. At the DOS prompt, type:
CD\
2. Then press Enter.
3. Type:
AMANDA
4. Then press Enter.
Using Character Codes
You must modify the DTMF patterns so that the integration patterns become general (not 
specific to extensions 111 and 127). Call states and extension information are defined by 
using one of the character codes shown below. 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 the 
calls.