Amanda Work Group 7xx Installation Manual

							Chapter 7:
Defining Integration Patterns
Selecting a PBX File
The 1001.PBX file installed on your Amanda system by this installation 
program is good for 2-digit and 3-digit extensions. The Amanda Company 
provides some additional PBX files. If you need the information contained in 
one of them, you can copy it as 1001.PBX. (Amanda uses only 1001.PBX 
for integration purposes.)
PBX FileContains Integration Information For:
1002.PBX 2-digit extensions only
1012.PBX2-digit extensions and tenant service
1003.PBX3-digit extensions only
1013.PBX 3-digit extensions and tenant service
1004.PBX4-digit extensions only
1014.PBX4-digit extensions and tenant service
1007.PBX7-digit extensions only
1017.PBX7-digit extensions and tenant service 
						

							82 Installing [email protected]/DOS
For a tenant service (in which different lines are answered by different 
companies, departments or even IVR applications), you must do the 
following:
 Copy the appropriate PBX file (1012.PBX, 1013.PBX, 1014.PBX, 
or 1017.PBX) as C:\AMANDA\PBX.DB\1001.PBX.
 Make sure that the Norstar KSU’s line name ends with three digits. 
For example, Line001 or Line888.
 Create a mailbox with the same number as that in the name of the 
line. 
Do one of the following:
- Use that mailbox as the Company Greeting mailbox for that line. 
For example, if the line is Line888, then mailbox 888 can be the 
Company Greeting mailbox for the company or department that 
will answer that line. 
- Cause Amanda to go from that mailbox to the correct Company 
Greeting mailbox. For example, if lines 1 and 2 support two compa-
nies that share an Amanda system, mailboxes 1 and 2, correspond-
ing to Line001 and Line002, can have @G(990) in their Extension 
fields—causing Amanda to play one company’s greeting. mail-
boxes 3 and 4, corresponding to Line003 and Line004, can have 
@G(880) in their Extension fields—causing Amanda to play the 
other company’s greeting.
For more about Company Greeting mailboxes, see Administering 
[email protected]/DOS.
 For more information about tenant service, see “Sharing Amanda” on 
page 121.
To copy a PBX file as 1001.PBX:
1. If Amanda is running, shut down the Amanda system:
a. Press Alt+S (if Amanda is running as a standalone) or s (if 
Amanda is running as a voice server).
b. Type in the password. (The default is AMandA with only the 
first two and the last letter capitalized.)
c. Press Enter. 
						

							Chapter 7: Defining Integration Patterns 83
d. Press Y (to confirm the shutdown).
e. Press Y again (to reconfirm).
2. At the DOS prompt, type:
CD C:\AMANDA\PBX.DB
You will see a new DOS prompt, something like:
C:\AMANDA\PBX.DB>
3. At the DOS prompt, type:
COPY 1001.PBX 1001.BAK
4. At the DOS prompt, type:
COPY 10xx.PBX 1001.PBX
where 10xx represents the name of the .PBX file that meets your needs.
Using Character Codes
To modify the DTMF patterns in the 1001.PBX file, you need to know that 
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. 
The character codes in the integration patterns are defined as follows (with 
examples for 3-digit and 4-digit extensions):
CodeDefinition
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 mes-
sage for mailbox bbb (or bbbb) or the system busy message. 
						

							84 Installing [email protected]/DOS
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 record-
ing 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 170 for infor-
mation about how the system greeting can be played when an integrated 
call has both the rrr and sss (or rrrr and ssss) fields set.
sInformation regarding where the call came from (for handling message re-
plies) 
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 mailboxes for all tele-
phones, even those in the file room and lobby.
CodeDefinition 
						

							Chapter 7: Defining Integration Patterns 85
tTrunk call or CO line ID; this is used for dynamic port allocation.
When “Tttt”  appears in the integration string, Amanda matches lines with 
the name LINE (upper or lowercase) followed by three-digits, then Aman-
da processes mailbox ttt.
Whenever a call comes in on trunk line LINE703, for example, mailbox 
703 is processed. If four trunk lines support two companies that share an 
Amanda system, the mailboxes matching the first two line names can have 
@G(990) in their Extension fields—causing Amanda to play one compa-
ny’s greeting. The mailboxes matching the next two line names can have 
@G(880) in their Extension fields—causing Amanda to play the other 
company’s greeting. See “Sharing Amanda” on page 121 for details.
N
OTE:
When only ttt appears in the integration pattern, Amanda pro-
cesses mailbox ttt normally. 
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.
CodeDefinition 
						

							86 Installing [email protected]/DOS 
						

							Chapter 8:
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. 
For a complete list of the configuration options, see “Chapter 14: 
Configuration Reference.”
Configuring Amanda for Your KSU
To configure Amanda to work with your KSU, the following configuration 
options must be set correctly: 
smdi_base_port must be the number of the lowest DN connected to 
Amanda. The default is 241, which might not be appropriate for your 
KSU.
cfg_port should be the DN with least incoming traffic (The default 
is 3—assuming that it has the least traffic on a 4-port system which 
uses port 4 for notification.) 
notify_restriction should be the highest number port connected to 
Norstar. (The default is 4—assuming a 4-port system.) This port 
should forward to the first port which forwards the rest of the ports. 
However, no port should forward to the notify_restriction port. 
						

							88 Installing [email protected]/DOS
