Amanda Work Group 7xx Installation Manual

							Chapter 14: Configuration Reference 161
adpcm_nqSets the sampling rate for incoming messages. The higher the sampling rate, the bet-
ter the sound quality, but also the more disk space used. 
24, 32, or 64. The default (and recommended value) is 32.
N
OTE:
  If you change this on an active system, you should have users delete all 
their messages first.
The default appears in install.cfg as:
set adpcm_nq 32
adpcm_pqSets the sampling rate for the system prompt file. This is set to the sampling rate at 
which the system prompt file was recorded.
24, 32, or 64. Correctly set by default.
N
OTE:
Do not change this unless you have installed the appropriate system prompt 
file.
The default appears in install.cfg as:
set adpcm_pq x
where x is the correct setting for your prompt files.
advertisingDisplays a text string at different locations on the Main screen after the screen saver 
starts up. (This option does not apply to Amanda voice server.)
Use any text string ranging from 0 to 79 characters. The recommended length is less 
than 30 characters so your message is easy to read and fits on the screen at most lo-
cations. Buy more AMandAs! is the default.
See also tmo_blank.
The default appears in install.cfg as:
set advertising Buy more Amandas!
another_call_okDetermines whether Amanda continues to monitor the call using PCPM after receiv-
ing the “On Another Call” message from a Norstar telephone.
This is designed for Norstar telephones that have more than one intercom button 
configured for use.
True or False. The default is False.
When True, Amanda allows one call per intercom button. Only if all the intercom 
buttons are in use does she consider the extension busy.
When False, Amanda considers the extension busy if any intercom path is in use.
General Options (Continued)
Configuration OptionDescription 
						

							162 Installing [email protected]/DOS
auto_queueDesigned for callers with rotary telephones so that they can be put “on hold” without 
having to press *.
True or False. The default is False.
If True and if active_hold is False, callers are automatically put “on hold” when they 
reach a busy extension. A custom busy message must explain what’s going on so 
that callers are aware that they are “on hold” and that they can dial other exten-
sions—if they prefer.
The default appears in install.cfg as:
set auto_queue false
auto_reportThe name of a previously saved report file in the RPT.DB subdirectory within the 
AMANDA directory which can be executed and printed once each day. When not 
set, no auto reporting is done. 
Use the name of a report file with the extension .RPT. The default is an empty string 
which means that no report file is executed.
To use this feature, verify the following:
 A printer with a parallel interface must be connected to Amanda
 The parameter lpt_port must be set to 1, indicating the port to 
which the printer is attached
 The printer must be online and have enough paper
See also auto_report_time and lpt_port.
The default appears in install.cfg as:
set auto_report 
auto_report_timeThe time of day at which the report is to be printed (when auto_report is not an emp-
ty string).
A time of day in 24-hour MMHH format. The default is 0745 (7:45 a.m.).
See also auto_report and lpt_port.
The default appears in install.cfg as:
set auto_report_time 0745
General Options (Continued)
Configuration OptionDescription 
						

							Chapter 14: Configuration Reference 163
begin_rec_promptWhen record_menu is True, this option controls whether the caller hears Amanda 
prompts or only a beep when recording a message. This option has no effect on the 
post-record menu. If the caller presses #, the post-record menu indicates how to re-
record, append to, or save a recording.
True or False. The default is True.
When True, Amanda plays, “Begin recording at the tone, finish by pressing # or 
hanging up” before the beep. 
When False, the caller hears only a beep.
See also record_menu and end_rec_menu.
The default appears in install.cfg as:
set begin_rec_prompt true
ca_fileThe file (in the C:\AMANDA directory) which stores call accounting (SMDR) data 
that comes from the port in ca_port. The data is collected from the telephone switch-
ing system, stored while Amanda runs, and then (after a shutdown) read by a call 
accounting package that analyzes and manipulates the data.
Use any filename. The default is SMDR.DAT.
See also ca_port.
The default appears in install.cfg as:
set ca_file SMDR.DAT
ca_portThe number for the logical serial port that will read SMDR data from the switch 
while Amanda is running. The data is stored in the file specified by ca_file unless 
the number is 0, in which case no SMDR data is read.
Use 0, 1, 2, 3, or 4. The default is 0.
See also ca_file.
The default appears in install.cfg as:
set ca_port 0
General Options (Continued)
Configuration OptionDescription 
						

							164 Installing [email protected]/DOS
