Amanda Work Place Instructions Manual

							Chapter 4: Defining Dial Codes13
Dial Codes Table
Dial Code LabelDescription
What to dial to put the caller 
on transfer hold:The code Amanda dials to ask the telephone switching system to put the caller on 
transfer hold before she transfers a caller to an extension. 
Usually, this code is “F-” (a hookflash followed by a half-second pause). This may 
need to be changed to “F--” (a hookflash followed by a one-second pause) or “F,” 
(a hookflash followed by a two-second pause) for telephone switching systems that 
are slow to provide a transfer dial tone after a hookflash. (Don’t use the quotation 
marks in the dial code.)
If tmo_dtwait is greater than 0, the number of dashes set for this option is irrelevant. 
Use the value 0 for tmo_dtwait for faster call processing. For more information 
about tmo_dtwait, see “What to dial to put the caller on transfer hold:” on page 13.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_dtwait option. 
What to dial when there is no 
transfer dial tone: The code Amanda dials to return to the caller if both of the following are true:
You configure Amanda to wait for a transfer dial tone before transferring a call to 
an extension
There is no transfer dial tone
In this case, Amanda treats the attempted transfer as though the extension was busy.
Some telephone switching systems use “F-”, others use “-”. (Don’t use the quotation 
marks in the dial code.)
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_ndtret option. 
What to dial to return to the 
caller after ring no answer: During supervised transfers, if the extension rings the specified number of times but 
is not answered, Amanda dials this code to ask the telephone switching system to 
reconnect the caller to Amanda. (See “Using the Questionnaire” on page 37 for 
more information about configuring the number of rings.) 
Usually, this code is “F-”. (Don’t use the quotation marks in the dial code.)
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_rnaret option. 
What to dial to return to the 
caller after busy: During supervised transfers, Amanda dials this code to ask the telephone switching 
system to reconnect the caller to Amanda if the extension is busy. 
Usually, this code is “F-”. (Don’t use the quotation marks in the dial code.)
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_bsyret option. 
What to dial after a call 
screening reject: The code Amanda dials to reconnect to the caller if all of the following are true:
Amanda is performing a supervised transfer
Call screening is ON
The user at the extension that was called rejects the caller
In this case, Amanda plays the mailbox’s current greeting.
Usually, this code is “F-”. (Don’t use the quotation marks in the dial code.)
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_hupret option.  
						

							14 Installing [email protected]
What to dial to connect a 
caller to an extension: During supervised transfers, Amanda dials this code to complete the call transfer af-
ter detecting an answer at the called extension. If call screening is ON, Amanda dials 
this code only after the user at the extension accepts the call.
Usually, this code is “H” (for Hang up). (Don’t use the quotation marks in the dial 
code.)
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_connect option. 
What to dial before the mail-
box extension: If Amanda needs to dial something after dial tone detection, but before dialing the 
extension number, enter that code here. 
Usually this is left blank.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_prefix option. 
What to dial after the mail-
box extension: If Amanda needs to dial something after dialing the extension number, enter that 
code here. 
Don’t use an “H” for a blind transfer here because this setting is global. Sometimes 
you need “1-” to bypass the hands-free answer feature (voice announce) on some 
telephone systems. (Don’t use the quotation marks in the dial code.)
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_suffix option. 
What to dial on each port af-
ter the system starts: If you want Amanda to dial some initialization codes when she first starts up, define 
those codes here. For example, you may want to remove call forwarding on the 
ports.
Usually this is left blank.
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 be-
fore shutdown: If you want Amanda to dial certain codes when she shuts down, define those codes 
here. For example, enabling call forwarding on the ports lets a live operator take the 
calls when Amanda shuts down.
Usually this is left blank.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_stop option. 
What to dial when a port 
goes off-hook: If Amanda must dial some special codes as she goes off-hook to enable a special 
feature, define those special codes here. For example, you may enable special types 
of SMDI integration over a serial port.
Usually this is left blank.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_pickup option. 
Dial Codes Table (Continued)
Dial Code LabelDescription 
						

							Chapter 4: Defining Dial Codes15
