Amanda Work Group Manual

							Chapter 4:
Defining Integration Patterns
Using the Trace File for Integration
If your telephone switching system supports DTMF integration (also called inband 
integration), you must verify or set integration patterns for it using the Setup utility.
Depending on the telephone switching system you select, some of the integration patterns 
might be already filled in. Many telephone switching systems are programmable, so 
patterns supplied by The Amanda Company can still need modification.
When The Amanda Company could not supply integration patterns, you can usually find 
them in the manual that comes with your telephone switching system.
If all else fails, you can:
1. Perform tests that add integration information to the TRACE.OUT file.
2. Convert that information to a set of integration patterns.
3. Add the integration patterns to the 1001.PBX file in the C:\AMANDA\PBX.DB 
directory using the Setup or JOVE utilities. 
N
OTE:See “Chapter 12: Utilities,” in Administering Aman-
[email protected]/Windows for information about JOVE.
Using an Integration Pattern to Capture Data
To perform the tests, you use only one integration pattern in the 1001.PBX or 2001.PBX 
file. 
To create an integration pattern for use during testing:
1. From the Start menu, select Start⇒Amanda Server⇒Setup.
The Amanda Setup dialog box opens.
2. Select the Telephone Switch Integration tab. 
						

							32 Installing [email protected]/Windows
This process makes a backup copy of your current switching system settings—if you 
had any. The backup file is named 1001.BAK or 2001.BAK and can be renamed to 
1001.PBX or 2001.PBX at a later date to restore the original settings—if appropriate.
3. From either the PBX 1 or PBX 2 group box (depending on which switching system 
you are determining integration patterns for), select or reselect a telephone switching 
system from the list box.
Either select the exact system or one that is similar.
4. Set the dial codes for your switching system using the information in “Defining Dial 
Codes” on page 25.
5. Click Edit Integration Patterns. 
						

							Chapter 4: Defining Integration Patterns 33
The Integration Patterns dialog box opens. This dialog box may have no settings as 
shown in the next figure.
Or it may come with several predefined integration patterns for your telephone 
switching system. 
The next two figures show the predefined integration patterns for a Toshiba model 
and an AT&T model. 
						

							34 Installing [email protected]/Windows
Many telephone switching systems are programmable, so existing patterns may still 
need modification. You can verify that the existing patterns are accurate by checking 
the manual for your telephone switching system. 
T
IP:You can press Tab to move from setting to setting. Click Delete to 
remove any unnecessary integration patterns.
6. In the Integration First Digit Timeout spin box, select a number of tenths of seconds.
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.
7. Create the following pattern:
rrrrrrrrrr
This new integration pattern will capture up to 10 digits of In Band Signaling that will 
be displayed in the trace file for later inclusion in 1001.PBX or 2001.PBX.
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. 
						

							Chapter 4: Defining Integration Patterns 35
 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:
 Restart Amanda.
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.
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. 
						

							36 Installing [email protected]/Windows
Reading the Trace File
To read the trace file:
1. Shut down Amanda.
2. At the C:\AMANDA> prompt in the DOS box, 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 pattern. 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.
11. Repeat steps 8 through 10 until all 9 integration stings have been recorded. Some of 
the patterns 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
13. To exit the DOS box, type:
EXIT
14. Then press Enter. 
						

							Chapter 4: Defining Integration Patterns 37
To decide what integration patterns to add:
1. Look at the integration pattern 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 pattern so that the extension number is 
replaced by the lower case letter r’s. For example, if your pattern was “#123”, then 
your new pattern 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 pattern for Test 2. It may be similar to the one above, or it may 
contain a more complex pattern that has both the first and second extensions listed. If 
the pattern is identical to the previous pattern (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 pattern looks similar to 
“#122123”, then the 122 was the second extension, and 123 was the first extension. 
On your pattern, 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 pattern from Test 3 may be identical to the pattern 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 pattern 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 pattern would now look like “*bbb”. 
4. The integration pattern 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 pattern may have looked like “*122123” and should now look like 
“*sssbbb”.
5. The integration pattern 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 pattern is identi-
cal to pattern one or three, draw a line through it. 
If not, evaluate the new pattern to see what other information was sent in addition to 
“123” which is the forwarding extension. If the integration pattern 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).
6. Repeat step 11 for the pattern from Test 6, but replace the extension number with b’s 
rather than r’s.
7. Repeat step 11 for Test 7. If the pattern is identical to the one from Test 5, draw a line 
through it.
8. Repeat step 11 for Test 8, but replace the extension number with b’s rather than r’s. If 
the pattern is identical to the one from Test 6, draw a line through it. 
						

							38 Installing [email protected]/Windows
9. Test 9 captures the signaling for a direct call into voice mail. The integration pattern 
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 Patterns
You define integration patterns using the Setup utility.
N
OTE:Instead of using Setup, you can edit your .PBX file in the C:\AMAN-
DA\PBX.DB directory using the JOVE utility. See “Chapter 12: Utili-
ties,” in Administering [email protected]/Windows for information 
about JOVE.
Using Setup
To define DTMF integration patterns using the Setup utility:
1. From the Start menu, select Start⇒Amanda Server⇒Setup.
The Amanda Setup dialog box opens.
2. Select the Telephone Switch Integration tab. 
						

							Chapter 4: Defining Integration Patterns 39
Most companies have only one telephone switching system and it is probably already 
listed as the current switch in the PBX 1 group box. However, your company may 
have two telephone switching systems.
3. If the wrong telephone switching system is current or no telephone switching system 
has been selected, select the switching system for which you are setting dial codes 
from the current switch drop-down list box.
For example, if you are setting up a second switching system, you use the list box in 
the PBX 2 group box. Otherwise you use the list box in the PBX 1 group box.
4. Click Edit Integration Patterns.
The Integration Patterns dialog box opens. This dialog box may have no settings as 
shown in the next figure.
Or it may come with several predefined integration patterns for your telephone 
switching system. 
The next figure shows the predefined integration patterns for a Toshiba model. 
						

							40 Installing [email protected]/Windows
Many telephone switching systems are programmable, so existing patterns may still 
need modification. You can verify that the existing patterns are accurate by checking 
the manual for your telephone switching system. 
You can press Tab to move from setting to setting. Click Delete to remove any unnec-
essary integration patterns.
5. In the Integration First Digit Timeout spin box, select a number of tenths of seconds.
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.
6. In the Integration Interdigit Time spin box, select the number of tenths of seconds that 
Amanda waits between integration digits. The default is 10 (one second).
7. In the Integration Terminator text box, type a one-character string containing the char-
acter that terminates DTMF input. The default is the empty string.
8. Add, edit, or delete integration patterns as appropriate.
To add a pattern: 
1. Click Add.
2. Type the integration pattern in the box that appears.
To edit a pattern: 
 Make correcting in the existing pattern by adding, replacing, or deleting charac-
ters.
For example, if a 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 41 for more information about 
rrr and other codes.)
To delete a pattern:
 Click the Delete button beside the pattern to be deleted.
Using JOVE
JOVE can be used to edit the 1001.PBX or 2001.PBX files to add integration patterns, but 
it is easier to use the Setup utility.
To add integration patterns to 1001.PBX using JOVE:
1. Open a DOS box:
On the Start menu, click Programs, then MS-DOS Prompt.
2. At the DOS prompt, type the following to go to the PBX.DB directory:
CD C:\AMANDA\PBX.DB
3. Then press Enter.