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

Programming Manual Pages
Issue  3  May 1998
9-9
Notes
The library returns information only on the number of nodes you specify. If you 
specify fewer than the actual number of nodes, information is returned on the 
nodes set in the first calls to asai_set_env. It is recommended that you specify 
num_node as 30 or to any configurable parameter. For example:
# define MAXNUMSERV 30
server_type_t    server = {maxnumserv, services};
service_spec_t   services[MAXNUMSERV];
See Also
asai_open() asai_rcv()...

Programming Manual Pages
9-10Issue  3  May 1998 
asai_open (3ASAI)
Name
asai_open — Open a communication path
Synopsis
# include 
#include  
#include  
#include  
long  asai_open(pathname, ndelay_flag)
char  *pathname;
long  ndelay_flag;
Description
This function opens a communication path identified by pathname, a 
null-terminated character string; the default path is /dev/asai/asai. If the 
ndelay_flag is set to O_NDELAY, the operation is asynchronous and the send 
or receive request does not block. If...

Programming Manual Pages
Issue  3  May 1998
9-11
C_INVALID_CLIENT — This error is returned only by MAPD, when a client 
cannot be validated, that is, its IP address is not administered on the MAPD.
C_LINKDOWN — This error is returned by MAPD to notify the application that the 
ASAI has been taken out of service by the administrator.
See Also
asai_close() asai_rcv() asai_send() 

Programming Manual Pages
9-12Issue  3  May 1998 
asai_rcv (3ASAI)
Name
asai_rcv — Receive message via the communication path
Synopsis
#include  
#include  
#include  
typedef union{
        asai_common_t      asai_common;
        abort_info_t       abort_info;
        vq_buf_t           vq_buf;
        vqr_buf_t          vqr_buf;
        vqc_buf_t          vqc_buf;
        en_buf_t           en_buf;
        en_rsp_t           en_rsp;
        evr_buf_t          evr_buf;
        enc_rsp_t...

Programming Manual Pages
Issue  3  May 1998
9-13
        a3pans_info_t      a3pans_info;
        a3pans_nak_t       a3pans_nak;
        a3pdc_info_t       a3pdc_info;
        a3pdc_ack_t        a3pdc_ack;
        a3pdc_nak_t        a3pdc_nak;
        a3pdce_info_t      a3pdce_info;
        a3pssc_info_t      a3pssc_info;
        a3pssc_ack_t       a3pssc_ack;
        a3pssc_nak_t       a3pssc_nak;
        en_scn_t           en_scn;
        en_scn_nak_t       en_scn_nak;
        sv_buf_t...

Programming Manual Pages
9-14Issue  3  May 1998 
NOTE:
If a program ignores this error and simply calls the library again, an infinite 
loop is created. Because of this, all application programs must check for the 
presence of a C_BADLNG error and provide a larger buffer if it occurs.
If the function is used in a synchronous mode of operation, asai_rcv() blocks 
until an entire message has been received, until an error occurs, or until fd is 
closed by an interrupt function. If the function is used in an...

Programming Manual Pages
Issue  3  May 1998
9-15
asai_send (3ASAI)
Name
asai_send — Send message via the communication path
Synopsis
#include  
#include  
#include  
typedef union{
        asai_common_t      asai_common;
        abort_info_t       abort_info;
        vq_buf_t           vq_buf;
        vqr_buf_t          vqr_buf;
        vqc_buf_t          vqc_buf;
        en_buf_t           en_buf;
        en_rsp_t           en_rsp;
        evr_buf_t          evr_buf;
        enc_rsp_t          enc_rsp;...

Programming Manual Pages
9-16Issue  3  May 1998 
        a3pans_info_t      a3pans_info;
        a3pans_nak_t       a3pans_nak;
        a3pdc_info_t       a3pdc_info;
        a3pdc_ack_t        a3pdc_ack;
        a3pdc_nak_t        a3pdc_nak;
        a3pdce_info_t      a3pdce_info;
        a3pssc_info_t      a3pssc_info;
        a3pssc_ack_t       a3pssc_ack;
        a3pssc_nak_t       a3pssc_nak;
        en_scn_t           en_scn;
        en_scn_nak_t       en_scn_nak;
        sv_buf_t...

Programming Manual Pages
Issue  3  May 1998
9-17
attempt to send a message in an inappropriate role will be rejected. 
Notice that an application can be simultaneously both a client and a server. 
See the ‘‘asai_set_env( )’’ on page 4-6 in Chapter 4, ‘‘ASAI Library Functions’’ for 
further information.
Return Value
Upon successful completion, the function returns a nonnegative value. If an error 
occurs, the function returns -1.
Errors
The type of error is indicated by the error value set in asai_errno:...

Programming Manual Pages
9-18Issue  3  May 1998 
asai_set_env (3ASAI)
Name
asai_set_env — Set a specified characteristic for a communication path
Synopsis
#include  
#include  
#include  
typedef union{
        server_type_t  server;
        char  node_id[C_NODSIZ];
}set_type;
long  asai_set_env(fd, characteristic, arg)
int  fd;
long  characteristic;
set_type  *arg;
Description
This function is used to set a specified characteristic of the communication path 
associated with fd. The parameter...