What to dial to create or 
record a conference call:Controls how to do a conference call when the called party answers the telephone.
You provide the digits used to conference the caller, called party, and Amanda (for 
example, “*3”). (Don’t use the quotation marks in the dial code.) If your telephone 
switching system does not have this capability, leave it blank.
For example, if the Extension field for a mailbox contains 127KM, Amanda dials 
127. When an answer is detected, Amanda dials the conference dial code (such as 
“*3”) which conferences the caller, the called party, and Amanda. Instead of hang-
ing up when she connects the two parties, Amanda records the conversation as a 
message in mailbox 127. 
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_conference option. 
Number of seconds to wait 
for dial tone detection: This is the number of seconds Amanda waits for your telephone switching system 
to provide a continuous dial tone for one full second. If your system has few DTMF 
receivers or intercom paths for call transfers, one may not be immediately available 
for 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. The range is 0–127.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the tmo_dtwait option. 
Number of 1/100 seconds to 
use for Flash time: Determines how long Amanda remains on-hook while performing a hookflash. The 
value is in hundredths of seconds.
The usual value is 55 (just over half a second).
When set too short, the hookflash does not happen; when set too long, it hangs up.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the flashtm option. 
Which DTMF tone to listen 
to for hangup detection: If your telephone switching system plays a specific DTMF tone or sequence of tones 
when a caller hangs up (to make hangup detection faster), enter that DTMF digit 
here. 
If your telephone switching system has this capability, the code is usually the letter 
“d” which represents DTMF D. This may be a sequence of DTMF digits rather than 
a single DTMF digit. The maximum length is 10 characters. If your system does not 
support this feature, leave it blank.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dt_hangup option. 
What to dial to turn on the 
message waiting indicator:Controls what DTMF digits are dialed by Amanda to enable message notification 
automatically when a new message is left. This value is used only with the KA(1) 
token. 
Most popular telephone switching systems have a default value. If this field is blank 
for your switching system, enter the DTMF digits which enable a message waiting 
indicator on your telephone sets. To have Amanda dial these digits, use KA(1) in 
the notify method field. Amanda replaces KA(1) with these digits. For more infor-
mation, see “KA(on_off)” on page 147 for more information.
N
OTE:New installations automatically have notification templates that turn message wait-
ing indicators on and off. using the KA(1) token.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_light_on option.
Dial Codes Table (Continued)
Dial Code LabelDescription 
						

							16 Installing [email protected]
What to dial to turn off the 
message waiting indicator:Controls what DTMF digits are dialed by Amanda to disable message notification 
automatically when a new message is played or deleted. This value is used only with 
the KA(0) token. 
Most popular telephone switching systems have a default value. If this field is blank 
for your switching system, enter the DTMF digits which disable a message waiting 
indicator on your telephone sets. To have Amanda dial these digits, use KA(0) in 
the notify method field. Amanda replaces KA(0) with these digits. For more infor-
mation, see “KA(on_off)” on page 147 for more information.
N
OTE:New installations automatically have notification templates that turn message wait-
ing indicators on and off. using the KA(0) token.
If you are editing C:\AMANDA\PBX.DB\1001.PBX instead of using Setup, this is 
the dl_light_off option.
Dial Codes Table (Continued)
Dial Code LabelDescription 
						

							Chapter 5:
Defining Tone Patterns
Using GetTones
Amanda must recognize telephone switching system tone patterns when performing 
supervised transfers. The Setup utility runs another utility, named GetTones, to “learn” the 
tone patterns for ringing, busy, hang-up, and reorder (also called fast busy). 
Before running the GetTones utility, you must have satisfied all of the following 
requirements:
 Define the dial codes. See “Defining Dial Codes” on page 11.
 Connect ports 1 and 2 (the top RJ-14 jack of the first Rhetorex board) to valid, 
working single-line extensions on the telephone switching system.
 Know the extension number to which port 1 is connected.
 Verify that the extension to which port 1 is connected is not in any hunt group, and 
does not have any call forwarding programmed.
 Verify that the extension to which port 2 is connected has outside line access and 
