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

ASAI Capabilities
Issue  3  May 1998
5-51
Abort Capabilities
The ASAI library includes an Abort capability that is part of every capability group. 
The Abort capability provides two types of Aborts:
nU_ABORT — A client-initiated abort 
nP_ABORT — A library-initiated abort
Description
The Abort capability allows the client to inform the peer entity (client or server) that 
processing for the ASE is terminating. The 
Cause parameter indicates the reason 
for terminating.
The client invokes the Abort...

ASAI Capabilities
5-52Issue  3  May 1998  

Issue  3  May 19986-1
6
CV/LAN Programming
Introduction to CV/LAN  
CV/LAN allows application software running on UnixWare, Solaris x86, SPARC 
Solaris, or Window NT 4.0 to access the DEFINITY ECS CallVisor ASAI features 
across a TCP/IP LAN in a client-server arrangement. The server runs on the 
CallVisor PC or the Multi-Application Platform for DEFINITY (MAPD). CallVisor 
PC and CV/LAN client applications use the same library and differ slightly in only 
one API call. For further information see...

CV/LAN Programming
6-2Issue  3  May 1998 
Windows NT Platform
In Windows NT, the multithread or debug multithread run time libraries must be 
specified in the “code generation” category of the “C/C++” tab. The sockets library, 
wsock32.lib should be included in the list of libraries in the “Link” tab. In addition, 
the WIN_NTS, CVPC, and ASAIDLL (Dynamic-Link Library) must be included in 
the settings.
For Windows NT, a Dynamic-Link Library (DLL) called asaidll.dll along with 
its import library...

CV/LAN Programming
Issue  3  May 1998
6-3
Future Upgrade Considerations 
Motivation for New CV/LAN Server
In this release, the interface to CV/LAN was changed to increase the likelihood 
that your application will continue to run with new releases of the ECS to work in a 
multi-threaded environment, and to improve the throughput by a factor of 2 to 10.
Previously, the applications did not work. From this release forward, the following 
rules will apply:
1. If you have new client, new ECS with an old...

CV/LAN Programming
6-4Issue  3  May 1998 
          asai_rcv()
          asai_errval()
These are the same routines that are available to all the ASAI applications on the 
server.
The above table describes each function and shows how it works. The functions 
are presented in a logical, rather than in an alphabetical, order. Thus,
asai_open() comes first and asai_close() comes last as indicated in the 
above table.
It is possible to process messages from more than one node as long as all the 
nodes are on...

CV/LAN Programming
Issue  3  May 1998
6-5
asai_open
Description
The asai_open() is the first library function that your application calls. This 
function opens a communication path (socket) to the CV/LAN server.
Prototype
int asai_open ( const char *path, int flags )
Arguments
Path represents a pointer to the hostname or IP address of the machine running 
the CV/LAN server. flags may be set to 0 or O_NDELAY.
Return Value
On successful completion, the message Socket file descriptor is 
displayed. If an...

CV/LAN Programming
6-6Issue  3  May 1998 
asai_errval
The asai_errval is the standard ASAI library function. See ‘‘asai_errval ( )’’ on 
page 4-4 in Chapter 4, and ‘‘asai_errval (3ASAI)’’ on page 9-6 in Chapter 9, 
‘‘Programming Manual Pages.’’  For error messages, see Chapter 7, ‘‘Error 
Messages.’’
asai_set_env()
The asai_set_env function is also a standard ASAI library function. See
‘‘asai_set_env( )’’ on page 4-6, in Chapter 4 and ‘‘asai_set_env (3ASAI)’’ on page 
9-18 in Chapter 9, ‘‘Programming...

CV/LAN Programming
Issue  3  May 1998
6-7
asai_get_env()
Description 
The asai_get_env() function allows you to check the version of the ASAI 
library.
C_LIB_VER
The version number of the ASAI library includes three values: major, minor, and 
delta. A change to a major value indicates significant functional changes to the 
ASAI library, for example, addition of new capabilities. A change to a minor value 
indicates changes made to existing capabilities. A delta change indicates a 
correction with no...

CV/LAN Programming
6-8Issue  3  May 1998 
Example
if ( asai_get_env( socketfd, attr, &envbuf) < 0 )                
 {                         
asai_errval(asai_get_env failed);                         
exit(-asai_errno);                
 }                
 . 
 . 
                    .
For further information see ‘‘asai_get_env( )’’ on page 4-9 in Chapter 4 and 
‘‘asai_get_env (3ASAI)’’ on page 9-7 in Chapter 9, ‘‘Programming Manual 
Pages.’’
asai_send()
Description
asai_send() and asai_rcv() together...