Amanda Work Group 7xx Installation Manual

							Chapter 14: Configuration Reference 191
Hot Box Options
Configuration OptionDescription
hot_boxDefines the mailboxes to which Amanda goes when she detects special PCPM tones. 
You can have up to 10 hot_boxes. For example, you can configure a hot_box to de-
tect connections from TDD machines for deaf communications. 
In most cases, only one hot_box is defined to detect fax tones and the remainder are 
unused. 
You provide a mailbox next to the corresponding PCPM code (12 to 21). 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.
N
OTE:
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 Tech-
nical Note 8, “Special Tone Detection.”
The defaults appear in install.cfg as:
set hot_box -1 n
where n
 is-1 or  the PCPM code minus 12. (For example, for PCPM code 12, you 
use 12-12 or 0. The range for n is from -1 to 9.) 
						

							192 Installing [email protected]/DOS
Network Options
Configuration OptionDescription
client_activation_
keyActivation key that validates the value specified by n_clients. It is normally gener-
ated automatically as the client connections are installed. If you change or add a 
board later, you need another activation key because the key is based on the serial 
number for the first board. The first board is based on its low position in memory 
(the Amanda Company voice board is usually at D8000). Get the key from your 
Amanda Company sales representative. 
The default is 0, which means there is no client activation key. 
See also n_clients.
The default appears in install.cfg as: 
set client_activation_key 0
dialer_max_portSpecifies the highest Amanda telephone port to be considered for use when Amanda 
Dialer dials a number. The range is 0 to the highest port number available. 
The default is 0. When dialer_min_port and dialer_max_port are both 0, Amanda 
uses all ports. 
The default appears in install.cfg as:
set dialer_max_port 0
dialer_min_portSpecifies the lowest Amanda telephone port to be considered for use when Amanda 
Dialer dials a number. The range is 0 to the highest port number available. 
The default is 0. When dialer_min_port and dialer_max_port are both 0, Amanda 
uses all ports. 
The default appears in install.cfg as: 
set dialer_min_port 0
dir_formatDetermines how names associated with mailboxes in the employee directory are for-
matted for the client applications. %1 expands to the “Directory Name 1 field, 
“%2” to the “Directory Name 2 field, and “%c” to the “Comment” field. Other 
characters (such as space) are taken literally. The most common value is %1 %2. 
The default is %1 %2. 
The default appears in install.cfg as:
set dir_format %1 %2 
						

							Chapter 14: Configuration Reference 193
multiple_clientsControls whether multiple connections (logons) are allowed from the same mailbox. 
The default is 3.The range is from 1 to 3. When 1, only one connection is allowed 
per mailbox. When 2, only one connection is allowed per mailbox, with the excep-
tion of the special mailbox 999, which can connect multiple times. When 3, any 
mailbox can connect multiple times. 
The default appears in install.cfg as:
set multiple_clients 3
n_clientsAlong with client_activation_key, controls the number of client connections 
(logons) that can simultaneously connect to the [email protected]/DOS serv-
er. This is normally set automatically when the client connections are installed into 
the server. 
The default is 0, which means 1 client. The range is from 0 to 99 (99 is 100 clients).
The default appears in install.cfg as:
set n_clients 0
service_nameThe servers NETBIOS name. 
The default is AMANDASERVER. 
The default appears in install.cfg as:
set service_name AMANDASERVER
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
 
Network Options (Continued)
Configuration OptionDescription 
						

							194 Installing [email protected]/DOS
Outdial Options
Configuration OptionDescription
box_outdialControls special mailbox options.
You provide a mailbox for each telephone digit that becomes a special mailbox op-
tion. 
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 
users 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. 
						

							Chapter 14: Configuration Reference 195
Per Port Options1
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 (on the Users 
screen of the Standalone) or Directory Name 1 or Directory Name 2 (in the Mailbox 
window 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.  
						

							196 Installing [email protected]/DOS
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 al-
lows 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 op-
erator 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 supervision 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 
conferences. 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.
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 answering 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.
Per Port Options1 (Continued)
Configuration OptionDescription 
						

							Chapter 14: Configuration Reference 197
1 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.
Serial Port Options
Configuration OptionDescription
baud1
baud2
baud3
baud4The bps (bits per second) for the logical serial port with the same number. For ex-
ample, 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 exam-
ple, 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 parityn
 none
where n
 is the logical serial port 1, 2, 3, or 4. 
						

							198 Installing [email protected]/DOS
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 
connected.
Only after this matching can Amanda communicate with devices, such as SMDI in-
terfaces, 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. However, 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 exam-
ple, 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.
Serial Port Options (Continued)
Configuration OptionDescription 
						

							Chapter 14: Configuration Reference 199
SMDI Options
Configuration OptionDescription
smdi_base_portUse this option to identify Amanda’s first voice mail port. On Norstar KSUs, the 
first voice mail port is identified by the number for the extension to which the port 
is connected. So, if the first voice mail port is connected to extension 241, then 
smdi_base_port would be 241, with every successive port having a sequential exten-
sion 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 241. The range is 0 to 32000.
The default appears in install.cfg as:
set smdi_base_port 241
smdi_typeIndicates the fact that the boards are being used with a Norstar KSU.
The default is NTEL.
The default appears in install.cfg as:
set smdi_type NTEL 
						

							200 Installing [email protected]/DOS
T1/DID Options
Configuration OptionDescription
did_dtmfIndicates what kind of integration digits Amanda reads when did_mode is True. 
True or False. The default is True.
When True, Amanda expects either MF or DTMF digits. 
When False, she expects the digits as pulse.
See also did_mf and did_mode.
The default appears in install.cfg as:
set did_dtmf true
did_mfDetermines what kind of integration digits Amanda reads when did_dtmf is True 
and did_mode is True. Otherwise, Amanda ignores this option.
True or False. The default is False.
When True, Amanda expects MF digits.
When False, Amanda expects DTMF digits.
See also did_dtmf and did_mode.
The default appears in install.cfg as:
set did_mf false
did_modeIndicates whether Amanda is using DID. 
True or False. The default is False.
When True, Amanda expects a DID interface (such as EXACOM) that processes a 
hookflash as battery reversal.
When False, Amanda does not expect a DID interface.
The default appears in install.cfg as:
set did_mode false
ring_modeIndicates whether Amanda expects a loop start or a DID interface line.
True or False. The default is True.
When True, Amanda expects a loop start line, and new calls are indicated by ring 
voltage.
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