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

Programming Manual Pages
Issue  3  May 1998
9-69
call_id
call_id is ECS-assigned identifier of the call to be dropped. call_id is used 
only when the association is initiated by the C_3PDC_REQ capability.
NOTE:
party_id and call_id are not ASCII null-terminated strings but rather an 
array of binary bytes of the specified length. See ‘‘Identifiers’’ on page 8-5 in 
Chapter 8, ‘‘ASAI Capability Primitives’’ for more information.
uudata
The purpose of the user-user information is to convey information...

Programming Manual Pages
9-70Issue  3  May 1998 
Return Value
When this capability is used in an asai_send(), the function returns a 
nonnegative value when successful and -1 on failure. A return value of 0 does not 
indicate an error, it merely indicates that no data has been sent.
Errors
See Chapter 7, ‘‘Error Messages’’ for a list of error messages with brief 
explanations of their probable causes.
Notes
This capability can be issued only by a client.
See Also
asai_send()
C_EN_REP C_3PMC_REQ...

Programming Manual Pages
Issue  3  May 1998
9-71
C_3PSD_CONF (3ASAI)
Name
C_3PSD_CONF — Acknowledge a third party selective drop request
Ty p e
Continuing — Unacknowledged
Usage
typedef struct{
        asai_common_t        asai_common;
        long                 cause_value;
}a3psd_rsp_t;
Description
The client receives this capability as a positive or negative acknowledgement of a 
C_3PSD request.
asai_common
Within this structure, capability is returned as C_3PSD_CONF; 
primitive_type is returned as...

Programming Manual Pages
9-72Issue  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, but 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_EN_REP C_3PMC_REQ C_3PMC_CONF C_3PTC_REQ C_3PTC_CONF C_3PSH 
C_3PSH_CONF C_3PR C_3PR_CONF...

Programming Manual Pages
Issue  3  May 1998
9-73
C_3PSDS (3ASAI)
Name
C_3PSDS — Send DTMF Signals on behalf of a party on a call
Ty p e
Continuing — Acknowledged
Usage
typedef struct{
   asai_common_t   asai_common;
   call_id_t       call_id;
   party_id_t      tx_party_id;
   party_id_t      tx_party_ids[5]; 
   user_code_t     user_data;
   long            tone_duration;
   long            pause_duration;
   char            pool [C_DATSZ];
} a3psds_info_t;
Description
The client sends this capability...

Programming Manual Pages
9-74Issue  3  May 1998 
call_id
call_id is ECS-assigned identifier of the active call on which the DTMF signals 
will be applied. call_id is used only when the association is initiated by the 
C_3PDC_REQ capability.
user_data
The user_data structure is used to convey the information about the DTMF 
digits to ECS.
The leng field is an integer value that indicates the number of octets (digits) of 
user data included in the request.
The type field indicates the type of information...

Programming Manual Pages
Issue  3  May 1998
9-75
See Also
asai_send()
C_EN_REP C_3PMC_REQ C_3PMC_CONF C_3PTC_REQ C_3PTC_CONF C_3PSH
C_3PSH_CONF C_3PR C_3PR_CONF C_3PM C_3PM_CONF C_3PSD_CONF 
C_3PCC C_3PCC_CONF C_3PCE C_3PRC C_3PRC_CONF 

Programming Manual Pages
9-76Issue  3  May 1998 
C_3PSDS_CONF (3ASAI)
Name
C_3PSDS_CONF — Acknowledge a send DTMF request
Ty p e
Continuing — Unacknowledged
Usage
typedef struct{
        asai_common_t        asai_common;
        long                 cause_value;
}a3psds_rsp_t;
Description
The client receives this capability as a positive or negative acknowledgement of a 
C_3PSDS request.
asai_common
Within this structure, capability is returned as C_3PSDS_CONF, and 
primitive_type is returned as...

Programming Manual Pages
Issue  3  May 1998
9-77
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_EN_REP C_3PMC_REQ C_3PMC_CONF C_3PTC_REQ C_3PTC_CONF C_3PSH
C_3PSH_CONF...

Programming Manual Pages
9-78Issue  3  May 1998 
C_3PSH (3ASAI)
Name
C_3PSH — Place selected party on hold
Ty p e
Continuing — Acknowledged
Usage
typedef struct{
        asai_common_t       asai_common;
        party_id_t          party_id;
        call_id_t           call_id;
        char                pool[C_DATSZ];
}a3psh_info_t;
Description
The client sends this capability to request that a party be placed on hold. The 
party must be on a call controlled by the client. A structure of type...