Amanda Work Group Installation Manual

							Chapter 9: Defining Integration Patterns 79
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. For example, using the fol-
lowing 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 “Running Setup” on page 49.
2. From the Configuration Utility menu, press 3 to select Telephone Sys-
tem 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. 
						

							80 Installing [email protected]/DOS
The Integration Patterns screen appears. Its first line tells the name and 
code (a number 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 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.
Depending on the telephone switching system you selected when you 
defined dial codes (see “Defining Dial Codes” on page 51), some of the 
integration patterns might be already filled in.
N
OTE:To move from the timeout field to the integration pat-
terns and vice versa, press Ctrl+Home.
5. Many telephone switching systems are programmable, so existing pat-
terns on the System Integration Patterns screen may still need modifica-
tion. 
						

							Chapter 9: Defining Integration Patterns 81
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. 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 82 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.
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# 
						

							82 Installing [email protected]/DOS
NOTE: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 information 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 restart Amanda:
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. 
						

							Chapter 9: Defining Integration Patterns 83
The character codes in the integration patterns are defined as follows:
CodeDescription
bBusy call state
When bbb (or bbbb) appears in the integration pattern, Amanda checks 
the Busy Chain. If the Busy Chain is blank, she plays the custom busy 
message for mailbox bbb (or bbbb) or the system busy message.
cANI 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.
eDirect dial call state (used to access a mailbox directly by Amanda asking 
for a security code) 
When eee (or eeee) appears in the integration pattern, Amanda assumes 
the caller wants to log in to mailbox eee (or eeee) and asks for the security 
code.
iImmediate record call state (plays the record tone and starts recording a 
message)
When iii (or iiii) appears in the integration pattern, Amanda begins re-
cording a message for mailbox iii (or iiii) without playing a prompt first.
rRing-no-answer call state that indicates who the call was for and that it 
was not answered
When rrr (or rrrr) appears in the integration pattern, Amanda checks the 
Ring No Answer (RNA) Chain. If the RNA Chain is blank, she plays the 
current greeting for mailbox rrr (or rrrr) or the system greeting.
See the configuration option “integration_greeting” on page 196 for in-
formation about how the system greeting can be played when an integrat-
ed call has both the rrr and sss (or rrrr and ssss) fields set.
sInformation regarding where the call came from (for handling message 
replies) 
If sss (or ssss) is found in the integration pattern along with b’s or r’s, 
Amanda recognizes mailbox sss as the sender of the message—if one is 
left.
T
IP:
When using s’s, the integration requires User IDs for all tele-
phones, even those in the file room and lobby. 
						

							84 Installing [email protected]/DOS
Realize that the character codes you use define not only the placement of the 
extension information in the pattern, but also the call state, that is, Ring No 
Answer, Busy, Direct, and so forth. Therefore, you can control Amanda’s 
behavior based upon your specific requirements. For example, if your 
customer does not wish to allow for Busy call states, then modify the 
integration character codes and replace the b’s with r’s.
Some telephone switching systems have timing problems that cause the first 
DTMF digit to be missed. In such cases, it is useful to add integration 
patterns that are variations of the current patterns. For example, you might 
add a second pattern for Direct calls (
1***eee in our example) as ***eee. 
These are identical—except the first digit is missing in the second pattern. 
You can also try reducing the delay time (Delay option on SMDI tab in Setup 
utility).
Never remove leading digits from a pattern if they differentiate this pattern 
from another or if they are “active” digits (such as r’s and b’s).
tTrunk 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. If trunk lines 1 to 20 support two 
companies that share an Amanda system, mailbox’s 1–10 can have 
@G(990) in their Extension fields—causing Amanda to play one compa-
ny’s greeting. mailbox’s 11–20 can have @G(880) in their Extension 
fields—causing Amanda to play the other company’s greeting. 
xWild card that matches anything (use this carefully) 
For example 6xxxx would match every inband signaling string that had 
a 6 followed by four other characters.
CodeDescription 
						

							Chapter 9: Defining Integration Patterns 85
Running Integration Helper
If you know that your telephone switching system supports DTMF 
integration, the Integration Helper utility also allows you to determine the 
integration patterns. 
Before running the Integration Helper be sure that you:
 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.
 Make another extension available for placing test calls. The follow-
ing procedure assumes that this extension is 127.
To run Integration Helper:
1. Press F4 to run the Integration Helper utility.
The following appears on the screen:
Integration Helper—Waiting for a call on any 
port…To abort press ESC…
2. Place sample calls by calling from the available extension (127) to your 
test extension (111). Use these calls to generate DTMF tones so Integra-
tion Helper can capture them. You can capture Ring No Answer, Busy, 
and Direct call codes—using extensions and CO trunk lines. See “Plac-
ing Test Calls” on page 86.
3. As a code is captured, it appears on the Edit Integration Pattern screen. 
You see the captured pattern on two lines, one that is for display only 
and the other which you edit. For example, you need to replace exten-
sion numbers with patterns such as rrr for ring no answer. (See “Using 
Character Codes” on page 82 for more information.)
4. When you have finished, press Esc to return to the System Integration 
Patterns screen. The screen should be filled with the captured DTMF 
digits (per your edits) and the descriptions of those codes. 
						

							86 Installing [email protected]/DOS
Placing Test Calls
You can place test calls of the following types:
Available extension (127) calls the test extension (111) for Ring No 
Answer: 
After a Ring No Answer condition occurs, the call should be forwarded to 
the Integration Helper program which answers the call and captures the 
DTMF digits played by the telephone switching system. You define what 
type of test call you made.
Available extension (127) calls the test extension (111) while the test 
extension is Busy: 
Verify that the test extension (111) has been call forwarded Busy to the 
single-line ports you have programmed for Amanda. Make the test extension 
(111) Busy. From the available extension (127), call the test extension (111). 
The test extension (111) should forward to the single-line ports immediately 
after the Integration Helper captures the DTMF digits (if any).
Test extension (111) calls directly to Integration Helper: 
From the test extension (111), call the single-line ports. Integration Helper 
captures the DTMF digits (if any). Note that some telephone switching 
systems use different codes depending upon whether this direct call was 
made by dialing an extension or by pressing a message light. You should run 
both tests if you suspect this to be true of your system.
Available extension (127) using a CO line calls in and rings the test 
extension (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 
Integration Helper after a certain number of rings. 
						

							Chapter 9: Defining Integration Patterns 87
Available extension (127) using a CO line calls in while the test extension 
(111) is Busy: 
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.
Forward from Ring No Answer Example
You may have two patterns labeled “Forward from Ring No Answer.” Both 
should contain the extension number (111) that was call forwarded to the 
Integration Helper. This is the extension that did not answer. One of the 
patterns may contain the available extension number you called from (127). 
For example, suppose the integration patterns were:
#02#127#111# 
and 
#03##111
You replace the digits of the test extension (111, the extension that did not 
answer) with r’s and the digits of the telephone from which the call was 
made, 127, with s’s:
#02#sss#rrr# 
and 
#03##rrr 
						

							88 Installing [email protected]/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# 
and 
#03##rrrr
Direct Call Example
As a result of the Direct test call, one pattern should be labeled “Direct 
call…” and contain the extension number for the telephone from which you 
called (111). 
Replace the extension number with e’s. For example, change:
1***111
to:
1***eee
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:
1***eeee
Forward from Busy Example
For patterns labeled “Forward from Busy,” you replace the extension number 
that was busy with b’s. If there is a pattern that contains the extension from 
which the call was made, replace the extension number with s’s.