Key Voice Voice Processing System Installation And Maintenance Manual

							INSTALLATION AND MAINTENANCE MANUAL 4/0012-22Configuration FileEntryDescriptionMinimumValue toMaximumValueDefault SetupMBOX DEFAULT
DIGIT
(Enter this as one line
of text in the VM.CFG
file.)When the VP system plays a mailbox greeting to a
caller, and the field AFTER PLAYING GREETING is
set to WAIT FOR DIGIT, the VP system plays the
complete greeting, then waits 5 seconds for the caller
to enter a digit. If the caller does not enter a digit, the
VP system normally takes whatever action is specified
in the field AFTER LEAVING MESSAGE.  If you
include MBOX DEFAULT DIGIT in the VM.CFG file,
the VP system processes the call as if the caller
pressed that digit.  For example, if the VM.CFG file
includes the line:
MBOX DEFAULT DIGIT = 0
and the caller does not enter a digit, the VP system
assumes the caller pressed 0 and tries to route the call
to the operator.10 digits.MENU..
(Enter this as one line
of text in the VM.CFG
file.)Every voice menu in the VP system can be configured
so that any digit can correspond to any option.  To
change from the default digit that corresponds to menu
item, enter:
MENU.. = N
where n is the new digit you want to correspond to that
option.
To disable a menu option, enter X as the digit
corresponding to the option.MESSAGE PAUSE
TIMEWhile a mailbox owner is listening to his/her
messages, he/she can press 0 to temporarily pause
the playback.  The VP system pauses for 30 seconds,
then automatically continues playing the message.
Use this option if you want to change the pause time.
For example, if you want the VP system to
automatically continue after 60 seconds, enter the
following line in the VM.CFG file:
MESSAGE PAUSE TIME = 6030 seconds.MINIMUM MESSAGEIf you find that the VP system is recording short (1 or 2
second) messages if a caller hangs up without
speaking, then you can specify that messages shorter
than a particular length can be ignored.  For example,
entering MINIMUM MESSAGE = 2 in the VM.CFG file
tells the VP system to throw away any messages
shorter than 2 seconds.1 to 900The VP system
keeps all
messages,
irrespective of
length.MONITORIf you need more detailed information than that
supplied in the log file, then you can turn on the
Monitor feature.  You can also specify which events
should be monitored and which should not.  The
additional information is interspersed among the usual
log records.  Remember that this extra information
makes log files much larger.Monitor not
enabled. 
						

							INSTALLATION AND MAINTENANCE MANUAL 4/0012-23Configuration FileEntryDescriptionMinimumValue toMaximumValueDefault SetupMW OFF REPSIf the host telephone system does not reliably control
the message-waiting lamps on the extensions, you can
use this option to force the VP system to try more than
one time to turn off an extension’s message-waiting
lamp. For example, if you want the VP system to try 3
times to turn off a message-waiting lamp, insert the
following line in the VM.CFG file:
MW OFF REPS = 31 to 5Try one time.MW ON REPSIf the host telephone system does not reliably control
the message-waiting lamps on the extensions, you can
use this option to force the VP system to try more than
one time to turn on an extension’s message-waiting
lamp. For example, if you want the VP system to try 3
times to turn on a message-waiting lamp, insert the
following line in the VM.CFG file:
MW ON REPS = 31 to 5Try one time.MW PRIORITYInclude this option in the VM.CFG file to indicate the
priority assigned to message waiting lamp operation.
To set the priority to a medium level, for example,
enter the following line in the VM.CFG file:
MW PRIORITY = 5
A priority of 9 is the highest.  Note that by assigning a
higher priority to the message waiting lamp priority,
you shift more system resources to this function, which
slows the completion of other system tasks.  For this
reason, it is recommended you assign this function a
priority of 3 or less.1 to 91MW Q SIZEInclude this option in the VM.CFG file to indicate the
number of events that can be held in queue waiting for
an idle port.  Events include commands for the system
to turn on or off message waiting lamps.  Note that as
the queue grows, system response to call processing
tasks slows.  To allow, for example, 100 events to
queue, enter the following line in the VM.CFG file:
MW Q SIZE = 10020 - 100050NO ACCOUNT IN
LOG
(Enter this as one line
of text in the VM.CFG
file.)Version 8.1 of the VP system introduced account
numbers.  These account numbers are stored in the
log file.  However, if you have software that processes
the log files, and you do not want the format of the log
files to change, then you enter the following line in the
VM.CFG file:
NO ACCOUNT IN LOGThe VP system
includes the
account number in
the log file.NO NAME
TRANSFER
(Enter this as one line
of text in the VM.CFG
file.)On a call transfer, the VP system normally says the
called party’s name just before it places the caller on
hold to transfer the call:
“Please hold while I transfer the call to [name].”
Use this option if you do not want the VP system to
play the called party’s name.  The VP system says:
“Please hold while I transfer the call.”
You must re-record prompt number 96 to say the
above phrase, or substitute the optional pre-recorded
version of the above phrase.The VP system
plays the called
party’s name (or
the prompt, “that
extension” if no
name is recorded
or the mailbox
owner’s first name
is prefixed with @)
before beginning
the call transfer. 
						

							INSTALLATION AND MAINTENANCE MANUAL 4/0012-24Configuration FileEntryDescriptionMinimumValue toMaximumValueDefault SetupNO PC BEEPThis option prevents the VP system from making a
