Interfaces 菜单操作
本节介绍进程编辑器中 Interfaces 菜单所提供操作的使用方法及相关过程。该菜单中的各项按字母顺序介绍如下。
中断代码映射
该操作允许你为中断代码指定随其一同打印的文本字符串,这些中断代码会出现在 ODB 事件横幅以及各种 op_intrpt_schedule_ 内核过程的跟踪记录中。通过这种映射,调试期间更容易理解中断代码。你可以为过程调用中断、进程中断、远程中断和自中断映射代码。
注: 这些中断代码是调度中断时指定的用户自定义代码,由 op_intrpt_code() 内核过程返回。
图 195:中断代码对话框及 ODB 输出示例

全局属性
该操作允许你定义新的全局属性,并编辑或删除已有属性。全局属性不与任何特定对象关联,而是作用于整个仿真。通常,仿真中某一类对象整体都需要全局属性,例如某一特定类型的所有进程。这些进程共享该全局属性,因此可以保证对其取值达成一致(与之相反,进程模型属性为每个进程模型实例提供各自独立的取值)。
进程可以使用内核过程 op_ima_sim_attr_get() 查询全局属性。在进程模型中声明全局属性可支持其它工具的若干重要机制。在探针编辑器中,属性探针可以设置为以标量值形式采集全局属性的值。在仿真序列编辑器中,可以在执行仿真之前为已声明的全局属性赋值,从而避免在仿真内核遇到进程的请求时再动态获取该值。
有关全局仿真属性的更多信息,参见
全局统计量
该操作声明可在仿真期间记录并作为结果查看的命名全局统计量。全局统计量的作用范围是整个仿真,与之相对,局部统计量的作用范围是某个特定的队列或处理器。换言之,位于模型系统中不同位置的多个进程以及管道阶段都可以贡献于同一个共享统计量。做法是按名称引用该统计量并获得统计量句柄(更多信息参见"Statistic Handles"第 4 页)。全局统计量不能作为统计量连线的源。
当你选择 Interfaces > Global Statistics 时,将出现 Declare Global Statistics 对话框(图 196)。在该对话框中,你可以创建新的全局统计量、删除已有统计量,或修改统计量的某些方面。要对表格排序,可点击标题单元格;重复点击可切换排序顺序。
注: 高级用户可能发现,手工编辑一个列表再导入表格更便于声明大量全局统计量。详情参见编辑局部与全局统计量声明。
图 196:Declare Global Statistics 对话框

下表列出 Declare Global Statistics 对话框中的各字段。
表 102:Declare Global Statistics 对话框——字段
| 名称 | 说明 |
|---|---|
| Stat Name | 进程模型所定义的统计量的名称。 |
| Group | 统计量所属的组。该组用于在统计量浏览器所示的层次结构中组织该统计量。 |
| Mode | 维数。single-mode(单模式)统计量只生成一列随时间变化的独立取值序列。dimensioned-mode(带维数模式)统计量实际上表示一组单模式统计量(即数组),其中每个统计量独立管理,并可分别用于探针和统计量连线。 带维数统计量中的各个单独统计量共享同一基础名称,但以其在统计量数组中的索引相区分。这种机制在管理大量定义相似的统计量时非常有用。例如,某交换机相对于八条出站链路的性能统计量,可以用带维数统计量声明,而不必逐个声明。这种方式更具可扩展性:只需增大统计量数组的维数,进程模型就能更容易地跟踪节点模型的增长。 |
| Count | 带维数统计量中元素的个数,类似于数组的维数。 |
| Capture Mode | 统计量的默认采集模式。 有关采集模式的详情,参见"Project Editor"第 89 页。 |
| Draw Style | 统计量的默认绘制样式。 |
| Low Bound | 绘制该统计量图形时纵轴显示的最低刻度。绘制图形时会考虑上下界,但这些界限并非绝对限制。 大多数统计量不会采集负值,因此通常可将该值设为 0。内置统计量的下界为 0。 |
| High Bound | 绘制该统计量图形时纵轴显示的最高刻度(前提是实际结果小于该上界值)。如果为该统计量采集到的某个值高于你设置的上界,纵轴将自动扩展,以便正确绘制最高的数据点。 |
| Description | 统计量的简要说明。左键点击可在文本编辑区中显示完整说明。 |
有关全局统计量的更多信息,参见
局部统计量
该操作声明的命名统计量既可以在节点层作为统计量连线的源,也可以作为探针编辑器中定义的节点统计量探针。局部统计量的作用范围是进程所运行的队列或进程模块。换言之,进程模型的每个独立实例都可以各自维护一个同名的局部统计量。这些统计量随时间独立变化,可以分别探测,并可用于馈送统计量连线。
当你选择 Interfaces > Local Statistics 时,将出现 Declare Local Statistics 对话框(图 197)。在该对话框中,你可以创建新的局部统计量、删除已有统计量,或修改统计量的某些方面。要对表格排序,可点击标题单元格;重复点击可切换排序顺序。
注: 高级用户可能发现,手工编辑一个列表再导入表格更便于声明大量全局统计量。详情参见编辑局部与全局统计量声明。
图 197:Declare Local Statistics 对话框

