oms_wp_phy_measure_notification_subscribe()
摘要
在先前安装的测量中安装一个通知告警。
语法
oms_wp_phy_measure_notification_subscribe (phy_handle, subclient_id, subclient_name, measure_type, threshold_dir, threshold_value, measure_identification_code);
| 参数 | 类型 | 说明 |
|---|---|---|
phy_handle |
OmsT_WP_Phy_Handle* |
PHY 模块句柄 |
subclient_id |
int |
在当前客户端模块中标识该告警子客户端的编号 |
subclient_name |
const char* |
告警客户端的名称 |
measure_type |
OmsT_WP_Measurement_Type |
测量类型 详见 OmsT_WP_Measurement_Type。 |
threshold_dir |
OmsT_WP_Measurement_Threshold_Direction |
指示当前测量值在高于或低于指定阈值值时是否被上报。 详见 OmsT_WP_Measurement_Threshold_Direction。 |
threshold_value |
double |
阈值值 |
measure_identification_code |
int |
与测量类型组合后可唯一标识该测量的码 |
返回类型
void
详细说明
通知告警将作为远程中断传递给调用此函数的模块。如果满足阈值值和方向条件,该测量将生成告警。
示例
coverage_area_tracker 进程模型 init4 exit executives 的节选。
* Obtain a handle to the advanced wireless PHY module. */
phy_handle = oms_wp_phy_module_handle_get ("phy");
/* Register a received power measure. Note that the object ID of the cell */
/* transmitter is associated to this measurement so only the packets sent from */
/* that node contribute to this measurement. */
oms_wp_phy_measure_register_single(phy_handle,
(int) Transmitter_Node_Objid,
OmsC_WP_RCV_Power,
OMSC_WP_MEASURE_WNDW_SIZE_NONE,
coverage_tracker_phy_rcvd_power_measurement_collect_only_one_node);
/* Add a notification alert when received power is above the monitored threshold. */
oms_wp_phy_measure_notification_subscribe (phy_handle, /* PHY handle. */
0, /* The module client ID that needs the notification. */
"Tracking Module", /* The module client name that needs the notification. */
OmsC_WP_RCV_Power, /* Measurement type */
OmsC_WP_Alert_Threshold_Direction_Up, /* Threshold direction */
oms_wp_phy_convert_dbm_to_watts(Target_Min_Received_Power), /* Threshold value */
(int)Transmitter_Node_Objid); /* Measurement entity key */