beep sound (for example, when reporting an error or
when you reach the end of an input field).The beep is
enabled.NO RECORD BEEPWhen the VP system is about to record a message,
greeting, etc., it says, “Please speak after the tone,”
then plays a short tone.  Include this option if you want
to disable this tone.  The tone is disabled for every
recording the VP system makes.  If you want to
disable the tone in response to an in-band packet
received from the telephone system, include the
sequence “:N” at the end of the rule in the TRANS.TXT
file.6 times.NO SERIAL MW
REFRESH
(Enter this as one line
of text in the VM.CFG
file.)When the VP system starts up, it refreshes all
message waiting lamps via serial link.  Add this option
to the VM.CFG file to disable this functionality.
If there is no serial integration, this option will have no
effect.All message
waiting lamps are
updated every
time the serial link
is re-started.NO VIDEO MEMORYInclude this parameter in the VM.CFG file on VP
systems that do not include computer video memory.
(Also see UNITIZED.) This affects DOS-based
systems only.VP system
assumes that the
PC has video
memory.NOTIFY PRIORITYWhile the VP system is not busy handling calls, it
performs several low-priority tasks, such as self-
checks, display updates, etc. One of these tasks is to
scan the mailboxes to see if it is time to notify one (call
out to deliver new messages). Since this is a low-
priority task, you may see some delay between the
time when a mailbox owner is due to be notified and
the time when the call is actually made. If you want to
minimize these delays, you can boost the priority of
this task. The priority value can vary from 1 through 9,
with 9 being the highest priority.
Do not adjust this value unless you are sure that it is
causing a problem.  By allocating a higher priority to
this task, you are taking processing time away from
other tasks.1 to 91.NOTIFY REPSWhen the VP system calls to deliver the messages, it
plays a prompt:  “Message for [name].  Press 1 if you
would like to hear the messages ...[pause].”  The VP
system repeats this prompt until you press 1, or until it
has played the prompt a specific number of times.
This option allows you to specify how many times the
prompt should be repeated.1 to 96 times.NOTIFY RINGSWhen the VP system calls a mailbox owner to deliver
new messages, it lets the called telephone ring n times
before abandoning the call.  You can use this
parameter to adjust the number of rings.
NOTIFY RINGS = N1 to 20The VP system
lets the telephone
ring 6 times. 
						

							INSTALLATION AND MAINTENANCE MANUAL 4/0012-25Configuration FileEntryDescriptionMinimumValue toMaximumValueDefault SetupOFFHOOK DELAYThe VP system defaults to begin accepting digits 500