cancel_busy_holdDetermines whether callers can hold for a busy extension.
True or False. The default is False.
When True, busy becomes equivalent to Ring No Answer (RNA). That means that 
the caller cannot hold for a busy extension and can only leave a message once RNA 
or BUSY is the state of the called extension (assuming the mailbox accepts messag-
es).
When False, the caller can press * to hold for a busy extension. 
The default appears in install.cfg as:
set cancel_busy_hold false
cfg_portSpecifies the port on which to perform configuration. Use the second to last port in 
the linear hunt group to prevent collisions (glare) during configuration and other port 
activities. This port is less likely to be receiving incoming calls than the other ports.
0 means that there is no port used for configuration. The default is 3.
The default appears in install.cfg as:
set cfg_port 3
clock_syncControls whether Amanda resynchronizes the DOS software clock with the PC 
hardware clock.
True or False. The default is True.
When True, Amanda resynchronizes. 
When False, Amanda does not resynchronize. Turn this off if you have another util-
ity that controls the PC clock.
The default appears in install.cfg as:
set clock_sync true
cmt_maxlenSets the total number of seconds allowed for recording a List Comment. The user 
can record a comment while creating a mailing list or later. It names or describes the 
contents of the list.
Number of seconds. The range is from 1 to 99. The default is 10.
The default appears in install.cfg as:
set cmt_maxlen 10
General Options (Continued)
Configuration OptionDescription 
						

							Chapter 14: Configuration Reference 165
connect_toneWhen an answer is detected and Amanda is not identifying the called party for the 
current mailbox, this option determines whether Amanda plays a beep. (On the Stan-
dalone system, the mailbox’s ID Call? field is set to NO, and on the Administrator 
client, the mailbox’s Identify Called Party check box is cleared.)
True or False. The default is True.
When True, Amanda plays the beep.
When False, there is no beep.
The default appears in install.cfg as:
set connect_tone true
create_lockedControls whether or not new mailboxes are locked when the mailbox template (usu-
ally mailbox 997) is locked. The administrator (using mailbox 999 and the tele-
phone) can lock the template (and other mailboxes) using one of the system 
administration options. This prevents callers from logging into the mailbox tem-
plate. 
True or False. The default is False.
When True, new mailboxes created from the template are initially locked if the tem-
plate is locked.
When False, new mailboxes are not locked. This means that they can be logged into 
via the telephone immediately after they are created.
The default appears in install.cfg as:
set create_locked false
db_lockingMakes Amanda lock each record in a file as it is accessed. No other port or program 
can access that record of that file. This is used within the context of using tokens to 
read and write to ASCII or dBase files. 
The value is 0 or 1. The default is 0.
When 0, Amanda does not perform record locking.
When 1, Amanda attempts to perform record locking which will fail unless 
SHARE.EXE, a DOS program (not licensed via The Amanda Company), is running. 
This program is usually loaded by the CONFIG.SYS or AUTOEXEC.BAT file. 
The default appears in install.cfg as:
set db_locking 0
General Options (Continued)
Configuration OptionDescription 
						

							166 Installing [email protected]/DOS
defaults_boxIndicates what mailbox to use as a template when creating a new mailbox. The con-
tents of most fields, all notification records, and all automatic scheduling records are 
copied from the template to the new mailbox. The Comment and Directory Name 
fields are not copied. The Extension field is copied only if it begins with an @ 
(which indicates token programming).
If the Security Code field of the default mailbox is blank, the security codes for new 
mailboxes are their mailbox numbers. Otherwise, the security codes for all new 
mailboxes are the same as that of the template mailbox. The Security Code field al-
ways appears blank. You must fill it with spaces if you want it to actually be blank.
Use any valid mailbox. The default is 997.
See also guest_defaults.
The default appears in install.cfg as:
set defaults_box 997
diskwarnWhen Amanda has only the specified percentage of disk space left, she executes 
Disk notification record (if there is one) for mailbox 999. The notification record 
may call you at home, call your extension, call your pager, and so forth. For exam-
ple, use 20 to have Amanda notify you when the remaining disk space falls below 
20. 
Number (for a percentage). The range is from 1 to 99. The default is 20.
See also tmo_disk.
The default appears in install.cfg as:
set diskwarn 20
dl_pickup_on_ringWhen an inbound ring is detected and Amanda goes off-hook, this option deter-
mines whether Amanda dials the code specified by the dl_pickup parameter in the 
1001.PBX file or the current dial codes file for that port.
True or False. The default is False.
When True, Amanda dials the code.
When False, Amanda does not dial the code.
The default appears in install.cfg as:
set dl_pickup_on_ring false
General Options (Continued)
Configuration OptionDescription 
						

							Chapter 14: Configuration Reference 167
dtmf_dlyControls the amount of time between DTMF tones when Amanda is dialing. 
Number of hundredths of seconds. The value is 0 or a number from 3 to 19. The de-
fault is 0.
Using a value of 0 makes it country-dependent (50ms in the US, 80ms in the UK). 
When non-zero, the specified time is used.
The default appears in install.cfg as:
set dtmf_dly 0
dtmf_gateVerifies that the caller is still on the line before transferring him to the operator. This 
applies only if the mailbox (usually the operator) specified in the Done Chain for the 
Caller Instructions mailbox has Do Not Disturb turned off.
True or False. The default is False.
When True, Amanda verifies that the caller is still on the line after playing the Caller 
Instructions and not hearing any DTMF. Amanda asks the caller to “Say ‘yes’ at the 
tone” before transferring the call. For example, on telephone switching systems that 
do not have disconnect supervision, this can prevent the transfer of a call to the op-
erator or prevent the replaying of a menu when the caller has hung up.
When False, Amanda transfers the call without verifying that the caller is still on the 
line. 
The default appears in install.cfg as:
set dtmf_gate false
dtmf_onControls how long Amanda plays each DTMF tone. 
Number in hundredths of seconds. The range is from 10 to 90. The default is 20 (.2 
seconds). 
The default appears in install.cfg as:
set dtmf_on 20
exit_digitDefines one additional DTMF tone that causes Amanda to stop during recordings 
(whether greetings or messages) and play the post-record menu.
The range is from 0 to 9 and also includes * and #. The default is #. Remember that 
the # key always causes Amanda to stop recording, even when it is not the value of 
exit_digit. 
The default appears in install.cfg as:
set exit_digit #
General Options (Continued)
Configuration OptionDescription 
						

							168 Installing [email protected]/DOS
