Lucent Technologies DEFINITY Enterprise Communications Server Release 6 CallVisor PC ASAI Instructions Manual

							DEFINITY®
Enterprise Communications Server
Release 6
CallVisor
® PC ASAI
Installation and Reference
555-230-227
Comcode 108111303
Issue 3
May 1998 
						

							NoticeWhile reasonable efforts were made to ensure that the information 
in this document was complete and accurate at the time of printing, 
Lucent Technologies can assume no responsibility for any errors.  
Changes and corrections to the information contained in this 
document may be incorporated into future reissues.
Your Responsibility for Your System’s SecurityYou are responsible for the security of your system. Lucent 
Technologies does not warrant that this product is immune from or 
will prevent unauthorized use of common-carrier telecommunication 
services or facilities accessed through or connected to it. Lucent 
Technologies will not be responsible for any charges that result from 
such unauthorized use. Product administration to prevent 
unauthorized use is your responsibility and your system 
administrator should read all documents provided with this product 
to fully understand the features available that may reduce your risk 
of incurring charges.
Federal Communications Commission Statements
Part 15: Class A Statement.  This equipment has been tested 
and found to comply with the limits for a Class A digital device, 
pursuant to Part 15 of the FCC Rules. These limits are designed to 
provide reasonable protection against harmful interference when the 
equipment is operated in a commercial environment. This 
equipment generates, uses, and can radiate radio-frequency energy 
and, if not installed and used in accordance with the instruction 
manual, may cause harmful interference to radio communications. 
Operation of this equipment in a residential area is likely to cause 
harmful interference, in which case the user will be required to 
correct the interference at his or her own expense.
Part 68: Network Registration Number. This equipment is 
registered with the FCC in accordance with Part 68 of the FCC 
Rules. It is identified by FCC registration number 
AS593M-13283-MF-E.
Part 68: Answer-Supervision Signaling. Allowing this 
equipment to be operated in a manner that does not provide proper 
answer-supervision signaling is in violation of Part 68 rules. This 
equipment returns answer-supervision signals to the 
public-switched network when:
nAnswered by the called stationnAnswered by the attendant
nRouted to a recorded announcement that can be 
administered by the CPE userThis equipment returns answer-supervision signals on all DID calls 
forwarded back to the public-switched telephone network. 
Permissible exceptions are:
nA call is unanswered
nA busy tone is receivednA reorder tone is received
TrademarksCallVisor is a registered trademark of Lucent Technologies.
DEFINITY is a registered trademark of Lucent Technologies in the 
USA and throughout the world.
CentreVu Computer-Telephony is a registered trademark of Lucent 
Technologies
.
SPARC Solaris is a trademark of Sun Microsystems, Inc. in the USA 
and other countries.
Solaris is a trademark of Sun Microsystems, Inc. in the USA and 
other countries.
UNIX is a registered trademark in the USA and other countries, 
licensed exclusively through X/Open Company Limited.
UnixWare is a registered trademark of the Santa Cruz Operation, 
Inc. in the USA and other countries.
Windows is a registered trademark of Microsoft Corporation. 
Windows NT is a trademark of Microsoft Corporation.
Ordering InformationThe ordering number for this document is 555-230-227. To order this 
document, call the BCS Publications Center at 1 800 457-1235 
(international callers use 1 317 322-6791). For more information 
about Lucent Technologies documents, refer to 
Business 
Communications Systems Publications Catalog, 555-000-010.
You can be placed on a Standing Order list for this and other BCS 
documents you may need. Standing Order will enable you to 
automatically receive updated versions of individual documents or 
document sets, billed to account information that you provide. For 
more information on Standing Orders, or to be put on a list to 
receive future issues of this document, please contact the Lucent 
Technologies BCS Center.
To learn more about Lucent Technologies products and to order 
products, contact Lucent Direct, the direct-market organization of 
Lucent Technologies Business Communications Systems. Access 
their web site at www.lucentdirect.com, or call 1 800 451-2100. The 
International fax number is 1 317 322-6699.
Lucent Technologies Fraud InterventionIf you suspect you are being victimized by toll fraud and you need 
technical support or assistance, call the BCS Technical Service 
Center Toll Fraud Intervention Hotline at 1 800 643-2353.
CommentsTo comment on this document, return the comment card at the end 
of the document.
Acknowledgment
This document was prepared by the
Product Documentation Development, 
Lucent Technologies
Middletown, NJ 07748-9972
Copyright © 1998 Lucent Technologies 
All Rights Reserved
Printed in USA 
						

							Contents
