Amanda Work Group Manual

							Chapter 13: Configuration Reference 211
range1_key
range2_key
range3_key
range4_keyIf you buy a third-party application that was customized for Amanda using the Token 
Programming Language, you import the mailboxes programmed for that application 
with the import utility. 
Then, to activate that application, you set one of these parameters to the activation key 
(or range key) that allows Amanda to use those mailboxes. For more information, con-
tact an Amanda Company sales representative. 
The default is 0, which means there is no key. 
See also range1, range2, range3, and range4, the parameters that you set to the first of 
the mailboxes that correspond to the range key.
The defaults appear in install.cfg as:
set range1_key 0
set range2_key 0
set range3_key 0
set range4_key 0
reask_sacControls how much the user must repeat when logging in incorrectly.
True or False. The default is False.
When True and a user logs in incorrectly, the system asks for only the security code the 
second time. If the user still enters inaccurate information, the systems asks for both the 
mailbox number and the security code until the maximum of times have been allowed 
(as set in max_prompt).
When False, the system always asks the user for both the mailbox number and the secu-
rity code.
The default appears in install.cfg as:
set reask_sac false
recall_delayAmount of time the voice board waits after an earth recall (used in place of a hookflash 
on some telephone switching systems).
Number of hundredths of seconds. 0 tells Amanda to use the voice boards default (which 
is 15 for Denmark or Holland and 50 elsewhere). Otherwise, the range is 1-6553.
The default appears in install.cfg as:
set recall_delay 0
record_beepControls the beep that the user or caller hears as the system begins recording.
True or False. The default is True.
When True, the system beeps as it begins to record.
When False, the beep is not used. Be aware that, unless you have changed the prompt 
set, the prompt the user hears as the system begins to record says “Begin recording at the 
tone.”
The default appears in install.cfg as:
set record_beep true
Global Settings (Continued)
ParameterDescription 
						

							212 Installing [email protected]/Windows
record_menuControls Amanda’s use of prompts and menus before and after recordings.
True or False. The default is True.
When True, Amanda checks the values of begin_rec_prompt and end_rec_menu to de-
termine what to say.
When False, Amanda does not prompt the caller to leave a message at the tone nor the 
user to record a greeting at the tone. Amanda also does not play the post-record menu 
that allows the caller or user to review and re-record.
The default appears in install.cfg as:
set record_menu true
recursive_deletesControls whether Amanda deletes the guest mailboxes that were created for a mailbox 
at the same time the mailbox is deleted.
True or False. The default is False.
When True, when Amanda deletes a mailbox, the guest mailboxes that were created for 
that mailbox are also deleted. This deletion is recursive.
When False, only the mailbox is deleted. Its guest mailboxes remain available for use.
The default appears in install.cfg as:
set recursive_deletes false
remember_volumeCauses Amanda to remember volume settings for each user.
True or False. The default is False.
When True, Amanda remembers each user’s most recent playback volume setting.
When False, Amanda starts with the default volume setting (see “gain_norm” on 
page 201).
Users can adjust the volume by pressing 8 or 0 (for louder and softer) while listening to 
their messages.
The default appears in install.cfg as:
set remember_volume false
ring_modeIndicates whether Amanda expects a loop start or a DID interface line on a per port basis.
True or False followed by a port number. The default is True.
When True, Amanda expects a loop start line, and new calls are indicated by ring volt-
age.
When False, Amanda expects a DID interface line, and new calls are indicated by loop 
current.
The default appears in install.cfg as:
set ring_mode true 
n
where n is a port number. However, the default uses no port number, which means that 
all the ports use loop start or a DID interface line.
rmt_rnaIn a notification record, when using W(0,P) or W(0,V) to wait for a pager or voice an-
swer, the number for this parameter replaces the 0 and provides the number of remote 
rings that Amanda must hear before the system decides that there is no answer. 
The default is 4. The range is 1 to 9. However, you should never use fewer than 2 rings 
with the W() token.
The default appears in install.cfg as:
set rmt_rna 4
Global Settings (Continued)
ParameterDescription 
						

							Chapter 13: Configuration Reference 213