end_rec_menuWhen record_menu is True, this option determines whether callers and users hear 
the post-record menu that allows them to review or re-record their messages or 
greetings.
True or False. The default is True.
When True, the caller or user hears the menu.
When False, the caller or user does not hear the menu.
The default appears in install.cfg as:
set end_rec_menu true
exit_to_0Allows a caller to leave a message and talk to the operator afterwards.
True or False. The default is True.
When True, the caller can press 0 after recording a message and is transferred to 
mailbox 0.
When False, Amanda records the DTMF 0 as part of the message unless 0 is defined 
as an exit digit (see also exit_digit).
N
OTE:
Regardless of the setting for exit_to_0, a caller can press 0 during the “Be-
gin recording at the tone...” prompt and go to mailbox 0 immediately. If the 
caller presses any other key (1-9, #, *), Amanda stops the prompt, plays the 
beep, and starts recording the message.
The default appears in install.cfg as:
set exit_to_0 true
future_deliverySpecifies the mailbox that stores messages to be delivered in the future. This mail-
box must be able to store messages.
The default is 995, but you can use any valid mailbox. -1 means no mailbox has been 
assigned. 
The default appears in install.cfg as:
set future_delivery 995
gain_loudControls the volume of the custom busy message.
Number. The range is from 1 to 9 and the default is 5.
The default appears in install.cfg as:
set gain_loud 5
General Options (Continued)
Configuration OptionDescription 
						

							Chapter 14: Configuration Reference 169
gain_normThe initial volume for all ports.
Number. The range is from 1 to 9 and the default is 5.
The default appears in install.cfg as:
set gain_norm 5
guest_defaultsThe mailbox to use as a template when creating a new guest mailbox. 
The default is 996, but you can use any valid mailbox. -1 means no mailbox has been 
assigned. 
See also defaults_box which explains what fields are copied.
The default appears in install.cfg as:
set guest_defaults 996
guest_minThe starting mailbox for guest mailboxes. If this value is 90000, the first guest mail-
box is 90000. The second is 90001, and so forth. 
See also guest_max. Guest_max must be larger than guest_min.
Any valid mailbox. The default is 90000.
The default appears in install.cfg as:
set guest_min 90000
guest_maxThe last mailbox for guest mailboxes. If this value is 90199, the highest possible 
number for a guest mailbox is 90199. Along with the guest_min, you limit the num-
ber of guest mailboxes that Amanda can create. Guest_max must be larger than 
guest_min.
A valid mailbox. The default is 90199.
The default appears in install.cfg as:
set guest_max 90199
General Options (Continued)
Configuration OptionDescription 
						

							170 Installing [email protected]/DOS
integration_greetingDetermines what greeting plays for integrated calls that have both rrr and sss (or rrrr 
and ssss) fields set. (The r’s indicate the number of digits in the extension of the user 
who was called but did not answer. The s’s indicate the number of digits in the ex-
tension of the user who made the call. See “Chapter 7: Defining Integration Pat-
terns” on page 81 for more information.)
True or False. The default is True.
When True, Amanda plays the RNA greeting for the mailbox identified by rrr.
When False, Amanda plays the system greeting.
In either case, a message is taken for rrr from sss.
The default appears in install.cfg as:
set integration_greeting true
irqThe IRQ over which the voice board communicates with the Amanda system.
The default is 7. The range is 0-15, but do not change this setting unless instructed 
to by an Amanda Company employee. Most IRQs are unavailable because they are 
used by PC components.
The default appears in install.cfg as:
set irq 7
lcoffThe minimum necessary duration of loop current off before the voice board driver 
recognizes that the loop current is off.
Number of hundredths of seconds (from 1 to 6553) or the number -1 or 0. For exam-
ple 10 is .1 second. The default is -1.
When 0, the voice board’s default is used. The board default is infinite.
When -1, there is no wait.
The default appears in install.cfg as:
set lcoff -1
lcvalidThe length of time that the voice board driver ignores loop current transition events 
(on, off, and drop) after starting PCPM.
Number of hundredths of seconds (from 1 to 255) or the number -1 or 0. For example 
10 is .1 second. The default is 0.
When 0, the voice board’s default is used. The board default is 10 ms (.01 second).
When -1, this option is disabled and no events are ignored.
The default appears in install.cfg as:
set lcvalid 0
General Options (Continued)
Configuration OptionDescription