Lucent Technologies CentreVu Call Management System Release 3 Version 8 External Call History Interface Manual

							   CentreVu® CMS R3V8 External Call History Interface
Setup Information35
Be sure to set the
 location and user_name (and keep 
them populated) so that any problems can be traced to the 
correct port
. 
You can break down either of these commands to make the 
entry easier. For example, for the direct connection, you could 
perform the following steps.
1. Type set port=x mode slave speed .
2. Press .
3. Type set port=x type hardwired 
location
 .
4. Press .
5. Continue until the entire command is entered.
NOTE:
 Parameter Recommended Setting
mode slave
dedicated_address Set to the ip address of the 
Sun 
host.
You can find this by searching (use 
“grep”) the file 
/etc/host.
control_lines Set to modem_control.
speed Set to match the speed of the receiving 
computer (19200 or 38400 bps). 
type dial_in
term_var dial_up
broadcast_direction network
location 
user_name 
NOTE:
RETURN
RETURN 
						

							   CentreVu® CMS R3V8 External Call History Interface
Setup Information36
4. When you are finished, use the following command to reset the 
ports:
The system responds as follows:
5. To quit 
na, enter the following command:
The following procedure requires the 
CentreVu CMS computer to be 
rebooted. 
CentreVu CMS will be down while the system is 
rebooting, and you will lose 
CentreVu CMS data.
Next you must create a character special device; do so in the 
following manner:
a. At the console terminal, go to the
 /etc/rc2.d directory.
b. Look for a 
Speripherals file. If this file does not exist,
create a 
Speripherals file by using an editor such as vi. 
command: reset [port number]
 resetting serial port  of annex 
 command: quit
!CAUTION:
 # vi Speripherals 
						

							   CentreVu® CMS R3V8 External Call History Interface
Setup Information37
c. Add the following system command to the file. You must add 
one line per each modem or direct connection. (If the 
Speripherals file already exists, just add the command to it.)
The 220 in the device name indicates the second NTS and port 
20 (as does the parameter 20). You can choose your own 
names, but the device name should reflect the terminal server 
and port names.
d. If you used vi to do the above editing, you can exit vi by typing 
ZZ (upper case).
6. Reboot the 
CentreVu CMS computer.
Connecting the 
CentreVu CMS 
Computer to the 
Receiving 
Computer
0
The port on the CentreVu CMS computer is set up for outgoing data only 
during feature installation. The port on the receiving computer must be 
set up for incoming data only
.
The receiving computer must be connected to the CentreVu CMS 
computer by an RS-232 connection. This connection uses hardware flow 
control and runs at 19200 bps or 38400 bps.
Cabling0The computers can be connected up to a distance of 50 feet with RS-232 
cabling and connectors. If the two computers cannot be located within 50 
feet of each other, limited-distance modems can be used. Contact your 
account representative for information about modems.
If you are using a small NTS (8 or 16 ports), you need either a 10-pin or 
8-pin straight-through connector cable. One end of the cable goes to a 
port on the small NTS, and the other end of the cable goes to the 
connector. The connector must then attach to a null modem. 
 rtelnet -fmrt  20 /dev/s_pdev220
NOTE:
NOTE: 
						

							   CentreVu® CMS R3V8 External Call History Interface
Setup Information38
Selecting and 
Setting Up the 
Receiving 
Computer
0
This section contains the receiving computer requirements. This section 
also explains how call records are transferred.
Consider the following points before purchasing or connecting the 
receiving computer:
lProcessor speed should be as high as practically possible.
lThe computer must have file transfer capabilities (the default is 
uucp, but you may choose another file transfer utility). If your 
receiving computer is a 
UNIX machine, refer to your UNIX 
documentation to set up uucp. If your receiving computer is a 
Windows* computer, see the section “Setting Up uucp Software on a 
Windows Computer” in this document.
lIf you are also using CentreVu Explorer, you must use uucp as the 
file transfer utility. Select the default settings when installing ECHI.
lThe computer must be loaded with software in order to accept, 
store, and convert the transferred data.
lTransfer speed must be set to the same speed you choose to use 
on the 
CentreVu CMS computer (19200 or 38400 bps).
lCertain files (such as System and Devices) and permissions must 
be set up on the receiving computer. See the documentation that 
came with the computer for this information.
lStorage capacity should be large enough to meet your needs 
(based on expected call traffic and the length of time you want to 
store the data). A minimum of 20 MB of available space is required.
If the disk on the receiving computer fills up, a message is sent to 
the 
CentreVu CMS computer and file transfer halts. This condition 
could cause files to back up in the 
CentreVu CMS computer buffers. 
If files back up, the call record data that has already been collected 
up to that moment will eventually be transferred to the receiving 
computer, but no new data will be collected. (Standard 
CentreVu 
CMS data is not affected.)
*Windows is a registered trademark of Microsoft, Inc.
!CAUTION: 
						

							   CentreVu® CMS R3V8 External Call History Interface
