op_stat_obj_reg()

摘要

返回一个可用于写入链路、路径、模块或子模块统计量(仅局部)的句柄。

语法

op_stat_obj_reg (group_dot_stat_name, obj_id, index)
参数 类型 说明
group_dot_stat_name const char* 需要获取句柄的统计量的组名和名称,两者以句点分隔。
obj_id Objid 包含待注册统计量的对象的 ID。
index int 目标统计量的数字索引;若统计量没有维度,则用 OPC_STAT_INDEX_NONE。参见表 79“Statistic Index Symbolic Constants“(第 24 页)。

返回类型

Stathandle

可用于调用内核过程 op_stat_write() 和 op_stat_write_t() 的统计量句柄。

示例

count = op_topo_assoc_count (self, OPC_TOPO_ASSOC_IN, OPC_OBJMTYPE_LINK);
if (count != 1)
	op_sim_end ("Only one link should be connected to packet generator in this model",
		"", "", "", "");

objid = op_topo_assoc (self, OPC_TOPO_ASSOC_IN, OPC_OBJMTYPE_LINK, 0);

link_stat = op_stat_obj_reg ("Test.Non-Dimensional Counter", objid,
	OPC_STAT_INDEX_NONE);

for (j=0; j < 4; j++)
	{
	link_dim_stat [j] = op_stat_obj_reg ("Test.Dimensional Counter", objid, j);
	}

/* rest of original pksw code */
address_dist = op_dist_load ("uniform_int", 0, 3);
ete_gsh = op_stat_reg ("ETE delay", OPC_STAT_INDEX_NONE, OPC_STAT_GLOBAL);

详情

该过程与 op_stat_reg() 类似;主要区别在于:该过程允许使用任何形式的可执行代码(如管道过程和外部代码)访问任何对象的统计量,并且仅支持局部统计量。

仿真内核集中管理全局和局部统计量。每个统计量都维护一个组名、名称、索引、类型和输出向量。用户在首次通过 op_stat_obj_reg() 注册统计量时指定其组名、名称和索引。此后以已注册的组名和名称再次调用该内核过程,将与先前注册时创建的统计量“会合”(rendezvous),并返回同一个句柄。这使得多个进程可以访问同一个统计量,前提是它们有围绕名称同步的机制。同一模块内的进程可以在同一个局部统计量上会合。任何进程都可以在同一个全局统计量上会合。

维度化统计量提供一组输出统计量。Stathandle 指由索引指定的该组中的元素。对于无维度的统计量,索引值必须使用符号常量 OPC_STAT_INDEX_NONE。

注册统计量需要根据指定的名称和组在现有统计量集合中进行搜索。为了提升性能,用户应当只注册一次统计量,并把得到的统计量句柄缓存起来(例如存放在状态变量中)供后续使用。

用途

统计量注册使多个进程能够共享同一个输出向量来记录仿真度量。通过注册获得对统计量的访问后,进程可以围绕统计量名称进行协调,从而避免独立开发的模型之间的冲突。该函数返回一个统计量句柄,通过内核过程 op_stat_write() 和 op_stat_write_t() 向统计量写入新值时需要该句柄。

错误

  • 程序中止(Program Abort):段错误。(由于无效或格式错误的 stat_name 参数)
  • 可恢复错误(Recoverable Error):无法注册统计量(<stat_name>)。(由于统计量未声明)
  • 可恢复错误(Recoverable Error):无法注册统计量(<stat_name>)。(由于可用内存不足)
  • 程序中止(Program Abort):该内核过程需要进程上下文。
  • 可恢复错误(Recoverable Error):统计量索引(<stat_index>)超出范围。

参考

  • 使用内核过程 op_stat_reg() 在进程模型内访问节点或模块统计量
  • 使用内核过程 op_stat_write() 向输出统计量写入值,并以当前仿真时间标记
  • 使用内核过程 op_stat_write_t() 向输出统计量写入值,并以指定仿真时间标记
  • 使用内核过程 op_stat_scalar_write() 向标量统计量写入值

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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