can dial a test telephone number that is answered and does not hang up after an-
swering (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.
To define telephone switching system tone patterns:
1. Make sure that you have satisfied all the above requirements.
2. Run Setup as explained in “Running Setup” on page 9.
3. From the Configuration Utility menu, press 2 to select Telephone System Tone Pat-
terns.
The GetTones for Rhetorex Voice Boards screen appears. 
						

							18 Installing [email protected]
4. By default, the output file has the same name as your .PBX file. However, it ends with 
the extension .TON.
5. Enter the outdial code, port 1’s station number, the reorder code, and the RNA station 
number. Use the Up Arrow, Down Arrow, Tab, or Enter key to move from one entry 
to the next.
6. Press F4 to run GetTones.
GetTones obtains the ring, busy, reorder, and hangup patterns of the telephone switch-
ing system. Messages appear on your screen as the utility gets and tests these patterns.
N
OTE:If you have problems with the GetTones utility, such as not getting good 
patterns or not being able to verify a tone pattern, try using AccuCall 
Plus, a Rhetorex utility that also captures tone patterns. See “Using Ac-
cuCall Plus” on page 18.
Using AccuCall Plus
The C:\AMANDA\PBX.DB\1001.TON file defines the tone patterns that the telephone 
switching system returns to Amanda. Amanda recognizes these tones and uses her 
knowledge of them when she transfers calls. AccuCall Plus is a Rhetorex utility that 
allows you to set up ring, busy, reorder/fast busy/error, and special tone (such as a fax 
CNG tone) definitions. 
This section is primarily for running tests that create new .TON files. If your telephone 
switching system performs inband signaling integration, you may not need the Ring No 
Answer (RNA) or ringback pattern. 
outdial codeType the outside line access and telephone 
numbers for a connection to test for tone pat-
terns (such as the time or weather number). 
For example:
9,5551111
Then press Enter.
port 1 station numberType the extension for a standalone (no call 
hunting or forwarding) single-line (analog) ex-
tension connected to port 1.
Then press Enter.
reorder codeType any dial code that generates a reorder tone 
pattern on the telephone switching system. 
Typically, invalid extension numbers work 
well, for example, 555 generally works. If not, 
try 444 or 777 or any number that generates a 
fast busy tone pattern.
Then press Enter.
Ring No Answer
station numberType a non-Amanda extension that has a tele-
phone connected and is not answered or call 
forwarded. If voice-announce or call-an-
nounce is enabled, remember to enter the ex-
tension plus the additional digit or digits that 
force the extension to ring. For example, if the 
RNA test station is 112, type:
1121-
Then press Enter. 
						

							Chapter 5: Defining Tone Patterns 19
You might edit an existing file to adjust the cadence or the percentage of variation. For 
example, suppose a ring is usually one second on followed by three seconds off. However, 
sometimes it is a bit shorter or longer. You may want to increase the percentage of 
variation to allow for the differences. If the busy and reorder tones are very similar, you 
might need to reduce the percentage of variation to differentiate between them.
Amanda must be shut down before you run AccuCall Plus.
To shut down Amanda:
1. If Amanda is running, press Alt+S.
2. Type in the password. (The default is AMandA with only the first two and the last let-
ter capitalized.)
3. Press Enter.
4. Press Y (to confirm the shutdown).
5. Press Y again (to reconfirm).
When the C:\AMANDA prompt appears, you can start running AccuCall Plus.
To run AccuCall Plus:
1. Change directory to C:\ACCUCALL by typing:
cd c:\accucall
2. Press Enter.
3. 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:
accucall C:\AMANDA\PBX.DB\@1.TON
4. Press Enter.
The AccuCall Plus main screen has several options. The list of function keys at the 
bottom of the screen indicate which keys go with each option. 
						

							20 Installing [email protected]
5. Select “AUTO RUN” by pressing F6.
To define the Ring No Answer (RNA) tone pattern:
1. 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. 
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. 
						

							Chapter 5: Defining Tone Patterns 21
8. After AccuCall Plus has determined the system tone pattern, you can customize the 
tone description using the Edit Tones box:
Name: Example:  Panasonic Double Ring
Type: Ring1 if single ring, single pause
Ring2 if double ring, single pause
Terminating: NO
Cadence: NO
Frequency1: Determined by test
Frequency2: Determined by test
PCPM Code: 8 (always for ring 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. 
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.
12. Then press F10 to save this information and return to the main screen.
N
OTE:All the listed frequencies must be at least 40 Hz apart so Amanda can 
distinguish them.
To define the Busy tone pattern:
1. Fill in the telephone number for an extension that is offhook and connected to either 
another internal extension or to an outside line.
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. 
						

							22 Installing [email protected]
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 Busy
Type: Busy1 if regular busy cadence
Busy2 if double busy cadence
Terminating: YES (always)
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
N
OTE:A normal single busy tone is approximately 500 msec on and 500 
msec off.
9. Save the tone by pressing F8 (twice).
10. Press F8 to add the tone.
11. 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. 
12. 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 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 taking control of the call.
13. Then press F10 to save this information and return to the main screen.