op_sim_end()

摘要

终止仿真,关闭向量输出文件,并打印若干指定行。

语法

op_sim_end (line0, line1, line2, line3)
参数 类型 说明
line0 const char* 消息行 #0
line1 const char* 消息行 #1
line2 const char* 消息行 #2
line3 const char* 消息行 #3

返回类型

void

无返回值(调用 op_sim_end() 之后的任何代码都不会被执行)。

示例

摘自:示例模型(models/std/hssb);进程模型(hssb_appl);状态(INIT);enter execs。

/* Obtain self ID */
myid = op_id_self ();

/* Obtain the attribute values. */
op_ima_obj_attr_get (myid, "address", &my_address);
op_ima_obj_attr_get (myid, "average_interarrival_time", &ia_time);
op_ima_obj_attr_get (myid, "average_service_time", &service_time);
op_ima_obj_attr_get (myid, "ack_service_time", &ack_service_time);

op_ima_sim_attr_get (OPC_IMA_INTEGER, "number_of_nodes", &number_of_nodes);

ppid = op_topo_parent (myid);
op_ima_obj_attr_get (ppid, "name", name);

/* Verify the address. */
if (my_address > number_of_nodes)
	{
	op_sim_end ("err: appl process: address > number of nodes", "", "", "");
	/* The rest of the block will not be executed */
	}

详情

该内核过程在仿真的标称持续时间(由 duration 环境属性决定)结束之前终止仿真。由于仿真已结束,结束仿真中断会被投递给所有启用了 endsim intrpt 属性的其他处理器和队列。(调用该内核过程的模块不会收到结束仿真中断。)

从图形环境运行仿真时,消息窗口中只会显示所指定的四行中的前三行,但所有行都会出现在同时输出到 shell 和 DES 日志的内容中。

用途

提供了一种根据可调用该内核过程的进程的动态状态,以受控方式有条件地终止仿真的机制。该内核过程最常用于以下两种情形:

  • 仿真逻辑捕获到异常错误状况,使仿真继续推进不再必要
  • 仿真逻辑基于统计收敛或其他仿真完成状态指标发现了停止条件。

在这两种情形下,通常都重要的是让仿真以受控方式结束,从而使仿真一直在写入的向量和标量输出文件被正确完成并关闭。

错误

  • 程序中止:段违例。(由于无效或格式错误的消息字符串)

参考

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