SL_TRUNK_ALARM_REQ primitive

Purpose

Notify a signaling process that a PCM fault condition has occurred or been cleared.

Requirement

Mandatory for signaling processes that registered with the capability SL_SIGPROC_CAPABILITY_TRUNK_ALARM. 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_REQUEST_PARM_ST Parms;
} SL_REQUEST_ST;
...
typedef union {
...
                struct _trunk_alarm_request_st {
                    size_t sizetLength;
                    int iVpackNo;
                    SL_ALARM_TYPE slAlarm;
                } trunk_alarm_request_st;
...
} SL_REQUEST_PARM_ST ;

Description

The SL_TRUNK_ALARM_REQ primitive is sent by Blueworx Voice Response system management to the signaling process when a PCM fault condition occurs on a trunk or is cleared.

This primitive is intended for use when implementing signaling protocols that specify call processing behaviors under PCM fault conditions.

If the signaling process receives an SL_TRUNK_ALARM_REQ primitive with slAlarm set to any value except SL_ALARM_CLEAR, a PCM fault condition has occurred on the trunk.

When the signaling process receives an SL_TRUNK_ALARM_REQ primitive with slAlarm set to SL_ALARM_CLEAR, all PCM fault conditions have cleared.

If an alarm occurs on the only signaling trunk in an NFAS system the dependent non-signaling trunks will have their calls cleared as well. No calls can be made on any of these trunks.

When the alarm clears or another signaling trunk is enabled, the non-signaling trunks will be fully operational.

Corresponding state table action

None.

Corresponding user interface action

None.

Parameters

id

Eye-catcher that identifies the structure as containing a request primitive. This must be set to SLID_REQUEST_ST.

iseq_no

The sequence number of the primitive. This field must be set to 0 when the primitive is sent to Blueworx Voice Response; the actual sequence number is allocated by Blueworx Voice Response, and is available to the sender on return from sl_send_request(). This field is set when the primitive is received from Blueworx Voice Response by the signaling process.

pidCHP

The process id of the sending process. The signaling process should use this value to set the pidCHP field of the corresponding SL_TRUNK_ALARM_CNF primitive.

Command.id

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

Parms.trunk_alarm_request_st.sizetLength (of type size_t)

Must be set to sizeof(struct _trunk_alarm_request_st).

Parms.trunk_alarm_request_st.iVpackNo (of type int)

Identifies the trunk being alarmed.

Parms.trunk_alarm_request_st.slAlarm

Identifies the alarm condition:

SL_ALARM_CLEAR: The fault condition notified previously has cleared.
other values: A fault condition has occurred. For a description of the fault conditions, see Trunk alarms.