Using the Questionnaire
Use this “First Use” questionnaire to find out how your customers prefer to 
use their Amanda system. Use the results as you run Setup to set 
configuration options, and as you create the mailbox template (usually 
mailbox 997). Then create mailboxes for users. It comes in both a standalone 
and voice server version because setting up mailboxes is different in Amanda 
Administrator.
Question Column
The questions address:
 How Amanda handles all callers.
 How Amanda interacts with most users. You assign new users the 
options that give them an initial, usable mailbox configuration. After 
each mailbox has been created, the System Administrator can 
change these options, and the users themselves can change some op-
tions.
 System Administration issues.
During your interview with the client, you will use the Question and Circle 
Response columns in this questionnaire to select the Amanda features for 
this site.
Location Column
You will use the Location and Action columns to implement these features 
on Amanda. The Location column uses this symbol 
→ to separate the choices 
you must make at each menu level to select the feature from the correct 
Amanda screen. For example, “In the Setup utility, select System 
Configuration Options
→General Configuration→Incoming Calls” means “In 
the Setup utility, first select Configuration Options, then select General 
Configuration, then select Incoming Calls.”
In the voice server version of the questionnaire, questions 10, 12-23, and 25 
(for Amanda Administrator), the Location column directs you to the default 
mailbox template (usually 997) that you use to set up new mailboxes. The 
Location column directions assume that you are already logged on to  
						

							Chapter 8: Configuring Amanda 89
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):
1. Start Amanda Administrator.
The Administrator Logon dialog box appears.
2. Enter your password in the Logon dialog box.
The mailbox List dialog box appears.
3. Enter 997 (or the mailbox for the default template).
The Mailbox window displays template 997.
To display the Mailbox window (if you are already logged onto Amanda 
Administrator but displaying another window):
1. Click the Mailbox menu and select mailbox. 
The mailbox List dialog box appears.
2. Enter 997 (or the mailbox for the default template).
The Mailbox window displays template 997.
The Location column includes the name of the configuration option (also 
called a parameter) for each feature. The current options and their settings 
are stored on the Amanda server in C:\AMANDA\INSTALL.CFG. You can 
view them using the Setup utility. From Setup, select System Configuration 
Options
→Advanced Configuration→General.  
						

							90 Installing [email protected]/DOS
Standalone Questionnaire 
QuestionCircle
ResponseLocation and 
Amanda ParameterAction
1)  Amanda normally says “Please 
hold while I try that extension for 
you” as she transfers a call. This fea-
ture can be turned off. 
Do you want Amanda to say “Please 
hold….?”YESIn the Setup utility, select
System Configuration 
Options→
General 
Configuration→
Incoming Calls.Set the Amanda Says “Please Hold 
While…” check box to T for True, 
which is the default.
NOAmanda parameter is 
please_holdSet the Amanda Says “Please Hold 
While…” check box to F for False
You can also bypass this message for 
individual mailboxes using the Token 
Programming Language (although 
only blind transfers are supported).
2)  Do you want Amanda to verify 
that a caller is still on the telephone 
before transferring the call to an op-
erator?
(Amanda asks the caller to “Say yes 
at the tone” before transferring the 
call.)YESIn the Setup utility, select
System Configuration 
Options→
General 
Configuration→
Incoming Calls.Set the Amanda Says “Please Say 
‘Yes’…” check box to T for True.
NOAmanda parameter is 
dtmf_gateSet the Amanda Says “Please Say 
‘Yes’…” check box to F for False, 
which is the default. 
3)  Do you want callers to be able to 
hold for busy extensions?YESIn the Setup utility, select
System Configuration 
Options→
General 
Configuration→
Incoming Calls.
Amanda parameter is 
cancel_busy_holdSet the Caller Can Hold check box to 
T for True, which is the default.
NOSet the Caller Can Hold check box to 
F for False.
4)  If YES to 3, do you want active 
or inactive hold?
On active hold, the caller is prompt-
ed to press * to remain on hold.
On inactive hold, the caller takes no 
action to stay on hold.
(800 numbers benefit from using ac-
tive hold, because the caller cannot 
leave the telephone unattended.)ACTIVEIn the Setup utility, select
System Configuration 
Options→
General 
Configuration→
Incoming Calls.
Amanda parameter is 
active_holdSet the Active Hold check box to T for 
True, which is the default.
INACTIVESet the Active Hold check box to F for 
False.