NEC Ucd-Xl Installation Guide

							NDA-30078   Revision 1.0Page 29
UCD-XL Installation Guide Installation
Miscellaneous Set 
Up1. At this point, the configurations of one or more UCD-XL components have 
been saved, but the terminals and ports have not yet been set up to work with 
UCD-XL.
The installation software issues the prompt
I_e ]ecd RU dXU E>9H CicdU] 1T]Y^YcdbQd_b b__d d_ cUd e`
dXU 1T]Y^YcdbQd_b dUb]Y^Q\ Q^T_b =39 `_bdc
9V i_e [^_g dXU b__d `Qccg_bT Q^T gYcX d_ S_^dY^eU U^dUb ´iµ+
_dXUbgYcU U^dUb ´^µ _b ´aµ d_ QR_bd dXU Y^cdQ\\QdY_^*
2. To abort the installation of UCD-XL, type n or q and press Enter. If you wish 
to continue, type y and press Enter.
The installation software issues the prompt
@\UQcU 5^dUb DXU ceb__d @Qccg_bT*
3. Type the root password and press Enter.
Some informational messages will appear as each terminal and port device is 
disabled by UNIX. 
4. Upon conclusion, the installation software displays the following message and 
prompt:
9^cdQ\\QdY_^ _V E34H< Yc S_]`\UdU
@bUcc 5^dUb [Ui d_ bUdeb^ d_ dXU 1@= @\QdV_b] =U^e*
5. Press Enter to go to the APM Platform Management Menu and the APM.
End of procedure.
Note:
If you have installed and configured the UCD-XL components successfully, you 
are now ready to build the databases that UCD-XL requires. Follow the instruc-
tions in Database Requirements on page 41. 
						

							Installation UCD-XL Installation Guide
Page 30NDA-30078   Revision 1.0
This Page Left Blank. 
						

							NDA-30078   Revision 1.0Page 31
UCD-XL Installation Guide Configuring UCD-XL
Chapter 3 Configuring UCD-XL
This chapter provides instructions for configuring UCD-XL. You can refer to the 
Applications Manager (APM) Operations Manual for more information about 
configuring the software.
Application Characteristics
UCD-XL is configured into the APM system using the Add function of the 
Application Configuration option on the APM System Administration menu.
Note:This chapter describes an alternate method for configuring the components of 
UCD-XL when the installation procedure on page 11 is not performed.
1. Enter the APM option from the APM Platform Management menu.
2. Enter the System Administrator password at the APM password screen.
3. Enter the Application Configuration option from the System Administration 
menu.
This section contains the information that should be entered to the configuration 
file for UCD-XL. The Monitor, Messenger, and Administrator components 
must be configured; the Mediator component is optional.
Monitor: Provides call processing functions; specifically, Mon-
itor intercepts calls and routes them to a port of an ap-
propriate UCD group.
Mediator: Receives and transmits MCI messages between the
PBX and the VMS. This is required only when UCD-
XL will be used for voice mail access.
Messenger: Connects calls to ports, and checks port status.
UCD-XL may have more than one Messenger.
Administrator: Generates statistics of UCD call activity, and provides
the capability to dynamically trace UCD call activity.
For specific instructions on how to enter the following information, see the APM 
Operations Manual.
When adding UCD-XL to the APM Application Configuration file, characterize 
each of its components as follows:
Table 3-1  UCD-XL Component Characteristics
Parameter Monitor MediatorEach 
MessengerAdministrator
OAI Application Y N Y N
CRT Application N N N N
Communication Queue N Y N Y 
						

							Page 32NDA-30078   Revision 1.0
Configuring UCD-XL UCD-XL Installation Guide
Parameter definitions:
OAI Application  Indicates whether or not (Yes or No) this com-
ponent communicates with the NEAX2400
using OAI processes.
CRT Application  Indicates whether or not (Yes or No) this com-
ponent runs on the same screen as the APM,
rendering the APM temporarily inaccessible.

Communication QueueIndicates whether or not (Yes or No) this non-
OAI component needs an IPC queue to com-
municate with other processes.
Primary Configuration Parameters
On the APM’s Application Configuration Entry screen, make the entries shown 
below to the parameters indicated for each component.
The component names shown below are examples only. Queue key values may be 
changed if they conflict with another application.
Parameter definitions:
Application Name Specifies the name to be displayed in the APM
menus and identifies the component. This name is
displayed as entered. Lower case letters and punc-
tuation are acceptable; spaces are not permitted.
Executable Filename Specifies the path name of the program.
Group Names the group to which the component is asso-
ciated.
Response Mode Indicates the action that the APM is to take with
the component should a member of the group ter-
minate.
Table 3-2  Primary Configuration Parameters
Parameter Monitor Mediator Each Messenger Administrator
Application Name
UCDXL_Monitor UCDXL_MediatorUCDXL_Messengern
(n = 1, 2, 3)UCDXL_Admin
Executable 
Filename/oai/app/ucdxl/ucdmon /oai/app/ucdxl/ucdmci /oai/app/ucdxl/ucdmsgr /oai/app/ucdxl/ucdadm
Group UCDXL UCDXL UCDXL
Response Mode N(otify) N(otify) I(gnore) N(otify)
Initialization Batch N(o) or Y(es) N(o) or Y(es) N(o) or Y(es) N(o) or Y(es)
Termination Mode T(ermination Signal) M(essage) T(ermination Signal) M(essage)
Standard Output /dev/null /dev/null /dev/null /dev/null
Number Of Restarts * * * 0
Queue Key (Not applicable) 385 (Not applicable) 380 
						

							NDA-30078   Revision 1.0Page 33
UCD-XL Installation Guide Configuring UCD-XL
Initialization Batch Indicates whether or not (Yes or No) the compo-
nent is to be initialized automatically when the
OAI system is initialized.
Termination Mode Indicates how the APM is to notify the compo-
nent to terminate.
Standard Output Designates the file into which component output
is redirected.
Number of Restarts Indicates how many times the APM may restart
the component after it terminates erroneously.
Queue Key Indicates the unique number of the queue that is
to be assigned to the component.
Facilities
According to instructions in the APM Operations Manual, designate the following 
NEAX2400 facilities for UCD-XL Monitor and all UCD-XL Messengers, using 
the Facilities command on the APM Configuration Entry screen.
OAI Configuration
Using the OAI-Conf command on the Application Configuration Entry screen, 
select the entry shown for each of the following parameters required by the Monitor 
component. Use the instructions provided for this option in the APM Operations 
Manual.
Note:
Italicized entries may be changed.Table 3-3  Facilities
Monitor Messenger(s)
SMFN - Status Notification Facility SCF - Switch Control Facility
SMFR - Status Request Facility SMFR - Status Request Facility 
						

							Page 34NDA-30078   Revision 1.0
Configuring UCD-XL UCD-XL Installation Guide
Table 3-4  Monitor Parameters
Parameter Entry Description
Database Name #1
/oai/db/cur/ucdgrpsFilename of the UCD-XL Group Identification 
Database.
Database Name #2 /oai/db/cur/ucdports Filename of the UCD-XL Port Assignment Database.
Timeout Value #1
30Default frequency of port inspection, in minutes. This 
may be overridden by the value given for a group in the 
Group Identification Database (see page 42). If the 
group’s value is 0 and the default value is 0, inspections 
of that group will not occur.
Timeout Value #20Unused by Monitor.
Tenant Number
0Specifies the number of the tenant that UCD-XL 
Monitor serves. (0 means all ports and tenants)
Source Link Name
OA I 1 T C PIdentifies the port on the source side of the 
communication link; entry should correspond to a link 
name in the APM system configuration file.
Destination Link Name
PBX1TCPIdentifies the port on the destination side of the 
communication link; entry should correspond to a link 
name in the APM system configuration file.
Association Recovery
15Interval, in seconds, UCD-XL Monitor waits before 
attempting to re-establish an OAI association. 
						

							NDA-30078   Revision 1.0Page 35
UCD-XL Installation Guide Configuring UCD-XL
Using the OAI-Conf command on the Application Configuration Entry screen, 
make the entry shown for each of the following parameters required by each 
Messenger component; each Messenger has the same values for its parameters. Use 
the instructions provided for this option in the APM Operations Manual.
Note:Italicized entries may be changed.
User-Defined Parameters
Make the entries shown for each of the following user-defined parameters (UDPs) 
by using the UserDefined command on the APM’s Configuration Entry screen (for 
the Mediator and Administrator components), or on the OAI Configuration screen 
(for the Monitor and Messenger components).
Note:Italicized entries may be changed. The format X(xxxxx) indicates that only the 
first letter is significant.Table 3-5  Messenger Parameters
Parameter Entry Description
Database Name #1 Unused by Messenger.
Database Name #2 Unused by Messenger.
Timeout Value #10Unused by Messenger.
Timeout Value #20Unused by Messenger.
Tenant Number
0Specifies the number of the tenant that UCD-XL 
Messenger serves. (0 means all ports and tenants)
Source Link Name
OA I 1 T C PIdentifies the port on the source side of the 
communication link; entry should correspond to a link 
name in the APM system configuration file.
Destination Link Name
PBX1TCPIdentifies the port on the destination side of the 
communication link; entry should correspond to a link 
name in the APM system configuration file.
Association Recovery0Unused by Messenger. 
						

							Page 36NDA-30078   Revision 1.0
Configuring UCD-XL UCD-XL Installation Guide
Monitor User-
defined 
ParametersMake the following entries on the OAI Configuration screen. Italicized entries can 
be changed.
Table 3-6  Monitor User-defined Parameters
User Defined Entry Definition
#1/oai/db/cur/ucdaniPathname of the ANI Pattern Database. This is required 
only if you desire the distribution of calls based upon 
their ANI data. Otherwise, leave this parameter blank.
#2 (blank) This parameter is no longer being used.
#3A(ll stats)Type of statistics collected. Select one of the following 
entries:
A(ll stats): All call activity, per group and per port.
M(ajor): Call activity per group, including 
incoming call count, abandoned call 
count, queued call count, and average 
and maximum durations of queued 
calls. 
N(one): Do not collect statistics.
#4H(ourly)Statistics collection frequency. Select one of the 
following entries:
H(ourly): Statistics are collected at the top of the 
hour, each hour.
D(aily): Statistics are collected at midnight, 
each day.
If no statistics will be collected, this parameter is 
irrelevant.
#5 /oai/app/data/ucdxl Directory of the statistics file, trace file, and report file.
#6 /oai/app/ucdxl/ucdrptrFilename of the Reporter process, which stores the 
statistics and trace data in the statistics directory.
#720Number of request bins. The Monitor communicates 
with one of more Messengers by means of “request 
bins” in shared memory. The quantity of request bins 
needed is based upon call traffic volumes. Must be 
greater than zero. Suggested values:
20 (1 - 2999 calls/hour)
30 (3000 - 4999 calls/hour)
40 (5000+ calls/hour)
#8125Shared memory key. Can be changed if it conflicts with 
another application.
#9165Semaphore set key. Can be changed if it conflicts with 
another application. 
						

							NDA-30078   Revision 1.0Page 37
UCD-XL Installation Guide Configuring UCD-XL
Messenger User-
defined 
ParametersMake the following entries on the OAI Configuration screen. Italicized entries can 
be changed. #10UCDXL_MediatorName assigned to the Mediator component. Must be as 
given in the Primary Configuration Parameters on page 
32.
#11A(ctual)Source for the mailbox number in a MCI message for a 
direct call to voice mail. Select one of the following 
entries:
A(ctual): The actual line of the call.
P(hysical): The physical extension of the phone.
M(yLine): Same as Physical.
If there are no voice mail groups, this parameter is 
irrelevant.
Table 3-6  Monitor User-defined Parameters
User Defined Entry Definition
Table 3-7  Messenger User-defined Parameters
User Defined Entry Definition
#1UCDXL_MonitorName assigned to the Monitor component. Must be the 
same as in the Primary Configuration Parameters on 
page 32.
#2125Shared memory key. Can be changed if it conflicts with 
another application, but must be the same as in the 
Monitor’s configuration.
#3165Semaphore set key. Can be changed if it conflicts with 
another application, but must be the same as in the 
Monitor’s configuration. 
						

							Page 38NDA-30078   Revision 1.0
Configuring UCD-XL UCD-XL Installation Guide
Mediator User-
defined 
ParametersMake the following entries on the APM Configuration Entry screen. Italicized 
entries can be changed.
Table 3-8  Mediator User-defined Parameters
User Defined Entry Definition
#1UCDXL_MediatorName assigned to the Mediator component. Must be as 
listed in the Primary Configuration Parameters on page 
32.
#2S(tandard)MCI message set to use. Select one of the following 
entries:
S(tandard): Standard MCI (described in ETI-121 
specification).
X(panded): Expanded MCI. See MAT 
Assignments, page 47, for establishing 
MCI in the PBX.
Expanded MCI message set provides the same 
functionality as the standard MCI message set, but the 
call party fields in each message have been expanded 
from 6 to 8 characters to support CCIS.
The VMS must support the desired set.
#3ttyi1e 19200 none 8 2MCI port to the PBX: device name, baud rate, parity, 
data bits, stop bits.
There must be a blank between each field.
Device name: The names for virtual terminals range 
from “tty01” to “tty12”. If you have 
installed a Digiboard for serial 
communications, device names range 
from “ttyi1a” to “ttyi1p”.
Baud rate: Must be one of these values: 1200, 
2400, 4800, 9600, 19200.
Parity: Must be one of these values: none, odd, 
even.
Data bits: Number of data bits per packet. Must 
be either 7 or 8.
Stop bits: Number of stop bits per packet. Must 
be either 1 or 2.