Issue  3  May 1998iii
About This Document xxi
nReason for Reissue xxi
nNew features xxii
Single-Step Conference xxii
Universal Call ID xxii
Release 5 Major Enhancements xxii
nIntended Audience xxiv
nOrganization of This Document xxv
nRelated Documents xxvi
nTechnical Service Center xxvi
1 Installation 1-1
nPlatform Consideration 1-1
 Hardware Platforms 1-1
nCV/LAN Product Description 1-11
System Configuration 1-14
Software Configuration 1-14
System Operation and Limits 1-14
Server Installation on UNIX 1-15
Client Installation on UNIX 1-15
Client Installation on Windows NT 1-15
Running the Sample Application 1-16
nDEFINITY ECS Administration 1-17
nConfiguration 1-18
Upgrading Software 1-18
Removing Software 1-18
Configuring and Reconfiguring Software 1-19
Memory Considerations 1-21
Starting Up the System 1-23 
						

							Contents
ivIssue  3  May 1998 
2 OA&M 2-1
nThe ASAI Log File 2-2
nOA&M Manual Pages 2-3
nadmin(7) 2-4
nasai(4) 2-5
nasai(7) 2-6
nasai.Date(4) 2-7
nasai.Name(4) 2-8
nasai_admin(1) 2-9
nasai_cause(1) 2-11
nasai_hb(1) 2-14
nasai_log(4) 2-16
nasai_test(1) 2-17
nasai_trace(1) 2-18
nasai_ver(1) 2-21
nboot.bin(4) 2-22
ncmd(7) 2-23
ncommand(7) 2-24
nesai_alarm(1) 2-25
nesai_trace(1) 2-27
nipci(4) 2-29
nipci_admin(1) 2-30
nipci_off(1) 2-33
nipci_on(1) 2-34
nipci_stat(1) 2-36
nipci_test(1) 2-37
nipci_ver(1) 2-38
nisdn_alarm(1) 2-39
nisdn.Date(4) 2-41
nisdn_11_r(1) 2-42
nisdn_12_r(1) 2-43
nisdn.Name(4) 2-44
nisdn_trace(1) 2-45
nlan_stat(1) 2-48 
						

							Contents
Issue  3  May 1998v
nlink_alarm(1) 2-50
nlink_change(1) 2-51
nlink_offline(1) 2-52
nlink_restart(1) 2-53
nlink_status(1) 2-54
nlog_msgs(4) 2-55
npcisdn.bin(4) 2-56
nsignal(7) 2-57
nCV/LAN Administration 2-58
OA&M changes for client and server 2-58
3 Introduction to ASAI 3-1
nTerms and Concepts 3-3
nImportant Note about Heartbeat 3-4
nThe ASAI Library Functions 3-5
nApplication Service Elements 3-8
nASAI Capabilities 3-11
4 ASAI Library Functions 4-1
nasai_open( ) 4-3
nasai_errval ( ) 4-4
nasai_set_env( ) 4-6
nasai_get_env( ) 4-9
nasai_send( ) 4-10
nasai_rcv( ) 4-12
nasai_close( ) 4-13
nSample Code 4-14 
						

							Contents
viIssue  3  May 1998 
5 ASAI Capabilities 5-1
nEvent Notification 5-2
nEvent Notification Request 5-3
Description 5-3
Request/Indication Parameters 5-3
Notes 5-3
nEvent Notification End 5-4
Description 5-4
Notes 5-4
nEvent Notification Cancel 5-5
Description 5-5
Notes 5-5
nEvent Notification Stop Call Notification 5-6
Description 5-6
Request/Indication Parameter 5-6
Notes 5-6
nEvent Report 5-7
Description 5-7
nThird Party Call Control Capabilities 5-11
nThird Party Answer Call 5-13
Description 5-13
Request/Confirmation Parameters 5-13
Notes 5-13
Interactions with Event Reports 5-13
nThird Party Auto Dial 5-14
Description 5-14
Request/Confirmation Parameters 5-14
Notes 5-15
Related Event Reports 5-15
nThird Party Call Ended 5-16
Description 5-16
Request/Confirmation Parameters 5-16
Notes 5-16
Interactions with Event Reports 5-16 
						

							Contents
