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

Programming Manual Pages
Issue  3  May 1998
9-159
asai_common
Within this structure, the programmer sets the capability to C_SV_REQ and 
the primitive_type is set to C_REQUEST.The programmer also sets the
sao_id (also known as cluster_id).
The parameter sv_item defines the domain of the items to be set. This 
parameter can be C_SV_MWI (message waiting indicator) or C_SV_FLEX (flexible 
billing).
sv_mwi_val
When sv_item is set to C_SV_MWI, the sv_mwi_val union member indicates 
the specific item...

Programming Manual Pages
9-160Issue  3  May 1998 
Errors
A C_SV_MWI request will return C_BADPMATCH if the called_num parameter is 
not set. A C_SV_FLEX request will return C_BADVALUE if the bill_rate 
parameter is greater than 999.99 or a precision higher than the hundredths is 
specified (for example, 127.312). See Chapter 7, ‘‘Error Messages’’ for a list of 
error messages with brief explanations of their probable causes.
See Also
asai_send()
C_SV_CONF 

Programming Manual Pages
Issue  3  May 1998
9-161
C_VQ_CONF (3ASAI)
Name
C_VQ_CONF — Acknowledge and terminate a value query request
Ty p e
Terminating — Unacknowledged
Usage
typedef struct{
        asai_common_t        asai_common;
        long                 vqc_type;
        long                 cause_value;
}vqc_cause_t;
typedef struct{
        asai_common_t        asai_common;
        long                 vqc_type;
        long                 num_login;
        long                 num_avail;...

Programming Manual Pages
9-162Issue  3  May 1998 
}vqc_time_t;
typedef struct{
        asai_common_t        asai_common;
        long                 vqc_type;
        long                 talk_state;
        long                 work_mode;
        long                 reason_code;
}vqc_agt_stat_t;
typedef struct{
        asai_common_t        asai_common;
        long                 vqc_type;
        long                 ext_status;
}vqc_station_t;
typedef struct{
        asai_common_t...

Programming Manual Pages
Issue  3  May 1998
9-163
        long                 vqc_type;
        long                 sac_status;
}vqc_sac_stat_t;
typedef struct{
        asai_common_t        asai_common;
        long                 vqc_type;
        long                 scf_status;
        char                 *redirection;
        plan_type_t          redir_type; 
        char                 pool[C_DATSZ];
}vqc_scf_stat_t;
typedef struct{
        asai_common_t        asai_common;
        long...

Programming Manual Pages
9-164Issue  3  May 1998 
        vqc_ucid_t           vqc_ucid;      /* UCID 63V6 */
}vqc_buf_t;
Description
The client receives this capability as a positive or negative acknowledgement that 
terminates a value query request. The information needed to service the request 
is contained in the members of the union vqc_buf.
The data common to all termination requests is contained in vqc_common. Within 
asai_common, the capability is returned as C_VQ_CONF and the 
primitive_type as...

Programming Manual Pages
Issue  3  May 1998
9-165
Table 9-4. Associated Items and Descriptions for C_VQ_CONF
Item Typevqc_buf Member Item and Description
C_ACDSPT_STAT vqc_splitnum_login is an integer value indicating the 
number of agents logged in (
C_NUSE_LONG if not 
provided).
num_avail is an integer value indicating the 
number of agents available.
num_callinque is an integer value indicating the 
number of calls in the queue (
C_NUSE_LONG if not 
provided).
C_CLASS_STAT  vqc_cc_statnum_avail is an...

Programming Manual Pages
9-166Issue  3  May 1998 
C_AAID
vqc_aaidItem and Description domain_type is 
an integer value indicating the type of the entity 
queried, (for example, Station, VDN, etc.).
extension is a pointer to a null-terminated string 
indicating the name associated with the extension 
number supplied in the request.
name is a point to a null-terminated string indicating 
the name associated with the extension in the 
Integrated Directory Database. This name will be from 
1 to 27 ASCII...

Programming Manual Pages
Issue  3  May 1998
9-167
C_PTY_STAT vqc_pty_stat party_list is a pointer to a list of structures 
associated with the same call identifier. Each structure 
contains the extension number and its associated 
structure, 
party_id_t. party_id_t contains 
the parameter id_ptr that points to a character 
array specifying ECS-assigned party identifier values. 
The length of each party identifier is given by 
id_length. When no party identifiers are returned 
for this capability,...

Programming Manual Pages
9-168Issue  3  May 1998 
cause_value
This parameter can be any of the following:
   C_FACUNSUB
   C_INVLDIE
   C_INVLDNUM
   C_MAND_INFO
   C_NOLOGIN
   C_NOSPLIT_MEM
   C_PROTERR
   C_RESUNAVL
   C_SER_UNIMP
   C_SERV_UNAVIL
See Table 8-1 on page 8-12 for further information on cause values.
Return Value
When this capability is used in an asai_rcv(), the function returns the size of 
the message upon success and -1 on failure. A return value of 0 does not indicate 
an error, but...