Amanda Work Place Instructions Manual

							Appendix C: Configuration Reference 173
tmo_dtmfThe amount of time Amanda waits after a DTMF digit before deciding the caller has fin-
ished the entry. (If the caller presses #, Amanda immediately recognizes this as the end 
of a DTMF entry.)
Number of tenths of seconds (from 1 to 255). The default is 12 (1.2 seconds).
The default appears in install.cfg as:
set tmo_dtmf 12
tmo_holdDetermines how long Amanda waits after a caller presses * to hold for an extension that 
is busy before trying to transfer the call again. This is only used when the file 
C:\AMANDA\HOLD.VOX, which Amanda normally plays for callers on hold, is miss-
ing. Usually Amanda tries to transfer the call after playing the file.
Number of seconds. The default is 20. The range is 0 to 255.
NOTE:
You can record over HOLD.VOX using the system administration menu from the system 
administration mailbox (mailbox 999.) You may want to save the original first.
The default appears in install.cfg as:
set tmo_hold 20
tmo_idleNumber of seconds of inactivity after which Amanda decides that the port is idle. 
The default is 0. The range is 0-999. 
When greater than 0, Amanda goes off-hook and back on-hook after deciding that the 
port is idle. This is necessary when a telephone system does not release a station that is 
connected to Amanda even after Amanda has gone on-hook (a rare occurrence). 
When 0, Amanda does not go off-hook and back on-hook if a port is idle. 
The default appears in install.cfg as:
set tmo_idle 0
tmo_integrateDuring inband integration, this option causes Amanda to wait the specified number of 
seconds for the first digit to arrive. Then the seconds in the timeout period (specified in 
the .pbx file) begin. After the first digit arrives, Amanda continues to read digits until 
the timeout period ends.
The range is 0 to 255. The default is 0.
The default appears in install.cfg as:
set tmo_integrate 0
tmo_menuThe amount of time Amanda waits before repeating a menu when no selection is made. 
Number of tenths of seconds from 1 to 99. The default is 20 (2.0 seconds).
The default appears in install.cfg as:
set tmo_menu 20
tmo_pickupThe minimum amount of time Amanda waits between an on-hook and off-hook event.
Number of tenths of seconds from 1 to 99. The default is 20 (2.0 seconds).
The default appears in install.cfg as:
set tmo_pickup 20
tmo_rnaFor some PBXs, Amanda assumes that the called party is not going to answer the tele-
phone if there is no answer after a certain length of time. The amount of time she waits 
is the product of this setting times the maximum number of rings for a Ring No Answer. 
(The maximum number of rings is set per mailbox using the Maximum Rings field.)
This setting is in tenths of seconds and is the estimated length of time it takes for a ring. 
The default is 60 (which is an estimated six seconds per ring). The range is 0 to 65535.
The defaults appear in install.cfg as:
set tmo_rna 60
General Options (Continued)
Configuration OptionDescription 
						

							174 Installing [email protected]
