SL_TRUNK_DISABLE_IND primitive

Purpose

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

Requirement

Mandatory for common channel signaling processes that wish 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 _trunk_disable_indication_st {
                    size_t sizetLength;
                    int iVpackNo;
                } trunk_disable_indication_st;
...
} SL_INDICATION_PARM_ST ;

Description

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

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

Before sending the SL_TRUNK_DISABLE_IND primitive, the signaling process should clear any active calls on the channel by sending the SL_CALL_TERMINATE_IND primitive for each one.

The SL_TRUNK_DISABLE_IND primitive is used to indicate a permanent error condition, which may require manual intervention, and which requires re-enabling the trunk. The SL_TRUNK_ALARM_IND primitive is used to indicate a temporary or transient alarm condition, which may reasonably be expected to clear without intervention. See SL_TRUNK_ALARM_IND primitive.

Corresponding state table action

None.

Corresponding user interface action

The System Monitor window shows the trunk as disabled.

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_TRUNK_DISABLE_IND.
Parms.trunk_disable_indication_st.sizetLengthI: Must be set to sizeof(struct _trunk_disable_indication_st).
Parms.trunk_disable_indication_st.iVpackNo: Identifies the trunk on which the error has occurred.