该对话框中的字段与 Declare Global Statistics 对话框相同,如表 102所列。
有关局部统计量的更多信息,参见
模型属性
该操作允许你定义新的进程模型属性,并编辑或删除已有属性。
进程模型属性本质上是模型的"参数",使模型的使用者能够以预定义的方式控制模型的行为。进程模型属性会自动提升到节点层,表现为处理器模块和队列模块的属性。
进程模型属性的一项重要功能是泛化进程模型的适用范围。具体而言,与其把某个固定特性(例如"硬连线常量")嵌入进程模型,不如用进程模型属性来表示同一特性。进程模型(即进程)的每个实例在仿真开始时获知其特定的属性赋值,并相应地调整自身的配置或行为。这样,进程模型通过支持更广泛的应用获得了更高的可重用性。另一种做法是创建许多仅在少量内置特性上略有差异的几乎完全相同的进程模型。这种做法不太可取,因为它需要维护更大的实现,并且每当出现细微变化时都需要不断复制进程模型。此外,通过使用进程模型属性对行为进行参数化,仿真序列只需改变属性值即可自动遍历不同的场景。
有关进程模型属性的更多信息,参见"Process Domain"(进程域)第 165 页。
ODB 标签
该操作允许你为进程模型中使用的任意标签关联说明。这些信息可以在仿真调试器中显示(参见 ODB 命令"lmap"第 117 页)。你在此定义的标签和说明应当与进程模型代码中使用的标签一致。不过,系统不会强制检查所定义标签的有效性,它们也不影响进程模型的编译或在 ODB 中的使用。
并行执行支持
该子菜单允许你指定当前进程模型中的代码是否 MT 安全(从而决定该进程模型执行的事件能否并行执行)。
可选项为:
- Support Parallel Execution – 该进程模型是 MT 安全的,可以并行运行。
- Does Not Support Parallel Execution – 该进程模型不是 MT 安全的,始终顺序运行。
- Model Safety Has Not Been Studied – MT 安全性未知。代码将以并行模式还是顺序模式运行,由 "parallel_sim.unknown_process_mt_safety_handling" 偏好设置决定。
警告: 除非进程模型代码是 MT 安全的(如"Making Models Parallel-Safe"(使模型具备并行安全性)第 413 页所述),否则不要选择 Support Parallel Execution 选项。
进程接口
该操作允许你为队列和处理器的内置属性设置取值并指定其行为。该操作支持的函数是节点模型接口为节点对象内置属性所支持函数的一个子集。这些函数的说明参见"Node Interfaces"(节点接口)第 461 页。
图 198:Process Interfaces 对话框

进程模型的属性接口比节点模型的属性接口简单一些,因为与节点模型不同,进程模型不包含向下一个建模域提升属性的对象。进程模型提升到节点层的属性只有进程模型属性。不过,进程模型属性不受进程模型属性接口的影响,正如节点模型属性与节点模型属性接口分别管理一样。
因此,进程模型属性接口仅适用于控制队列和处理器的内置属性。这一机制有助于简化队列和处理器的属性列表,并强制执行进程模型所依赖的特定属性设置。例如,实现统计量收集进程的进程模型可能依赖于收到仿真结束中断。进程模型开发者可以通过进程模型属性接口启用并隐藏处理器模块的 "endsim intrpt" 属性,从而保证处理器模块提供该服务。隐藏该属性后,进程模型开发者即可防止其取值在节点层被更改。
并非队列和处理器的所有内置属性都能以这种方式控制。有关可受低层模型属性接口影响的特定内置属性的更多信息,参见"Modeling Concepts"(建模概念)。