tmo_serialNumber of seconds to wait for a response from a peripheral device connected to one of 
Amanda’s serial ports.
When communicating with peripheral devices through a serial port, Amanda needs a 
timeout value so she doesnt wait forever for a response.
Number of seconds from 1 to 999. The default is 2.
The default appears in install.cfg as:
set tmo_serial 2
tmo_silenceThe maximum seconds of silence before Amanda decides that the caller or user is fin-
ished recording a message or greeting. 
The post record menu plays if the record_menu option is True. The caller can press 3 to 
append the message if he was just pausing too long. 
If the number is 0, Amanda does not use silence to determine completion.
Number of seconds from 0 to 255. The default is 5.
The default appears in install.cfg as:
set tmo_silence 5
tmo_soundThe maximum seconds of continuous sound/dial tone before Amanda decides that the 
caller or user is finished recording a message or greeting and has hung up. If the number 
is 0, Amanda does not use sound/dial tone to determine completion.
Number of seconds from 0 to 255. The default is 5.
The default appears in install.cfg as:
set tmo_sound 5
tmo_xferThis option is required only for telephone switching systems, such as Comdial DXP and 
Panasonic KXT-D, that can send DTMF tones in place of PCPM tones. See also 
dtmf_action.
tokens_availableLists the tokens available to program with. Depending on the type of Amanda system 
you have, you may not be able to use all the tokens in the list. 
You can make additional restrictions by deleting tokens that your system can use from 
the list. For example, deleting the G token makes it impossible to program a move from 
one mailbox to another via tokens.
The default is GIJLMNOPQRSTUVW+-?=|[]{^@
The default appears in install.cfg as:
set tokens_available GIJLMNOPQRSTUVW+-?=|[]{^@
urgent_to_frontControls the priority of urgent messages. 
True or False. The default is True.
When True, Amanda places urgent messages in front of other messages (new and old) 
for a mailbox. The user cannot press 4 to wrap from the first to the last message. He must 
listen to the urgent messages first.
When False, urgent messages are mixed in with other messages in the order that they 
were received.
See also play_new_first.
The default appears in install.cfg as:
set urgent_to_front true
General Options (Continued)
Configuration OptionDescription 
						

							Appendix C: Configuration Reference 175
use_pvcControls whether Amanda uses the positive voice control feature available on the 
Rhetorex voice board.
True or False. The default is True.
When True, Amanda detects a human voice faster, but there is a greater chance of iden-
tifying an unanswered call as answered and ending her supervision of the call too soon.
When False, Amanda may take more time to detect an answer during supervised trans-
fers, but false answer detects are less likely.
See also voice_analysis_length.
The default appears in install.cfg as:
set use_pvc true
use_tutorialControls whether Amanda uses the tutorial for setting up mailboxes when users use the 
telephone user interface for the first time.
True or False. The default is True.
When True, Amanda suggests that the user use the tutorial to set up his or her mailbox. 
Amanda continues to make this suggestion until the mailbox has been set up.
When False, Amanda does not suggest that the user use the tutorial. 
Regardless of the setting, Amanda retains information about who has and hasn’t set up 
mailboxes so that anytime this configuration parameter is set to True, Amanda behaves 
correctly.
The default appears in install.cfg as:
set use_tutorial true
user_logIf you provide a file name, Amanda creates that file and logs:
The date, time, and mailbox when any mailbox is accessed by DTMF. For example, 
whenever a caller enters a mailbox, that information is logged.
The file can be analyzed later for call distribution and access to mailboxes by date, day, 
and time.
The default is to not log data (because no file name is provided). We recommend using 
USER.LOG.
See also msg_log.
The default appears in install.cfg as:
set user_log 
voice_analysis_lengthWhen positive voice control is used, this option specifies how long a noise must continue 
before Amanda decides that it is a voice answer and not just a glitch. 
Number of hundredths of seconds. The range is from 1 to 6553. The suggested range is 
1 to 100. The default is 19.
NOTE:
  The default (.19 seconds) appears to eliminate false answer detection on Panasonic and 
Samsung telephone switching systems, allowing them to work with the 5.54 Rhetorex 
driver.
See also use_pvc.
The default appears in install.cfg as:
set voice_analysis_length 19
General Options (Continued)
Configuration OptionDescription 
						

							176 Installing [email protected]
Fax Options
Configuration OptionDescription
fax_direct_connectThe string to send (after AT) to the fax modem to make it connect to a ringing tele-
phone, play the CNG tone, and send the fax. Use a maximum of 20 characters. This op-
tion defaults to H1O0 which some Zoom modems require.
NOTE:
The value of H1O0 contains four distinct characters:  alphabetic H, numeric one, alpha-
betic O, and numeric zero.
The default appears in install.cfg as:
set fax_direct_connect H1O0
fax_dl_initWhen a user is listening to messages over the telephone and discovers that he has a fax 
message, he dials 72 to send the message to a fax machine followed by the telephone 
number for the fax machine. Amanda dials this option before she dials the fax machines 
number. Usually, it is the dial code for accessing an outside line. The default is 9,. Use 
a maximum of 20 characters.
The default appears in install.cfg as:
set fax_dl_init 9,
fax_flow_controlDefines the Class 2 command to set the type of flow control for the fax modem. The de-
fault is &K3. Use a maximum of 20 characters. 
For Use
Rockwell-based fax modems&K3
Aceex modems \Q3 X3 &K3
Practical Peripherals modemsX3 &K3
Zoom modems &K3
Smart One 1442 modems &K4
Boca modem M144EW &K3
The default appears in install.cfg as:
set fax_flow_control &K3
fax_idIdentifies your fax modem. Use the company name or the telephone number of your fax 
machine. Use a maximum of 20 characters.
By default, no identification is provided. When two faxes connect, they exchange and 
then display each other’s identifying strings.
The default appears in install.cfg as:
set fax_id 
fax_id_padControls whether 1111 is added to the front of the fax_id. Many older fax modems need 
some extra characters as padding. Otherwise, part of the identifying string is cut off.
True or False. The default is True, but if  1111 appears on the receiving fax machine, 
change this option to False (so no padding characters are added).
The default appears in install.cfg as:
set fax_id_pad true
fax_initString sent to initialize a fax modem (give it a known starting state). The default is 
&F0E0. Use a maximum of 20 characters.
Some modems require &F rather than &F0. The E0 insures that the modem is in 
non-echo mode, because the command that puts the modem into Class 2 or Class 2.0 
mode expects the fax modem to be in non-echo mode first. 
The default appears in install.cfg as:
set fax_init &F0E0 
						

							Appendix C: Configuration Reference 177
fax_logUse this option to log data about files (not messages) that are faxed. Amanda creates a 
log file in the C:\AMANDA directory and logs: 
 The names of the files that were faxed 
 The telephone numbers to which the files were sent
By default, no filename is used and no log is written. Use a maximum of 20 characters. 
We recommend using FAX.LOG.
The default appears in install.cfg as:
set fax_log 
fax_max_retriesDefines the maximum number of times, after the first, to retry sending a fax file if it is 
unsuccessful. This is used only when sending the fax in two-call mode (where the caller 
enters a fax telephone number and the fax modem sends the file to that number).
The range is 0 to 9. The default is 1.
The default appears in install.cfg as:
set fax_max_retries 1
fax_receive_reverseTrue or False. Depends solely on the fax modem you are using. For most Rockwell-
chipset-based Class 2 modems, this parameter should be True. For most other modems 
(including Class 2.0), it should be False.
If set incorrectly, received faxes cannot be retransmitted or viewed at all. Setting it to 
True reverses the bits within each received byte, correcting for an oddity in the Rock-
well firmware.
The default appears in install.cfg as:
set fax_receive_reverse true
fax_receive_speedThe maximum speed for receiving faxes. 
The value can be 0, 1, 3. Use 0 for 2400 bps, 1 for 4800 bps, and 3 for 9600 bps.
Normally a value of 3 works for 486 CPUs at 25MHz or higher (and is the default). If 
you experience data loss on your faxes, lower this setting.
The default appears in install.cfg as:
set fax_receive_speed 3
fax_requeue_intervalDefines the number of minutes to wait between retries.
The range is 1 to 99. The default is 5.
See also max_retries.
The default appears in install.cfg as:
set fax_requeue_interval 5
fax_resetDefines the reset command to send to your fax modem when DTR (Data Terminal 
Ready) is dropped. For most Rockwell-based fax modems, it should be &D3, which is 
the default.
Possible values: See your fax modem manual. Use a maximum of 20 characters.
The default appears in install.cfg as:
set fax_reset &D3
fax_send_reverseTrue or False, depends solely on your Class 2 or Class 2.0 fax modem. For most fax mo-
dems, this option should be False. 
The default appears in install.cfg as:
set fax_send_reverse false
Fax Options (Continued)
Configuration OptionDescription 
						

							178 Installing [email protected]
fax_send_speedThe maximum speed that Amanda uses to send faxes. 
The value can be 0, 1, 3. Use 0 for 2400, 1 for 4800, and 3 for 9600 bps. Normally 
a value of 3 works for 486 CPUs at 25MHz or higher (and is the default), but it depends 
on your computer.
If you experience data loss on your faxes, lower this setting.
The default appears in install.cfg as:
set fax_send_speed 3
fax_start_charControls whether the system waits for the start character or not.
True or False. The default is False.
When True, Amanda waits for the character.
When False, Amanda does not wait.
Early drafts of the CCITT Class 2 Specification require that, when sending a fax, the 
sender wait for the fax modem to send a control character indicating that it is ready for 
the data to begin. Some modems lose data if the computer starts sending before the fax 
modem indicates that its ready to receive. Unfortunately, not all Class 2 fax modems 
send the start character.
The default appears in install.cfg as:
set fax_start_char false
fax1
fax2
fax3
fax4Use these options to define the station, or extension, number to which your fax modem 
is connected. For example, if the first fax modem is connected to extension 101, set fax1 
to 101.
By default, no extension is set for a fax modem. Use a maximum of 7 digits.
The defaults appear in install.cfg as:
set faxn
 
where n is logical serial port 1, 2, 3, or 4. See serial_portn.
max_local_extensionThe maximum number of digits that can be considered an extension number. 
The default number is 6. The range is 1 to 6.
Users (at the message menu) can send fax messages they have received to a fax machine 
by entering 72 then a fax machine’s telephone number. Amanda applies fax_dl_init 
(usually 9 for an outside line) if the telephone number entered by the user has more dig-
its than max_local_extension.
The default appears in install.cfg as:
set max_local_extension 6
Fax Options (Continued)
Configuration OptionDescription 
						

							Appendix C: Configuration Reference 179
Hot Box Options
Configuration OptionDescription
hot_boxDefines the mailboxes to which Amanda goes when she detects special PCPM tones. 
You can have up to 24 hot_boxes. For example, you can configure a hot_box to detect 
connections from TDD machines for deaf communications. 
In most cases, only one hot_box is defined to detect fax tones and the remainder are un-
used. 
You provide a mailbox next to the corresponding PCPM code (13 to 36). The default 
mailbox is -1, which means no mailbox. We recommend using 994 as the first hot_box 
mailbox, but you can use any valid mailbox.
NOTE:
To add a specific tone to the tone table, it must be one of the first four tones defined, and 
it must be marked as a terminating tone. Call to be faxed Technical Note 8, “Special Tone 
Detection.”
The defaults appear in install.cfg as:
set hot_box -1 n
where n is the PCPM code minus 12. (For example, for PCPM code 25, you use 25-12 
or 13. The range for n is from 1 to 24.)
Outdial Options
Configuration OptionDescription
box_outdialControls special mailbox options.
You provide a mailbox for each telephone digit that becomes a special mailbox option. 
While logged into a mailbox, a user presses 7 to reach special options, then a digit, 0-9, 
depending on what you specify here. Then Amanda executes the tokens in the extension 
field of the mailbox you specify for that digit.
Setting the mailbox to -1 disables that special mailbox option. For example, to allow us-
ers to press 7 then 5 to call for the time of day, you might type 149 next to the digit 5. 
In this case, 149’s Extension field should contain the telephone number Amanda dials 
for the weather (perhaps 9,8531212). Later, users log into their mailboxes and press 75 
for the current time. Afterwards they continue other mailbox options. 
The defaults appear in install.cfg as:
set box_outdial -1 x
where x is a digit from 0 to 9
C
AUTION:If you use box_outdial to give users an outside line, you might want to use 
telephone lines that are toll restricted. 
						

							180 Installing [email protected]
Per Port Options
Configuration OptionDescription
box_grtDetermines what greeting the caller hears first. This is set per Amanda telephone port by 
assigning a mailbox to the port. Greeting 1 for that mailbox is the greeting that the caller 
hears. By default, all ports are assigned 990, the Company Greeting mailbox.
The defaults appear in install.cfg as:
set box_grt 990 n 
where 990 is a mailbox and
where n is a port number from 1 to 24.
box_idxSets the mailbox for the employee directory. This is set per Amanda telephone port by 
assigning a mailbox to the port. The employee directory contains the names of all the 
users as they appear in the Dir Name 1 and Dir Name 2 fields. 
The default is 411 for every port. 
For example, to use one employee directory for the ports 1 and 2, another for port 3, and 
a third for port 4, set box_idx to 411 for ports 1 and 2, 511 for port 3, and 611 for port 4.
NOTE:
Callers use their telephone pad to spell the names of the users they want to reach. Amanda 
plays the name and extension recording for every user that matches. If there is no name 
and extension recording, Amanda says “mailbox” and the number of that mailbox. Digits 
7 and 9 should be used for letters Q and Z respectively.
The default appears in install.cfg as:
set box_idx 411 n
where 411 is a mailbox and
where n is a port number from 1 to 24. 
box_sndIndicates what mailbox serves as the direct message mailbox. This is set per Amanda 
telephone port by assigning a mailbox to the port. The direct message mailbox allows 
you to leave a message for a mailbox without processing the mailbox. Amanda does not 
execute the Extension field’s tokens or play a greeting. For example, an operator can use 
the direct message mailbox to transfer callers directly to a user’s voice mail.
The default is 998 for all ports. 
The default appears in install.cfg as:
set box_snd 998 n 
where 998 is a mailbox and
where n is a port number from 1 to 24.
hangup_supervisionAllows you to use hangup supervision. This is set per Amanda telephone port.
True or False. The default is True. 
Use True if your telephone switching system supports Loop Current Drop for hangup su-
pervision on the specified port. Even if it doesn’t, using True usually has no negative 
effect.
Use False if you notice call transfer problems such as disconnects during three-way con-
ferences. However, if the problems persists, return to True. 
The default appears in install.cfg as:
set hangup_supervision true  n
where n is a port number from 1 to 24.
 For reference purposes, the per port options are listed here in alphabetical order. In the Setup utility, they are listed:
pbx, box_grt, box_idx, box_snd, n_rings, and hangup_supervision. 
						

							Appendix C: Configuration Reference 181
n_ringsSets the number of rings that Amanda waits before answering a call on a given port. To 
have port 7 answer after the second ring use 
n_rings 2 
for port 7. This is useful for 
those telephone switching systems that do not allow incoming lines to ring in a station 
hunt group or do not provide delayed ringing. Also, it may be used to set up backup an-
swering for a secondary attendant operation. 
The rings range from 0 to 9.
NOTE:
There is a side-effect. When users want to pickup their messages, they must wait the spec-
ified number of rings before Amanda answers.
The default appears in install.cfg as:
set n_rings 1  n 
where 1 is the number or rings and
where n is a port number from 1 to 24.
pbxIndicates which Amanda telephone ports are connected to which PBXs. You provide the 
PBXs number (usually 1 or 2). 
The defaults appear in install.cfg as:
set pbx 1  n
where 1 is the PBX number and
where n is a port number from 1 to 24.
Serial Port Options
Configuration OptionDescription
baud1
baud2
baud3
baud4The bps (bits per second) for the logical serial port with the same number. For example, 
baud1 gives the bps for serial_port1. (Serial_port1 can be mapped to any COM port.)
Possible values:  Any valid bps rate. The default is 19200. 
The defaults appear in install.cfg as:
set baudn
 19200
where n is the logical serial port 1, 2, 3, or 4.
databits1
databits2
databits3
databits4The number of data bits for the logical serial port with the same number. For example, 
databits1 gives the number of data bits for the COM port defined as serial_port1. 
(Serial_port1 can be mapped to any COM port.)
Possible values are 7 or 8. The default is 8.
The defaults appear in install.cfg as:
set databitsn
 8
where n is the logical serial port 1, 2, 3, or 4.
parity1
parity2
parity3
parity4The parity for the logical serial port with the same number. For example, parity1 gives 
the parity for serial_port1. (Serial_port1 can be mapped to any COM port.)
Possible values are none, even, odd, mark, or space. The default is none.
The defaults appear in install.cfg as:
set parity
n none
where n is the logical serial port 1, 2, 3, or 4.
Per Port Options (Continued)
Configuration OptionDescription
 For reference purposes, the per port options are listed here in alphabetical order. In the Setup utility, they are listed:
pbx, box_grt, box_idx, box_snd, n_rings, and hangup_supervision. 
						

							182 Installing [email protected]
serial_port1
serial_port2
serial_port3
serial_port4To communicate with peripheral devices connected to COM/RS232 ports, Amanda 
needs to know which ports are connected. 
This option matches the serial ports as Amanda knows them (called the logical serial 
ports) to the actual COM1, COM2, COM3, and COM4 ports on the computer (called 
the physical serial ports). 
Possible values are 0 through 4. The default is 0, which means that the port is not con-
nected.
Only after this matching can Amanda communicate with devices, such as SMDI inter-
faces, connected to her COM ports. For example, 
serial_port1 2 matches serial_ 
port1 (Amanda’s first logical serial port) to the physical COM port 2 of the PC. How-
ever, it is less confusing to use 
serial_port1 1, matching logical and physical 
ports with the same number.
The defaults appear in install.cfg as:
set serial_portn
 0
where n is the logical serial port 1, 2, 3, or 4.
stopbits1
stopbits2
stopbits3
stopbits4The number of stop bits for the logical serial port with the same number. For example, 
stopbits1 gives the number of stop bits for serial_port1. (Serial_port1 can be mapped to 
any COM port.)
Possible values are 1 and 2. The default is 1.
The defaults appear in install.cfg as:
set stopbitsn
 1
where n is the logical serial port 1, 2, 3, or 4.
SMDI Options
Configuration OptionDescription
smdi_activation_keyA number you receive from your Amanda Company sales representative to allow your 
system to use SMDI. 
If you change or add a board later, you need another activation key because the key is 
based on the serial numbers for the boards and the number of ports.
The default is 0, which means there is no activation key.
The default appears in install.cfg as:
set smdi_activation_key 0
smdi_base_portUse this option to identify Amanda’s first voice mail port. The first voice mail port is 
identified as logical port 1, with every successive port having a sequential logical port 
number.
These numbers must be consecutive. The number for the second port must be one more 
than the number for the first port, and so on.
The default number is 1. The range is 0 to 32000.
The default appears in install.cfg as:
set smdi_base_port 1
Serial Port Options (Continued)
Configuration OptionDescription