
Dialogic
®
System Release 6.1 CompactPCI for Windows
®
Release Update 62
value for some parameters and non-default values for other parameters. The
default settings for the two new QoS alarm types are:
Note: Only the fault thresholds are configurable; all other parameters must be set to
0. For information about setting the fault thresholds, see Section 1.19.2,
“Setting the Fault Thresholds”, on page 63.
c. Call gc_SetAlarmParm( ) to use the QoS parameter values set in step 1b.
2. Call gc_SetAlarmNotifyAll( ) to enable notification of all QoS alarms, or use
gc_SetAlarmConfiguration( ) to enable notification of selected QoS alarms. (QoS
monitoring for the new QoS alarms is disabled by default.)
3. Monitor QoS alarm notification events:
a. When a QoS alarm has been triggered, a GCEV_ALARM event is generated by
the system. Call the Standard Runtime Library function sr_getevttype( ) to return
the event type.
b. Use the following Global Call functions to extract further details about the alarm:
gc_GetMetaEvent( ), gc_AlarmSourceObjectID( ), gc_AlarmNumber( ),
gc_AlarmName( ).
Note: For Dialogic
®
IPT Boards, the system software sends a QoS alarm event
containing ALARM_STATE_ON when a fault threshold is exceeded, but does
not report a QoS event containing ALARM_STATE_OFF when the threshold
returns to the programmed level. An RTCP/RTP timeout alarm is reset either
on resumption of RTCP/RTP packets, end of RTP session, or end of call, but
no notification is sent to the application when the alarm is reset.
1.19.1.2 Implementing QoS Alarms Using Dialogic
®
IP Media Library API
The following steps provide guidelines for implementing QoS alarms in your application
using the Dialogic
®
IP Media Library API. For details on the IP Media Library functions
and data structures that are mentioned, see the Dialogic
®
IP Media Library API Library
Reference. In addition, the Dialogic
®
IP Media Library API Programming Guide describes
how QoS may be used in an application.
1. Optional steps before enabling a QoS alarm:
a. Call ipm_GetQoSThreshold( ) to retrieve the current settings of QoS parameters
on the specified IP channel.
b. If you need to change current QoS parameter values, set up the
IPM_QOS_THRESHOLD_INFO structure with desired values. This structure
contains one or more IPM_QOS_THRESHOLD_DATA structures. Note that you
must explicitly specify the value for every parameter in the
IPM_QOS_THRESHOLD_DATA structure, even if you want to use the default
QoS Type
Time
Interval (ms)
Debounce
On (ms)
Debounce
Off (ms)
Fault
Threshold
%Success
Threshold
%Fail
Threshold
QOSTYPE_
RTCPTIMEOUT
0 0 0 250(x100 msec
= 25 sec)
00
QOSTYPE_
RTPTIMEOUT
0 0 0 1200(x100
msec = 120
sec)
00
Kommentare zu diesen Handbüchern