SL_CHANNEL_DISABLE_IND primitive

Purpose

Indicate that a channel has entered a fatal error state, and that the channel is no longer usable.

Requirement

Mandatory for common channel signaling processes wanting to report asynchronous failures. Otherwise this primitive is not used.

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_INDICATION_PARM_ST Parms;
} SL_INDICATION_ST;
...
typedef union {
...
                struct _channel_disable_indication_st {
                    size_t sizetLength;
                    int iVpackNo;
                    int iChannelNo;
                    SL_CHANNEL_TYPE fSignallingLink;
                } channel_disable_indication_st;
...
} SL_INDICATION_PARM_ST;

Description

The SL_CHANNEL_DISABLE_IND primitive is sent by the signaling process to Blueworx Voice Response system management to indicate that a channel has entered a fatal error state, and the channel is no longer usable.

The signaling process should use this primitive to indicate a fatal error on a channel which cannot be cleared without re-enabling the channel. Once the signaling process has sent the primitive, the channel is in state SL_CHANNEL_STATE_DISABLED and the System Monitor window shows that the channel is currently disabled.

Before sending the SL_CHANNEL_DISABLE_IND primitive, the signaling process should clear any active calls on the channel by sending the SL_CALL_TERMINATE_IND primitive.

Corresponding state table action

None.

Corresponding user interface action

The Channel Out of Service window shows the channel as blocked.

Parameters

id: Eye-catcher that identifies the structure as containing an indication primitive. This must be set to SLID_INDICATION_ST.
iseq_no: The sequence number of the primitive. Must be set to 0.
pidCHP: Must be set to -1.
Command.id: The primitive that the structure contains. Must be set to SL_CHANNEL_DISABLE_IND.
Parms.channel_disable_indication_st.sizetLength: Must be set to sizeof(struct _channel_disable_indication_st).
Parms.channel_disable_indication_st.iVpackNo: Identifies the trunk on which the error has occurred.
Parms.channel_disable_indication_st.iChannelNo: Identifies the channel on which the error has occurred.
Parms.channel_disable_indication_st.fSignallingLink: Must be set to SL_BEARER_CHANNEL using the SL_CHANNEL_TYPE enumeration, unless you want to inform the system of a change in the state of the signaling channel.