rotaryControls the detection of rotary digits.
True or False. The default is False.
When True, Amanda detects rotary digits.
When False, Amanda does not detect rotary digits.
N
OTE:Only rotary digits 3(9 and 0 are currently detected on the Brooktrout 2132 
and 4132 boards. Therefore, if you plan to use this feature, make sure that 
all your mailboxes exclude the digits 1 or 2. Also, there are no * and # signs 
on rotary phones, therefore setting this to True introduces additional delays 
when the system detects the dialed number. For full rotary detection, please 
contact your Amanda Sales Representative for other parameters.
N
OTE:The Brooktrout 232 and 432 boards do not support rotary detection. If rotary 
detection is required, use Brooktrout 2132 and 4132 boards.
N
OTE:The 727 Brooktrout drivers (shipped with Amanda version 6.02) does not 
support rotary. You can switch to the 537 drivers. First save VOICEC-
NF.EXE as VOICECNF.727 and RHETDRV.EXE as RHETDRV.727. 
Then copy VOICECNF.537 to VOICECNF.EXE and RHETDRV.537 to 
RHETDRV.EXE. These files are in C:\PLATFORM.
The default appears in install.cfg as:
set rotary false
screen_saveThe file in the C:\AMANDA directory in which screen traces are saved. Whenever you 
use screen trace, the data is saved to the designated file. Otherwise, the data appears only 
on the screen.
The default filename is SCREEN.OUT. 
The default appears in install.cfg as:
set screen_save screen.out
sec_code_displayControls whether security codes are visible from Amanda Administrator.
True or False. The default is False.
When True, the security codes are visible.
When False, they are replaced by asterisks.
The default appears in install.cfg as:
set sec_code_display false 
security_min_lengthThe minimum length of a user’s security code (when changed by a user over the tele-
phone or when using Amanda Messenger). This does not affect the length of security 
codes that are entered from Amanda Administrator. The administrator can use any pass-
word of 8 or fewer characters.
A number from 1 to 8. The default is 1.
The default appears in install.cfg as:
set security_min_length 1
Global Settings (Continued)
ParameterDescription 
						

							214 Installing [email protected]/Windows
short_direct_sendThe direct message mailbox (usually 998) is for leaving messages for any Amanda user. 
It does not ring that user’s extension. After entering 998, the caller is asked for the des-
tination mailbox then leaves his message. 
This parameter controls how Amanda identifies the user before the message is left. This 
confirms that the caller entered the mailbox that he intended to.
True or False. The default is False.
When True, the caller hears “You entered” followed by the name and extension record-
ing for the user—if there is one. Amanda says the mailbox number (for example, mail-
box 1-4-7) when there is no recording.
When False, the caller hears the mailbox’s current greeting (which can be skipped by 
pressing # twice).
The default appears in install.cfg as:
set short_direct_send false
smtp_serverSpecifies the hostname for a computer that runs an SMTP server which will accept sub-
missions from the Amanda system. It is used by the KG() token when sending Internet 
e-mail. For example, the hostname might be mail.company.com.
tape_lengthWhen a user selects 1, 7, 8 (for continuous play) from the top level menu, this parameter 
indicates how long Amanda will play messages continuously (with a beep between 
them). Usually this is equal to the length of one side of a tape. It allows users to archive 
their messages. Users can record the messages on tape using a microphone if the tele-
phone does not have a jack for this purpose.
Number of minutes from 1 to 99. The default is 30.
The default appears in install.cfg as:
set tape_length 30
timestamp_forwardsControls the date and time given to a forwarded message. 
True or False. The default is True.
When True, the date and time tell when the message was forwarded. This can prevent 
messages from appearing to be delayed when they are forwarded without explanatory 
prefixes.
When False, the date and time tell when the message was first recorded. 
The default appears in install.cfg as:
set timestamp_forwards true
tmo_call_screeningThe number of seconds that Amanda waits for the user to accept or reject a call. This 
applies to call screening and to waiting call processing.
The default is 30. The range is 0 to 255. 
The default appears in install.cfg as:
set tmo_call_screening 30 
Global Settings (Continued)
ParameterDescription 
						

							Chapter 13: Configuration Reference 215
tmo_dir_transferControls whether the caller hears the 411 directory information prompt with the instruc-
tions about how to be transferred to an extension. If the value is 0, the prompt is not 
played. If you use a number greater than 0, Amanda waits that number of seconds for a 
response from the caller. The default is 2.
The prompt after each match is: “To be transferred to this extension, press *. Otherwise, 
press # to continue.”
If you are selecting a recipient for voice mail, the prompt is: “To select this extension, 
press *. Otherwise, press # to continue.”
When there are no more matching directory entries, the prompt is: “To search the direc-
tory again, press *. Otherwise, press #.”
The default appears in install.cfg as:
set tmo_dir_transfer 2
tmo_diskControls how often Amanda checks for low disk space. Amanda also checks for low disk 
space when the system starts up. 
Number of minutes. The range is 0 to 255. The default is 60.
See also diskwarn.
The default appears in install.cfg as:
set tmo_disk 60
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:\AMAN-
DA\HOLD.VOX, which Amanda normally plays for callers on hold, is missing. Usually 
Amanda tries to transfer the call after playing the file.
Number of seconds. The default is 20. The range is 0 to 255.
N
OTE: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
Global Settings (Continued)
ParameterDescription 
						

							216 Installing [email protected]/Windows
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_queueThe number of seconds after which a waiting call is automatically transferred to voice 
mail as though the extension were never answered.
The default is -1, which waits forever (as does 0, which is infinite).
The range is from -1 to 4 million.
The default appears in install.cfg as:
set tmo_queue -1
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 the system 
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 Adjust Maximum 
Rings text box in Amanda Administrator.)
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
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 the system 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
Global Settings (Continued)
ParameterDescription 
						

							Chapter 13: Configuration Reference 217
tmo_xferThis parameter 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.
treat_rna_as_busyAllows you to treat ring-no-answer (RNA) calls as busy calls. In certain environments 
(such as Automatic Call Distributors—ACDs), combining this configuration parameter 
with auto_queue allows you to queue all unanswered calls, not just busy calls. The other 
way to accomplish this, by putting the ring tones in the tone table with a BUSY code, 
does not allow you to set the number of rings that must occur before the busy signal is 
returned.
True or False. The default is False.
If True and Amanda performs supervised transfers, Amanda treats an RNA call as a busy 
call and can be put on hold.
If False, an RNA call is treated as an RNA call. This usually means that the caller is 
asked to leave a message immediately.
The default appears in install.cfg as:
treat_rna_as_busy false
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+-?=|[]{^@
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
use_pvcControls whether Amanda uses the positive voice control feature available on the Brook-
trout 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.
The default appears in install.cfg as:
set use_pvc true
Global Settings (Continued)
ParameterDescription 
						

							218 Installing [email protected]/Windows
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 
v_sac_activationA number you receive from an Amanda Company sales representative that activates 
voice security, allowing users to use a verbal phrase as a security code. The default is 0.
The default appears in install.cfg as:
set v_sac_activation 0
v_sac_max_triesThe maximum number of times Amanda asks for a voice security phrase to be restated 
while the system is analyzing that phrase for use as the user’s security phrase. The de-
fault is 6.
The default appears in install.cfg as:
set v_sac_max_tries 6
v_sac_threshold_enrollA number representing the voice security threshold for enrollment. For example, as a 
user states and restates his or her security phrase, Amanda must learn it with some level 
of certainty. This number indicates that level of certainty. The lower the number, the 
higher the level of certainty that the phrase has been learned.
The default is 0, which means to use the current internal value which works for most sys-
tems. Recommended values are from 1 to 350.
The default appears in install.cfg as:
set v_sac_threshold_enroll 0
v_sac_threshold_verifyA number representing the voice security threshold for verification. For example, as the 
user calls to access his or her mailbox, Amanda must verify that the phrase is indeed this 
user’s security phrase with some level of certainty. This number indicates that level of 
certainty. The lower the number, the higher the level of certainty that the phrase has been 
learned.
The default is 0, which means to use the current internal value which works for most sys-
tems. Recommended values are from 1 to 300.
The default appears in install.cfg as:
set v_sac_threshold_verify 0
vox_pathsSpecifies at least one complete path to a location where voice files (messages and greet-
ings) can be stored. Each path can hold 65,535 voice files. Once set, this value can never 
be changed except to add additional paths to the list. Each path must begin with a drive 
letter and a colon. You cannot use UNC path names. When using more than one path, 
separate the paths with a space. For example:
c:\vox.db d:\vox.db e:\vox.db
The default is c:\vox.db.
The default appears in install.cfg as:
set vox_paths c:\vox.db

Global Settings (Continued)
ParameterDescription 
						

							Chapter 13: Configuration Reference 219
Per Port Settings
ParameterDescription
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 Directory Name 1 or Directory Name 2 (in the mailbox win-
dow in Amanda Administrator). 
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.
N
OTE: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 “mail-
box” and the number of that mailbox. Digits 7 and 9 should be used for let-
ters 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 ef-
fect.
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 Parameters 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. 
						

							220 Installing [email protected]/Windows
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.
N
OTE:There is a side-effect. When users want to pickup their messages, they must 
wait the specified 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.
Telephone Switch Integration Settings
ParameterDescription
Integration First Digit 
TimeoutDuring inband integration, this parameter 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
Integration Interdigit 
TimeNumber of tenths of seconds that Amanda waits between integration digits.
This appears in the .PBX file as int_time. The default is 10, which is one second.
Integration TerminatorA one-character string containing the character that terminates DTMF input. The default 
is the empty string.
When Amanda see the character that matches integration_term, the system terminates 
the integration input. This can be used to speed up slow systems. The terminating char-
acter is not removed from the input, so be sure that your integration patterns include it 
or allow for it.
The default appears in install.cfg as:
set integration_term 
Per Port Settings (Continued)
ParameterDescription
 For reference purposes, the per port Parameters 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.