Purpose
Confirm that a signaling process has received notification of the occurrence
or clearing of a PCM fault condition.
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_CONFIRM_PARM_ST Parms;
} SL_CONFIRM_ST;
...
typedef union {
...
struct _trunk_alarm_confirm_st {
size_t sizetLength;
SL_REPLY_CODE ReplyCode;
int iVpackNo;
SL_ALARM_TYPE slAlarm;
}trunk_alarm_confirm_st;
...
} SL_CONFIRM_PARM_ST;
Description
The SL_TRUNK_ALARM_CNF primitive is sent by the signaling
process to Blueworx Voice Response system management to confirm receipt of the SL_TRUNK_ALARM_REQ.
This primitive is intended for use when implementing signaling protocols
that specify call processing behaviors under PCM fault conditions.
If the signaling process replies unsuccessfully to this primitive, or if
the signaling process does not respond to the SL_TRUNK_ALARM_REQ, the system manager logs and error reporting that the signaling process
has failed. This is a programming error in the signaling process. It is the
responsibility of the signaling process to log the reason for its failure
and any diagnostic information.
Corresponding state table action
None.
Corresponding user interface action
The System Monitor window shows all the channels on this trunk in the ALARM
state if a PCM fault condition has occurred. The System Monitor window returns
the channels to their previous state when the PCM fault condition clears.
Parameters
- id
- Eye-catcher that identifies the structure as containing a confirm primitive.
This 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_TRUNK_ALARM_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_TRUNK_ALARM_REQ primitive.
- Command.id
- The primitive that the structure contains. Must be set to SL_TRUNK_ALARM_CNF.
- Parms.trunk_alarm_confirm_st.sizetLength
- Must be set to sizeof(struct _trunk_alarm_confirm_st).
- Parms.trunk_alarm_confirm_st.ReplyCode
-
- SL_REPLY_ABORTED
- The signaling process has received an SL_ABORT_REQ primitive
specifying the sequence number of an SL_TRUNK_ALARM_REQ for
a trunk which is being enabled. The signaling process should reply with SL_REPLY_ABORTED, and disable the trunk if necessary. The trunk
is now in state SL_TRUNK_STATE_DISABLED.
- SL_REPLY_INTERNAL_ERROR
- The signaling process has received an SL_TRUNK_ALARM_REQ primitive. During the processing of this primitive an internal error
occurred in the signaling process. The trunk is now in state SL_TRUNK_STATE_DISABLED.
- SL_REPLY_INVALID_STATE
- The signaling process has received an SL_TRUNK_ALARM_REQ primitive specifying the id of a trunk that is not in the SL_TRUNK_ENABLED or SL_TRUNK_ALARM states. The trunk remains in its current
state.
- SL_REPLY_SUCCESS
- The trunk is now in state SL_TRUNK_STATE_ENABLED,
if fAlarm is FALSE. The trunk is now in state SL_TRUNK_STATE_ALARM, if fAlarm is TRUE.
- other values
- Not supported.
- Parms.trunk_alarm_confirmst.iVpackNo
- Identifies the trunk which was enabled.
- Parms.trunk_alarm_confirm_st.slAlarm
- Identifies the fault condition: This field should be set to the value
of Parms.trunk_alarm_request_st.slAlarm from the corresponding SL_TRUNK_ALARM_REQ primitive.
- SL_ALARM_CLEAR
- The fault condition notified previously has cleared.
- other values
- A fault condition has been noted. For a description of the fault conditions,
see Trunk alarms.