op_subq_print()

摘要

将指定子队列的数据包内容打印到标准输出设备。

语法

op_subq_print (subq_index)
参数 类型 说明
subq_index int 目标子队列的数字索引 [子队列流索引从 0 开始,依次递增 1。子队列的数量没有上限,但如果连续使用它们,可以实现内存的节约使用。除了显式的子队列索引,还可以指定抽象子队列选择索引。抽象子队列选择索引通过某个子队列独有的属性来指定该子队列。可接受的抽象子队列选择索引列于表 85“Subqueue Selection Index Symbolic Constants“ 第 26 页。]

返回类型

void

无返回值。

示例

/** diagnostic block **/
/* print name of queue */
op_ima_obj_attr_get (op_id_self (), "name", qname);
printf (">>> QUEUE [%s] <<<\n", qname);

/* print selected stats */
printf ("average bitsize (%g)\n\n",
	op_q_stat (OPC_QSTAT_AVG_BITSIZE));

/* print subqueue contents */
op_subq_print (0);

标准输出设备上显示的示例输出:

>>> QUEUE [OF_Buffer] <<<
average bitsize (452.5)

---------- sub (0) ----------
0)   packet id = (100), address (234281), priority (0), insert_time (4.128)
1)   packet id = (117), address (236812), priority (0), insert_time (15.0212)
2)   packet id = (122), address (237321), priority (0), insert_time (20.018)

详情

默认情况下,仿真的标准输出设备就是派生仿真进程的命令行 shell。若仿真进程由 GUI 派生,则标准输出设备是派生应用进程的命令行 shell。若仿真进程从 shell 窗口启动,默认的标准输出设备将与该窗口关联。可以在仿真命令行上使用“>”I/O 重定向操作符将标准输出重定向到文件。

本 KP 生成的子队列数据包内容信息的格式如上一页的示例所示。注意,数据包地址以十六进制数显示。

本 KP 只能在与队列模块上运行的进程的上下文中调用(或由队列进程直接或间接调用的函数中调用);从处理器上运行的进程或管道级模型调用将导致错误。

用途

为用户提供一种从终端监视子队列内容,或将子队列内容记录到文件中供后续研究的手段。当到达的数据包包含用于进程计算或影响进程逻辑流程的值时,打印子队列内容在仿真调试器中非常有用。打印子队列内容的语句可以添加到状态执行例程(用于事件驱动打印),或添加到诊断块(用于用户驱动打印,即在调试器中发出 prodiag 命令时打印子队列内容)。

错误

  • 程序中止:KP 需要队列上下文。
  • 可恢复错误:子队列选择标志(<flag>)无法识别。

参考

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