milliseconds after answering the call.  Some telephone
systems may begin sending digits before the 500 ms
has expired, so the VP system may miss them.  If you
find that the VP system is missing digits at the
beginning of a call, you can lower the 500 ms time to
300 ms, by entering the following line in the VM.CFG
file:
OFFHOOK DELAY = 30010 to 1000
500 milliseconds
(0.5 seconds).
Note:  The most
common causes of
the VP system
missing digits
upon call answer
are a mis-set
INITIAL PAUSE
and a missing or
incorrect
TRANS.TXT file.
Do not adjust this
timer until you
have eliminated
these possibilities
as a source of the
problem.OMIT GROUP
SENDER
(Enter this as one line
of text in the VM.CFG
file.)Normally when a mailbox owner sends a message to a
Group box and he/she is also a member of that Group
box, a copy of the message is sent to his/her box.  Use
this parameter if you do not want for the sender of a
Group box message to receive a copy.Sender of Group
box message
receives a copy if
a member of that
group.ONHOOK DTMFThis parameter tells the VP system that it should listen
for DTMF digits even while it is on-hook.  Some
telephone systems implement in-band integration by
sending DTMF digits at the beginning of the call,
before they ring the VP system port.  This option
requires the use of special hardware (for example,
Rhetorex 464 and Dialogic D41E boards).  Contact
Technical Support if you need further information.The VP system
does not detect
DTMF digits until
the port is off-
hook.OUTBOUND DELAYThis parameter is for use with the optional Outbound
Telemarketing module.  When the VP system has
finished with an Outbound Telemarketing call, it waits
for a few seconds to allow the line time to release (see
CLEAR DOWN DELAY).  It then pauses for another
few seconds before seizing the line to make another
telemarketing call.  Use the OUTBOUND DELAY
parameter to define how long this second pause
should be.  For example, if you want the VP system to
pause for 15 seconds between outbound calls on a
specific line, you enter:
OUTBOUND DELAY = 151 to 10,0000 seconds. 
						

							INSTALLATION AND MAINTENANCE MANUAL 4/0012-26Configuration FileEntryDescriptionMinimumValue toMaximumValueDefault SetupPA.BUSYThis parameter specifies the sequence that the VP
system is to dial to get back to the caller on hold, if the
PA system is busy.  The sequence can consist of the
digits 0-9, A-D, and the following special characters:
,
Short pause (duration can be changed in TECHNICAL
INFORMATION screen (VP systems) / PBX
INFORMATION screen (NTVP systems) - default is 1
second).
%
Medium pause (equal in length to 4 commas).
L
Long pause (equal in length to 8 commas).
!
Hook-flash (duration can be changed in TECHNICAL
INFORMATION screen (VP systems) / PBX
INFORMATION screen (NTVP systems) - default is 1
second).
$
A 4 second on-hook, then proceeds to next step in
sequence (duration can be changed using the LONG
HOOK-FLASH parameter).
X
Substitute the box number of the Mailbox currently
handling the call.
H
Hang up immediately after dialing the sequence.
F
Substitute the number in the TRANSFER TO field of
the Mailbox currently handling the call.
Any other character
Can be used for punctuation and are ignored.
For example, if the telephone system requires a hook-
flash, followed by the code 47 to get back from a busy
PA system to the caller, you enter the following line in
the VM.CFG file:
PA.BUSY = !,47None.PA.CANCELThis parameter specifies the sequence the VP system
is to dial to get back to the caller on hold, after the VP
system has announced the call over the P.A. system.
The sequence can consist of the digits 0-9, A-D, and
the special characters listed above, entered as:
PA.CANCEL =None.PA.INITThis parameter specifies the sequence the VP system
is to dial to place the caller on hold and call the PA
system on the phone system.  The sequence can
consist of the digits 0-9, A-D, and the special
characters listed above, entered as:
PA.INIT =None. 
						

							INSTALLATION AND MAINTENANCE MANUAL 4/0012-27Configuration FileEntryDescriptionMinimumValue toMaximumValueDefault SetupPA.REPEATSWhen the VP system calls the PA system, it
