SL_STATION_SET_MWI_CNF primitive

Purpose

Confirm a request to set a message waiting indicator on a specified number.

Requirement

Optional for all signaling processes.

Library

The signaling interface library (libsl.a).

C syntax

typedef struct {
                SL_ID id;
                int iseq_no;
                pid_t pidCHP;
                SL_PRIMITIVE_TYPE Command;
                SL_CONFIRM_PARM_ST Parms;
} SL_CONFIRM_ST;
...
typedef union {
...
                struct _station_set_mwi_confirm_st{
                    size_t sizetLength;
                    SL_REPLY_CODE ReplyCode;
                    char phone_num[SL_NUM_SZ];
                    SL_MWI_STATE state;
                } station_set_mwi_confirm_st;
...
} SL_CONFIRM_PARM_ST;

Description

The SL_STATION_SET_MWI_CNF primitive is sent by the signaling process to Blueworx Voice Response to confirm whether the message waiting indicator was successfully set or not.

Parameters

id

Eye-catcher that identifies the structure as containing a confirm primitive. Must be set to SLID_CONFIRM_ST.

iseq_no

The sequence number of the primitive. Must be set to the field iseq_no from the SL_STATION_SET_MWI_REQ primitive, to which this is the reply.

pidCHP

The process id of the requesting process. This should be set to the pidCHP field from the corresponding SL_STATION_SET_MWI_REQ primitive.

Command.id

The primitive that the structure contains. Must be set to SL_STATION_SET_MWI_CNF.

Parms.station_set_mwi_confirm_st.sizetLength

Must be set to sizeof(struct _station_set_mwi_confirm_st).

Parms.station_set_mwi_confirm_st.ReplyCode

Specifies the success, or otherwise of the primitive.

SL_REPLY_SUCCESS: Success. The message waiting indicator was set to the state in Parms.station_set_mwi_confirm_st.state.
other values: Failure.

Parms.station_set_mwi_confirm_st.phone_num

Specifies the phone number, associated with the message waiting indicator.

Parms.station_set_mwi_confirm_st.state

Identifies the current state of the message waiting indicator.

SL_MWI_OFF: The message waiting indicator has been cleared.
SL_MWI_SLOW: The message waiting indicator is blinking slowly.
SL_MWI_FAST: The message waiting indicator is blinking rapidly.
SL_MWI_ON: The message waiting indicator is on.