Amanda Work Group Installation Manual

							Chapter 18: Configuration Reference 227
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 (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. 
 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. 
						

							228 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.
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. 
						

							Chapter 18: Configuration Reference 229
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.
pbxIndicates which Amanda telephone ports are connected to which PBXs. You pro-
vide 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.
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. 
						

							230 Installing [email protected]/DOS
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 parity
n none
where n
 is the logical serial port 1, 2, 3, or 4. 
						

							Chapter 18: Configuration Reference 231
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 
						

							232 Installing [email protected]/DOS
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 smdi 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
smdi_delayThe time that Amanda waits after the phone rings and is answered, before looking 
at the integration information (if any). 
Use a number of tenths of seconds or 0. The default is 0. The range is 0-255. This 
option does not apply to inband integration.
When non-zero, Amanda waits the specified time. This allows more than one string 
to be sent to a given port per telephone call. The number should allow enough time 
for all the strings to arrive, forcing Amanda to use only the last (most recent) one. 
(The integration time specified in the 1001.PBX configuration file can be zero or 
near zero, because Amanda has already waited for smdi_delay time to pass.)
For example, if smdi_delay is set to 30 (3 seconds), it is OK to use a pattern such as 
integration 1 ..., which designates a 0.1-second integration timeout because Aman-
da waits 3 seconds for the last packet to be received. 
The default appears in install.cfg as:
set smdi_delay 0
smdi_maxThe maximum number of characters expected in a generic SMDI packet.
The default is 143. The range is from 1 to 143. Use this when smdi_type is generic.
The default appears in install.cfg as:
set smdi_max 143 
						

							Chapter 18: Configuration Reference 233
smdi_portThe logical serial port (represented by serial_portn) to use for SMDI integration. 
The port should already have been configured as a serial port using the options in 
the Serial section of Advanced Configuration.
The range is 0 to 4. The default is 0 (no serial port used). 
The default appears in install.cfg as:
set smdi_port 0
smdi_pretimeoutThe maximum number of seconds that an SMDI packet can precede the forwarded 
call.
The default is 50. The range is from 1 to 99. Use this when the smdi_type is smdi, 
necmci, or generic.
The default appears in install.cfg as:
set smdi_pretimeout 50
smdi_startThe position in the integration packet sent by the telephone switching system where 
the field containing the port number begins. The first position in the packet is num-
ber 1.
Use this option when smdi_type is necmci or generic.
The default is 8. The range is 0-65535.
The default appears in install.cfg as:
set smdi_start 8
smdi_stopThe position in the integration packet sent by the telephone switching system where 
the field containing the port number ends. The first position in the packet is number 
1.
Use this option when smdi_type is necmci or generic.
The default is 11. The range is 0-65535.
The default appears in install.cfg as:
set smdi_stop 11
SMDI Options (Continued) 
						

							234 Installing [email protected]/DOS
smdi_termUsed only when smdi_type is generic. The terminating characters (if any) which 
define the end of a generic SMDI packet. You can include the following “escape” 
sequences (similar to those used in strings within tokens)
Sequence Meaning
\n newline (carriage return followed by a linefeed)

 carriage return
\j linefeed
\a attention
\d end of transmission
\\ backslash
	 tab
\digitsThe digits must represent the octal number for any character in the range 
0 to 377 (That is 0 to 255 decimal). For example, to include the ASCII 
character A (which is 101 in octal), you use \101.
When this option is not set, packets end only when smdi_max characters have been 
received.
The default is an empty string, which means that packets end only when smdi_max 
characters have been received.
The default appears in install.cfg as:
set smdi_term 
smdi_typeIndicates which SMDI integration protocol Amanda is to use.
For Bellcore Standard, use smdi. 
For AT&T System 75 or Definity-G3, use s75. 
For NEC 2000 Message Center Interface use necmci. 
For Ericsson M-110 use md110. 
For the generic driver, use generic.
The default appears in install.cfg as:
set smdi_type smdi
SMDI Options (Continued) 
						

							Chapter 18: Configuration Reference 235
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
n_aniThe number of Automatic Number Identification (ANI) digits to be read by Amanda 
between the first and second wink in a 2-wink T1 environment. 
The default is 0. The range is 0-255.
In a 2-wink T1 environment, Amanda may receive more digits than the Brooktrout 
buffer can hold. So Amanda reads up to n_ani digits between the first and second 
winks and starts processing them as part of the regular inband integration. After the 
second wink, Amanda reads the remaining digits.
See also t1_mode and n_winks.
The default appears in install.cfg as:
set n_ani 0 
						

							236 Installing [email protected]/DOS
n_winksIf t1_mode is True, tells whether the environment is an immediate (0-wink), 1-wink, 
or 2-wink environment.
Number from 0 to 2. The default is 1. When 2, you need to set n_ani.
See also t1_mode and n_ani.
The default appears in install.cfg as:
set n_winks 1
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
t1_modeIndicates whether Amanda is to use a T1 line.
True or False. The default is False.
When True, Amanda expects a T1 line and can process it using a Brooktrout 24000 
board.
When False, Amanda does not expect a T1 line.
The default appears in install.cfg as:
set t1_mode false
T1/DID Options (Continued)
Configuration OptionDescription