4.10. Quality of Service Alarm Management

Global Call supports the setting and retrieving of Quality of Service (QoS) thresholds and the handling of a QoS alarm when it occurs. The QoS thresholds supported by Global Call are:

• Lost packets
• Jitter

When developing applications that use Intel® NetStructure IPT boards, the only threshold attribute supported is the fault threshold value. Similarly, when developing applications that use Intel® NetStructure DM/IP boards, the supported threshold attributes are: time interval, debounce on, debounce off, fault threshold, percent success threshold, and percent fail threshold.

See the IP Media Library API Library Reference and the IP Media Library API Programming Guide for more information on the supported thresholds.

When using Global Call with other technologies (such as E-1 CAS, T-1 Robbed Bit etc.), alarms are managed and reported on the network device. For example, when gc_OpenEx( ) is issued, specifying both a network device (dtiB1T1) and a voice device (dxxxB1C1) in the devicename parameter, the function retrieves a Global Call line device. This Global Call line device can be used directly in Global Call Alarm Management System (GCAMS) functions to manage alarms on the network device.

When using Global Call with IP technology, alarms such as QoS alarms, are more directly related to the media processing and are therefore reported on the media device not on the network device. When gc_OpenEx( ) is issued, specifying both a network device (iptB1T1) and a media device (ipmB1C1) in the devicename parameter, two Global Call line devices are created:

• The first Global Call line device corresponds to the network device and is retrieved in the gc_OpenEx( ) function.
• The second Global Call line device corresponds to the media device and is retrieved using the gc_GetResourceH( ) function. This is the line device that must be used with GCAMS functions to manage QoS alarms. See the Global Call API Programming Guide for more information about GCAMS.

Note: Applications must include the gcipmlib.h header file before Global Call can be used to set or retrieve QoS threshold values.

Click here to contact Telecom Support Resources