Setup Information39
The capacity needed to store one record in the database is 233 
bytes per record. One call record is generated for each call 
segment
.
Multiply 233 by the number of records you want to store (based on 
estimated call traffic and the length of time you want to store the 
data) to calculate approximately how much storage capacity you 
need.
Transferred File 
Names
0
The transfer process adds an extension of up to three digits to the call 
history data file name. Therefore, the file name on the receiving computer 
is 
chrxxxx.x, chrxxxx.xx, or chrxxxx.xxx.
Call Record Transfer0The transferred call history files are placed in the ~/ directory. (The ~/ 
directory is the default uucp directory that you can administer on the 
receiving computer.)
The call history files are sent from 
CentreVu CMS at the end of each 
interval 
or when a file reaches 20 MB in size. You must set up your 
receiving application to continuously check the 
~/ directory for files of 
the
chrxxxx format, and then copy these files to your database. The 
original files in 
~/ should then be deleted. If files are not deleted from the 
~/ directory after being copied to your database, they will eventually be 
overwritten.
If the disk on the receiving computer fills up, a message is sent to the 
CentreVu CMS computer and file transfer halts. This condition could 
cause files to back up in the 
CentreVu CMS computer buffers. If files 
back up, the call record data that has already been collected up to that 
moment will eventually be transferred to the receiving computer, but no 
new data will be collected. (Standard 
CentreVu CMS data is not 
affected.)
The purpose of the sequence numbers is to be able to detect duplicate 
files. If you receive two files with the same sequence number, those files 
are duplicates. If duplicated files are received, refer to the sequence 
number as previously described in the File Header section. 
!CAUTION: 
						

							   CentreVu® CMS R3V8 External Call History Interface
Setup Information40
Setting Up uucp 
Software on a
Windows 
Computer
0
You must provide the uucp software for the receiving computer. During 
setup, the site names (which may be identified by other terms such as 
node names or host names) must match for configuration on both 
machines. For assistance, call the Lucent Technologies National 
Customer Care Center at 1-800-242-2121. International customers may 
contact your local Lucent distributor or representative.
The following steps briefly describe a typical method of setting up uucp 
software on a 
Windows* computer. Specific details will vary from machine 
to machine. Refer to your uucp software documentation for more 
information. If the receiving computer is a 
UNIX machine, refer to your 
UNIX documentation.
1. Install the uucp software on the receiving computer by following the 
installation instructions for the software.
2. Configure the uucp software by following the configuration 
instructions for the software. 
3. Reboot the computer to verify that no configuration or startup 
procedures conflict.
4. Define the site name for the receiving computer. This must match 
the name that was entered on the 
CentreVu CMS computer for the 
call history receiving machine during installation of the feature.
5. Define the 
Spool directory as C:\uucp.
6. Define the 
Public directory as C:\uucp\public.
7. Define the
 UUXQT path as C:\bin.
8. Define the default drive as C:\.
9. Define the receiving port as COM1.
10. Define the name of the 
CentreVu CMS computer that will be sending 
data. This needs to be the same as the node name of the 
CentreVuCMS computer. Type uname -n, and press   on 
the 
CentreVuCMS at the UNIX prompt and run the name.
For the following step, the login ID is 
nuucp. The password is that 
which was created during the feature installation.
*Windows is a registered trademark of Microsoft, Inc.NOTE:
Return
NOTE: 
						

							   CentreVu® CMS R3V8 External Call History Interface
Setup Information41
11. Define the nuucp password that will be used by 
CentreVu CMS to 
log in to the receiving computer and send data. This password must 
match the nuucp password assigned during the External Call 
History Interface feature installation.
The software is now set up. Use the following section to test the setup.
Testing the 
Connection and 
Configuration
0
Test the connection and configuration by performing the following 
procedure.
1. Send e-mail from the receiving computer to the 
CentreVu CMS 
computer.
a. Type mail [cms computer name]!cms, and press 
.
b. Type any text. For example, This is a test from call 
history receiver to cms, and press 
.
c. Type a period (.), and press  .
2. Send e-mail from the 
CentreVu CMS computer to the receiving 
computer.
a. Type mail [receiving computer name]!user1, and 
press .
b. Type any text. For example, This is a test from CMS 
to call history receiver, and press 
.
c. Type a period (.), and press  .
If both machines receive the mail, the connection is configured and 
operating properly.
The 
UNIX command uutry  will test the machine 
and provide a log of actions for tracing problems.
Reading Mail on 
UNIX Computers0
To read mail on UNIX computers, perform the following steps.
1. Type mail and press  . to display the message.
2. Type?d and press  . to delete the message.
3. Type?q and press  . to quit reading mail.
Return
Return
Return
Return
Return
Return
NOTE:
Return
Return
Return 
						

							   CentreVu® CMS R3V8 External Call History Interface
Setup Information42 
						

							How Are We Doing?
Document Title:CentreVu™Call Management System Release 3 Version 8
External Call History Interface
Document No.: 585-210-912 Issue 1 Date: December 1999
Lucent Technologies welcomes your feedback on this document. Your comments are  of great 
value in helping us to improve our documentation.
1. Please rate the effectiveness of this document in the following areas:
2. Please check the ways you feel we could improve this document:
r
 Improve the overview/introductionr Make it more concise/brief
r Improve the table of contentsr Add more step-by-step procedures/tutorials
r Improve the organizationr Add more troubleshooting information
r Include more figuresr Make it less technical
r Add more examplesr Add more/better quick reference aids
r Add more detailr Improve the index
Please provide details for the suggested improvement. __________________________________
____________________________________________________________________________
3. What did you like most about this document?
____________________________________________________________________________
____________________________________________________________________________
4. Feel free to write any comments below or on an attached sheet.
____________________________________________________________________________
____________________________________________________________________________
____________________________________________________________________________
____________________________________________________________________________
If we may contact you concerning your comments, please complete the following:
Name: _______________________________ Telephone Number: (_____)__________________
Company/Organization: _____________________________ Date: ________________________
When you have completed this form, please fold, tape, and return to address on back or you can 
fax the form to: 303-538-2195.Excellent Good Fair Poor Not Applicable
Ease of Use ///////////////////////
Clarity ///////////////////////
Completeness ///////////////////////
Accuracy ///////////////////////
Organization ///////////////////////
Appearance ///////////////////////
Examples ///////////////////////
Illustration
Overall Satisfaction ///////////////////////