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

Programming Manual Pages
Issue  3  May 1998
9-89
Return Value 
When this capability is used in an asai_rcv(), the function returns the size of 
the message when successful and -1 on failure. A return value of 0 does not 
indicate an error, it merely indicates that no data has been received.
Errors
See Chapter 7, ‘‘Error Messages’’ for a list of error messages with brief 
explanations of their probable causes.
See Also 
asai_rcv()
C_3PSL_DISC C_3PSL_RECONN C_3PSL_RECONN_ACK C_EN_REP 
C_3PMC_REQ...

Programming Manual Pages
9-90Issue  3  May 1998 
C_3PSSC_REQ (3ASAI)     
Name
 C_3PSSC_REQ — Single-Step Conference — adds a station to an existing call
Ty p e
Continuing — Acknowledged
Usage
typedef struct {
asai_common_t  asai_common;
char           *station_ext;
call_id_t      call_id;
long           alt_dst;
long           visibility;
char           pool [C_DATSZ];
} a3pssc_info_t;
Description
The client sends this capability to request that a station be conferenced into an 
existing call. A...

Programming Manual Pages
Issue  3  May 1998
9-91
alt_dest
For this capability, the value C_ALERT_OFF will always be used by the ECS in 
G3V6 release. C_ALERT_OFF corresponds to “add station without alerting” 
(0x80). 
visibility
The visibility parameter can assume either the value C_VISIBLE_ON to 
indicate that the added party should be fully visible to the other parties on the call, 
or C_VISIBLE_OFF to indicate that the added party should not be visible to the 
other parties on the call.
pool
The pool...

Programming Manual Pages
9-92Issue  3  May 1998 
C_3PSSC_CONF (3ASAI)
Name
 C_3PSSC_CONF— Acknowledge a third party Single-Step Conference 
Ty p e
Continuing — Unacknowledged
Usage
typedef struct{
party_id_t           party_id;
char                 *extension;
      plan_type_t          ext_type;
} ssconf_ext_t;
typedef struct{
asai_common_t        asai_common;
call_id_t            call_id;
long                 num_conf_ext;
ssconf_ext_t         *party_list;
ucid_t               ucid;            /* new...

Programming Manual Pages
Issue  3  May 1998
9-93
call_id
Within a3pssc_ack_t, call_id specifies the ECS-assigned call identifier of the 
call.
num_conf_ext
This parameter specifies the number of parties connected to the call.
party_list
This parameter, party_list is a pointer to a structure of type conf_ext_t. Each 
element of this list, up to and including the element identified by num_conf_ext 
contains information about the parties connected to the call. In each of these 
party_id structures, id_ptr...

Programming Manual Pages
9-94Issue  3  May 1998 
Return Value 
When this capability is used in an asai_rcv(), the function returns the size of 
the message when successful and -1 on failure. A return value of 0 does not 
indicate an error, it merely indicates that no data has been received.
Errors
See Chapter 7, ‘‘Error Messages’’ for a list of error messages with brief 
explanations of their probable causes.
See Also 
asai_rcv()
C_3PSL_DISC C_3PSL_RECONN C_3PSL_RECONN_ACK C_EN_REP 
C_3PMC_REQ...

Programming Manual Pages
Issue  3  May 1998
9-95
C_3PTC_CONF (3ASAI)
Name
C_3PTC_CONF — Acknowledge a third party take control request
Ty p e
Continuing — Unacknowledged, when received as a positive acknowledgement
Terminating — Unacknowledged, when received as a negative acknowledgement
Usage
typedef struct{
        asai_common_t       asai_common;
        long                num_party_ext;
        party_ext_t        *party_ext_list;
        ucid_t              ucid;            /*G3V6 */
        char...

Programming Manual Pages
9-96Issue  3  May 1998 
indicates the extension of the party. See ‘‘Identifiers’’ on page 8-5 in Chapter 8, 
‘‘ASAI Capability Primitives’’ for a description of party_id.
ucid
During a positive acknowledgment, a structure of type a3ptc_ack_t contains 
information regarding the UCID (Universal Call ID) assigned by ECS. 
pool
The pool parameter is a character array that provides buffer space for the ASAI 
library to store program-specific information. See ‘‘Pool’’ on page 8-15 in...

Programming Manual Pages
Issue  3  May 1998
9-97
C_3PTC_REQ (3ASAI)
Name
C_3PTC_REQ — Take control of an existing third party call
Ty p e
Initiating — Acknowledged
Usage
typedef struct{
        asai_common_t       asai_common;
        call_id_t           call_id;
        char                pool[C_DATSZ];
}a3ptc_info_t;
Description
The client sends this capability to request control of an existing call. The 
a3ptc_info_t structure contains the parameters needed to fulfill the request.
asai_common
The...

Programming Manual Pages
9-98Issue  3  May 1998 
Errors
See Chapter 7, ‘‘Error Messages’’ for a list of error messages with brief 
explanations of their probable causes.
See Also
asai_send()
C_EN_REP C_3PMC_REQ C_3PMC_CONF C_3PTC_CONF C_3PSH
C_3PSH_CONF C_3PR C_3PR_CONF C_3PM C_3PM_CONF C_3PSD
C_3PSD_CONF C_3PCC C_3PCC_CONF C_3PCE C_3PRC C_3PRC_CONF