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

Programming Manual Pages
Issue  3  May 1998
9-19
If no service requests have been sent by ECS or if the application has not used 
asai_set_env to register for handling them, then no service requests are 
passed to the application. Use of arg as a null pointer clears any previously set 
characteristic server value.
arg, defined below, is a pointer to a structure of type server_type_t and 
supplies the server information.
typedef struct{
        long  num_node;
        service_spec_t  *buf;...

Programming Manual Pages
9-20Issue  3  May 1998 
C_SYSER — ASAI service error
C_INTR — A system call was interrupted by a signal
C_ACTIVE — Stream has active cluster instance
C_LINKDOWN — ASAI link on MAPD taken out of service by the administrator
See Also
asai_open() asai_rcv() asai_send() asai_set_env() 

Programming Manual Pages
Issue  3  May 1998
9-21
ASAI Capability Manual pages 
In these manual pages, each capability is described by some or all of the following 
sections:
Name
This section names and succinctly describes the capability.
Ty p e
This section gives the capability type. Based on its use within an association, 
each capability can be classified as initiating, continuing or terminating. These 
classifications reflect the transition of the association through the states of idle, 
active and...

Programming Manual Pages
9-22Issue  3  May 1998 
Usage
This section shows the associated data structures used with the capability.
Description
This section describes the capability, including its associated parameters.
Return Value
This section gives the values returned by asai_send or asai_rcv when the 
capability is used in those functions.
Errors
See Chapter 7, ‘‘Error Messages’’ for a list of error messages with brief 
explanations of their probable causes.
Notes
This section is used to describe any...

Programming Manual Pages
Issue  3  May 1998
9-23
C_3PAD (3ASAI)
Name
C_3PAD — Establish an auto-dial
Ty p e
Continuing — Acknowledged 
Usage
typedef struct{
        asai_common_t       asai_common;
        char                *called_num;
        user_user_t         uudata; 
        long                ofacility;
        char                *ofac_ext;
        long                prio_call;
        long                ack_flag;
        char                pool[C_DATSZ];
}a3pad_info_t;
Description
The...

Programming Manual Pages
9-24Issue  3  May 1998 
uudata
The purpose of the user_user information is to convey information between 
ISDN users. This information is not interpreted by ECS, but rather is carried 
transparently and delivered to the remote user. If the info field is IA5 characters 
(ASCII), the string is null-terminated.
The leng field is an integer value that indicates the number of octets of user data 
included in the request. This field is set to 0 if no user_user data is present....

Programming Manual Pages
Issue  3  May 1998
9-25
This problem will be experienced in the following situation:
A station is monitored using the Third Party Domain Control capability. A 
Third Party Auto Dial capability is sent to the ECS to make a call from the 
monitored station to another party. The ack_flag parameter is set to 
C_ACK_OFF in the Third Party Auto Dial request to indicate that an 
acknowledgment to the C_3PAD is NOT expected from the ECS. If the 
adjunct issues a Third Party Clear Call...

Programming Manual Pages
9-26Issue  3  May 1998 
C_3PAD_CONF (3ASAI)
Name
C_3PAD_CONF — Acknowledge an auto-dial request
Ty p e
Continuing — Unacknowledged
Usage
  typedef struct{
        asai_common_t      asai_common;
        call_id_t          call_id;
        party_id_t         party_id;
           ucid_t             ucid;         /* G3V6 */
        char               pool[C_DATSZ];
}a3pad_ack_t;
typedef struct{
        asai_common_t      asai_common;
        long               cause_value;...

Programming Manual Pages
Issue  3  May 1998
9-27
ucid
This parameter identifies the UCID (Universal Call ID) assigned by ECS.
cause_value
This parameter can be any of the following:
C_INVALID_CRV
C_USER_BUSY
C_NOUSE_RESP
C_OUT_OF_SERV
C_NETCONJ
C_INVLDIE
C_PROTERR
C_RESUNAVL
See Table 8-1 on page 8-12 in Chapter 8 for further information on cause values.
pool
The pool parameter is a character array that provides buffer space for the ASAI 
library to store program-specific information. See ‘‘Pool’’ on...

Programming Manual Pages
9-28Issue  3  May 1998 
C_3PANS (3ASAI)
Name
C_3PANS — Answer a call
Ty p e
Continuing — Acknowledged 
Usage
typedef struct{
        asai_common_t   asai_common;
        call_id_t       call_id;
        char            pool[C_DATSZ];
}a3pans_info_t;
Description
This capability allows the adjunct to request, on behalf of a station user, to 
“answer” a ringing, bridged or held call that is present at the station.   
Answering a ringing, bridged or held call means to connect a call...