op_ima_obj_event_notify()

摘要

使链路对象和发射器信道对象能够直接获知某些事件。

语法

op_ima_obj_event_notify (objid, event_type, start_service_time, end_service_time, num_bits, num_packets)
参数 类型 说明
objid Objid 目标对象的对象 ID
[对象 ID 可通过 Id 包和 Topo 包中的多个内核过程获得:op_topo_parent()、op_topo_child()、op_id_from_userid() 和 op_id_from_name()。]
event_type int 指示所发生事件类型的数值常量
[目前此参数唯一合法的值是 OPC_IMA_PTTXCH_EVENT_PK_DEQUEUE。]
start_service_time double 指定对象开始处理此事件的时间。
end_service_time double 指定对象完成处理此事件的时间。
num_bits double 对象处理的比特数。
num_packets double 对象处理的数据包数。

返回类型

Compcode

完成代码,指示操作是否成功完成。

此代码可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。

示例

摘自 models/std/utilities/oms 中的 oms_bgutil.ex.c。

/* Convert to total bits and total packets. */
num_bits = tx_drate * (full_util_end_time - full_util_start_time);
if (est_job_work_mean == 0.0)
	{
	num_pks = 0.0;
	}
else
	{
	num_pks = (full_util_end_time — full_util_start_time) / est_job_work_mean;
	}
/* Update the built-in link stats. */
op_ima_obj_event_notify (tx_ch_objid, OPC_IMA_PTTXCH_EVENT_PK_DEQUEUE,
	full_util_start_time, full_util_end_time, num_bits, num_pks);

详情

此内核过程目前仅限于更新链路和发射器信道对象中的某些统计量。只有以下统计量(point-to-point 组)可以通过此内核过程更新:throughput (bits/sec)、throughput (packets/sec) 和 utilization。

一个对象不能同时处理多次 op_ima_obj_event_notify() 调用。因此,对同一对象的每次调用都应具有由 start_service_time 和 end_service_time 参数指示的唯一服务时间。如果对同一对象连续进行服务时间重叠的调用,仿真内核会将后续事件重新安排到更晚的时间。

用途

在某些情况下,仿真运行中可能包含未纳入常规事件调度机制的事件。因此,某些对象可能需要通过调用 op_ima_obj_event_notify() 直接获知事件。出现这种情况的一种情形是模型中包含后台路由流量。由于该流量是隐式的,没有相应的事件(例如数据包的创建与传输)来触发相关统计量(例如链路对象的吞吐量)的更新。目前,此内核过程的主要用途是更新支持后台利用率流量的链路和发射器信道对象中的统计量。

错误

  • 程序中止:段违例。(由于坐标指针无效)
  • 可恢复错误:对象 <object_id> 的对象状态未定义,因为其类型为(<object_type>)。(当对象既不是链路对象也不是发射器信道对象时发生此错误。)
  • 可恢复错误:未知事件类型(<event_type_number>)。(当事件类型不是 OPC_IMA_PTTXCH_EVENT_PK_DEQUEUE 时发生此错误。)
  • 可恢复错误:对象 ID(<site_objid>)指向一个受限对象。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com