Issue  3  May 1998vii
nThird Party Clear Call 5-17
Description 5-17
Notes 5-17
Interactions with Event Reports 5-17
nThird Party Domain Control 5-18
Description 5-18
Request/Confirmation Parameter 5-18
Notes 5-18
Interactions with Event Reports 5-18
nThird Party Domain Control End 5-19
Description 5-19
Notes 5-19
Interactions with Event Reports 5-19
nThird Party Listen-Disconnect 5-20
Description 5-20
Request/Confirmation Parameters 5-20
Notes 5-20
Interactions with Event Reports 5-20
nThird Party Listen-Reconnect 5-21
Description 5-21
Request/Confirmation Parameters 5-21
Notes 5-21
Interactions with Event Reports 5-21
nThird Party Make Call 5-22
Description 5-22
Request/Confirmation Parameters 5-22
Notes 5-23
Interactions with Event Reports 5-24
nThird Party Merge 5-25
Description 5-25
Request/Confirmation Parameters 5-25
Notes 5-25
Interactions with Event Reports 5-26
nThird Party Reconnect 5-27
Description 5-27 
						

							Contents
viiiIssue  3  May 1998 
Request/Confirmation Parameters 5-27
Notes 5-27
Interactions with Event Reports 5-27
nThird Party Redirect Call 5-28
Description 5-28
Request/Confirmation Parameters 5-28
Notes 5-28
Interactions with Event Reports 5-28
nThird Party Relinquish Control 5-29
Description 5-29
Notes 5-29
Interactions with Event Reports 5-29
nThird Party Selective Drop 5-30
Description 5-30
Request/Confirmation Parameters 5-30
Notes 5-30
Interactions with Event Reports 5-31
nThird Party Selective Hold 5-32
Description 5-32
Request/Confirmation Parameters 5-32
Notes 5-32
Interactions with Event Reports 5-32
nThird Party Send DTMF Signals 5-33
Description 5-33
Request/Confirmation Parameters 5-33
nThird Party Single-Step Conference 5-34
Description 5-34
Request/Confirmation Parameters 5-34
Notes 5-34
nThird Party Take Control 5-35
Description 5-35
Request/Confirmation Parameters 5-35
Notes 5-35
Interactions with Event Reports 5-35
Notes 5-35 
						

							Contents
Issue  3  May 1998ix
nSet Value Capabilities 5-36
Description 5-36
Request/Indication Parameters 5-36
nValue Query Capabilities 5-37
nValue Query 5-38
Description 5-38
Request Parameters 5-38
Notes 5-39
nValue Query Response 5-40
Description 5-40
Request Parameter 5-40
Notes 5-40
nRequest Feature Capabilities 5-41
Description 5-41
Request/Indication Parameters 5-41
Notes 5-42
nAdjunct Routing Capabilities 5-43
nRouting 5-44
Description 5-44
Request/Indication Parameters 5-45
Notes 5-45
nRoute Select 5-46
Description 5-46
Request/Indication Parameters 5-46
Notes 5-47
nRoute End 5-48
Description 5-48
Notes 5-48
nMaintenance Capabilities 5-49
nHeartbeat 5-50
Description 5-50
Request/Indication Parameters 5-50
Notes 5-50
nAbort Capabilities 5-51
Description 5-51 
						

							Contents
xIssue  3  May 1998 
Request/Indication Parameters 5-51
Notes 5-51
6 CV/LAN Programming 6-1
nIntroduction to CV/LAN 6-1
nApplications Development Environment 6-1
UNIX Platforms 6-1
Windows NT Platform 6-2
Future Upgrade Considerations 6-3
 Client API 6-3
nasai_open 6-5
Description 6-5
nasai_errval 6-6
nasai_set_env() 6-6
nasai_get_env() 6-7
Description 6-7
nasai_send() 6-8
Description 6-8
nasai_rcv() 6-9
 Description 6-9
nasai_close() 6-10
Description 6-10
7 Error Messages 7-1
nLibrary Error Messages 7-1
8 ASAI Capability Primitives 8-1
nasai_common 8-3
nIdentifiers 8-5