announces the call.  You can control how many times
the VP system should repeat the announcement.  For
example, if you would like the announcement to be
repeated 4 times, enter the following line in the
VM.CFG file:
PA.REPEATS = 4
The PA announcements can be re-recorded using the
prompt recording utility.1 to 10Announcement
repeats 3 times.PAGER APPENDThis option affects digital pagers only.  If the pager
service requires any digits to be added to the end of
callback numbers (such as #), you can enter:
PAGER APPEND = NNNN
where n are the digits added.Nothing appended
to callback
number.PAGER PREFIXThis option affects digital pagers only.  If the pager
service requires any digits to be added to the
beginning of callback numbers, or if you require a
pause between the time that the pager service
answers and when it is ready to accept digits, you may
use this parameter.  You may enter any DTMF digit, or
, (short pause), % (medium pause equal to 4 commas)
or L (long pause equal to 8 commas), entered as:
PAGER PREFIX = NNNNNo digits are
prefixed to
callback number.
It is sent
immediately upon
answer by paging
service.PAGER RETRYThe VP system keeps trying to call the pager until it
makes the call successfully.  If, for instance, the
paging service was out-of-order and returning a busy
signal or ring-no-answer to the VP system, the call
attempts could continue forever.  This parameter sets
the maximum attempts (n) to call a pager before
abandoning the process, entered as:
PAGER RETRY = N20 attempts.PAGER TRAILThis option affects digital pagers only.  If the pager
service requires a delay after the end of the callback
digits, before going onhook, use this option to enter
the length of the required delay in seconds:
PAGER TRAIL = N
where n is the length of time the VP system should
wait before going on-hook.1 to 301 second.PAGE TIMEThis parameter disables call-progress tone detection
on pager calls and uses a timer (n - in seconds) to
control the call.  For tone pagers, the VP system dials
the pager number, waits n seconds, then disconnects.
For digital pagers, the VP system dials the pager
number, waits n seconds, dials the callback number,
then disconnects.  Enter:
PAGE TIME = N
Note:  Since call progression tones are not monitored,
the VP system does not detect a busy.
This option is effective system-wide.  If you want to
disable call-progress detection for specific pagers only,
use the N character as the last character in the
PAGER NUMBER field.1 to 30The VP system
uses call-progress
tones to determine
when a paging
service has
answered. 
						

							INSTALLATION AND MAINTENANCE MANUAL 4/0012-28Configuration FileEntryDescriptionMinimumValue toMaximumValueDefault SetupPLAYBACK DELAYSome telephone systems, as well as some cellular
telephones, have a short period following the pressing
of a DTMF digit in which incoming audio transmission
is blocked.  This can cause the calling party to miss
the first few words of a prompt, greeting or message
playback.  This parameter allows a delay to be
introduced following the receipt of a DTMF digit before
playback of the audio begins.  The entry is:
PLAYBACK DELAY = N
where n is the number of seconds of delay desired.1 to 10No added delay.PMS VIA TEXT FILESThis option allows the VP system to communicate with
the PMS via text files (normally, a serial link is used).
Each time a guest checks in or changes rooms, the
PMS creates a text file, which is read by the VP
system. The VP system processes the information in
the text file, then deletes the file. To implement,
include the following line in the VM.CFG file:
PMS VIA TEXT FILES
The filename should be in the form CKINnnnn.DAT,
where nnnn is a 4-digit sequence number between
0001 and 9999. The file is in ASCII (text) format, with
one record per line:
line 1: box number (required)
line 2: password (leave blank if not required)
line 3: class of service (leave blank if not required)
line 4: language (leave blank if not required)
line 5: previous room number (leave blank if not
required)
line 6: guest last name (leave blank if not required)
For example, if a guest named Smith has just checked
in to room 104 and chosen a password of 5432, the
file would look like this:
104
5432
Smith
The 3 blank lines are for class of service, language,
and previous room number.Use serial link for
PMS integration.POOLED RINGOn some telephone systems, there is no hunting
feature.  When an incoming call is detected, the
telephone system rings all the VP systems ports
simultaneously.  This causes the VP system to answer
all its ports, even though there is only one call.  If you
want to tell the VP system that this is happening, set
the RINGS TO ANSWER field on the LINE
INFORMATION screen to 99 for all ports.  This tells
the VP system to answer on one port, then pause to
see if the other ports stop ringing.  If they do not, the
VP system answers on another port (as there must
have been two calls ringing in) and pauses again, etc.
If you have problems with this feature, try adjusting the
pooled ring time.1 to 2000500 ms. 
						

							INSTALLATION AND MAINTENANCE MANUAL 4/0012-29Configuration FileEntryDescriptionMinimumValue toMaximumValueDefault SetupPULSE
CALIBRATION
(Enter this as one line
of text in the VM.CFG
file.)If you are using the rotary detection capabilities of the
Rhetorex 464 or Vantage boards, you need to ask the
caller to dial a known digit at the beginning of each
call, so that the VP system can calibrate itself to match
that specific rotary dial.  It is best to use the digit 0 or 9
for calibration.  For example, to use the digit 0, you
would enter the line:
PULSE CALIBRATION = 0
then record the following phrase at the end of the initial
greeting:
“or if you are calling from a rotary telephone, please
dial 0 now.”
If you are using Dialogic boards, no digit is required.None.PULSE SPEEDIf you are using the rotary detection capabilities of the
Rhetorex 464 or Vantage boards, use this option to tell
the VP system whether callers are calling from
telephones with 10pps dials, or 20pps dials (North
America and Europe almost exclusively use 10pps
dials, Japan uses 20pps dials). The options are:
PULSE SPEED = 10 or
PULSE SPEED = 20 or
PULSE SPEED = BOTH10pps.QBOX ARCHIVEIf you want the VP system to create a new data file
each day for the data-entry Question boxes, then
include this option in the VM.CFG file.  At midnight
each night, the VP system moves the current data files
into an archive directory called DATA\ARCHIVE.  Each
file is named to reflect the date and the Question
box(es) with which it is associated.Do not archive.
Keep adding to the
same data files
every day.QBOX DATA PATHThis option lets you choose the directory where you
want the VP system to store its data files.  This could
be on a shared drive (for example, a network server),
allowing another program to access the data collected
by the VP system.  Enter as:
QBOX DATA PATH =   Data files are
stored in a DATA
directory under the
current directory.QBOX DATA PRINTThis option is used in conjunction with the Question
box data entry feature.  Using this option, you can
instruct the VP system to print the data collected at the
end of each call.  The data is sent to a printer
connected to LPT1.Do not print the
data.QBOX DATA PRINT
EJECT
(Enter this as one line
of text in the VM.CFG
file.)This option is used in conjunction with the Question
box data entry feature.  If you are printing the collected
data to a single-sheet feed printer (such as a laser
printer), you may configure the VP system to use one
page for each record by entering the parameter as:
QBOX DATA PRINT EJECTDo not send a
page-feed to the
printer. 
						

							INSTALLATION AND MAINTENANCE MANUAL 4/0012-30Configuration FileEntryDescriptionMinimumValue toMaximumValueDefault SetupQBOX HIDE ACCT
NUMBERS
(Enter this as one line
of text in the VM.CFG
file.)If you are using a Question box as a data entry device,
the VP system stores the account number in the data
file.  However, if you have software that processes the
data files, and you do not want the format of the data
files to change, then you should enter the following line
in the VM.CFG file:
QBOX HIDE ACCT NUMBERSThe VP system
includes the
account number in
the data file.QBOX POS CONFIRMThis option is used in conjunction with the Question
box data entry feature.  If you set up a Question box to
repeat entered digits back to the caller and request
confirmation, this option lets the VP system know what
to do if the caller does not respond when the VP
system says, “If this is correct, press 1.”  If you do not
include this option, the VP system accepts the digits
anyway.  If you include the option, the VP system
discards the digits and moves on to the next question
if the caller does not respond by pressing 1.Accept data even
if caller does not
respond when
asked for
confirmation.QBOX USE CONFIRM
NUMBERS
(Enter this as one line
of text in the VM.CFG
file.)This option is used in conjunction with the Question
box data entry feature.  If you include this option in the
VM.CFG file, the VP system issues a 4-digit
confirmation number to each caller who uses the
Question box.  The confirmation number is stored as
part of the data file.Do not issue
confirmation
numbers.REMAIN OFFHOOKThis parameter is for use only with those D.I.D.
conversion units that operate in the “pass-through”
mode.  Units using the “digit store and forward”
method, which converts D.I.D. signaling to loop
signaling, do not require this parameter.  The
command is entered as:
REMAIN OFFHOOK = X, Y
where x is the VP system port number and y is the
number of seconds that port is to remain on-hook at
the termination of a call.  At the expiration of the time y
the An entry such as the one shown above is required
for each VP system port connected to a D.I.D. line.Other ports (if equipped) operate normally.
For example, if you had a 2-line system and the VP
system had to remain on-hook for 3 seconds at the
end of a call, you would enter:
REMAIN OFFHOOK = 1,3
REMAIN OFFHOOK = 2,3port again goes off-hook,
ready to accept digits from the next call.Do not remain off-
hook. 
						

							INSTALLATION AND MAINTENANCE MANUAL 4/0012-31Configuration FileEntryDescriptionMinimumValue toMaximumValueDefault SetupREMOTE PAUSEWhen remotely changing the pager/notification/transfer
number, you can insert a pause in the number to be
dialed by entering three stars (***).  The default is for
the VP system to replace these three stars with a
single comma (defined by PAUSE LENGTH on the
TECHNICAL INFORMATION screen (VP systems) /
PBX INFORMATION screen (NTVP systems)).
However, you can use the REMOTE PAUSE option to
specify that a remotely programmed pause should be
of greater length.  For example, if you enter the line:
REMOTE PAUSE = 4
then the VP system replaces the 3 stars with 4
commas.1 to 10The VP system
replaces the 3
stars with 1
comma.REPEAT MWThe VP system normally only attempts to turn on
message waiting lamps when the number of new
messages in a mailbox goes from zero to one (when
subsequent new messages arrive, the VP system
assumes that the lamp is already on).  When a
mailbox owner exits from his/her mailbox after listening
to messages, the VP system only attempts to turn off
the message waiting lamp if there was at least one
new message in the box when it was opened.  You
can use the REPEATMW statement to indicate to the
VP system that it should attempt to turn on the lamp
every time a new message arrives and should attempt
to turn off the lamp every time an owner exits from a
mailbox, leaving no new messages.
Use this parameter only if absolutely necessary for the
telephone system, as its use may greatly increase the
VP system processing time and line usage.0 to 2The VP system
turns on message
waiting lamps only
when the number
of new messages
goes from zero to
one.  The VP
system turns off
the message
waiting lamps only
when a mailbox
owner exits from
his/her box and
the number of new
messages goes
from non-zero to
zero.RESPONSE TIMEThe time (in seconds) a caller is given to respond to a
system prompt (for example, “If this is correct, press
1”).
RESPONSE TIME = N1 to 95 seconds.REW DIGITWhile the VP system is playing a Routing box greeting,
the caller can skip forwards 5 seconds, or backwards 5
seconds by using the FF DIGIT (fast-forward) or REW
DIGIT (rewind).  To use the REW digit, the following
conditions must be met:
1. The REW digit must be defined in the VM.CFG
file.
2. The DESTINATION FOR DIGIT field in that
particular Routing box must be blank.No REW digit
defined.RING ONThe VP system recognizes an incoming call by the ring
voltage presented at the voice board port.  If the
telephone system has a non-standard ring cycle
consisting of short bursts of ring voltage, the voice
board may not recognize the call, or may not answer
on the proper number of rings as programmed on the
LINE INFORMATION screen.  If necessary, use this
parameter to adjust the ring cycle ON time to match
that of the telephone system.  Enter the time (n, in
milliseconds) of the ON portion of the ring cycle:
RING ON = N1 to 5000300 ms (3/10 of a
second).