属性符号常量
通过 EMA 可访问的部分模型与对象属性是整数,可取若干值之一,每个值都有特殊的符号含义(即代码或标志)。为便于使用,这些属性的可能取值由本节列出的符号常量表示。这些常量的替换值可能在新版本中改变,因此不建议使用实际的数值常量来代替符号常量。
下面列出的网格单位(grid unit)符号常量用于标识子网内部用于度量节点与链路位置的网格类型。这些常量可赋给网络模型中 subnet 对象的 grid unit 属性。赋给该子网属性的网格单位值决定了网络对象所有与网格和位置相关属性的单位解释(在模型、对象与属性中的网络属性表里,基于网格的属性单位以“subnet grid unit”表示)。
表 141:网格单位符号常量
OPC_GRID_UNIT_DEGOPC_GRID_UNIT_FOOTOPC_GRID_UNIT_KILOMETEROPC_GRID_UNIT_METEROPC_GRID_UNIT_MILEOPC_GRID_UNIT_NONE
下面列出的网格样式(grid style)符号常量用于指定子网内网格的外观。这些常量可赋给网络模型中 subnet 对象的 grid style 属性。
表 142:网格样式符号常量
OPC_GRID_STYLE_DASHEDOPC_GRID_STYLE_NONEOPC_GRID_STYLE_SOLID
下面列出的图形颜色(graphics color)符号常量用于指示对象或对象子组件的颜色偏好。这些常量通常赋给对象的 color 属性。支持该属性的对象如下:
- 网络模型(satellite node、mobile node、simplex point-to-point link、duplex point-to-point link、bus link、bus tap)
- 节点模型(stream、statistic wire)
- 外部系统定义(esys interface)
- 进程模型(transition)
此外,网络模型的子网还支持 outline color 与 grid color 两个颜色属性。
表 143:图形颜色符号常量
OPC_GFX_COLOR_BEIGEOPC_GFX_COLOR_BLACKOPC_GFX_COLOR_BLUEOPC_GFX_COLOR_BRICKOPC_GFX_COLOR_BROWNOPC_GFX_COLOR_CORNOPC_GFX_COLOR_CYAN¹OPC_GFX_COLOR_FUCHSIAOPC_GFX_COLOR_GREENOPC_GFX_COLOR_GREYOPC_GFX_COLOR_MAGENTAOPC_GFX_COLOR_MAROONOPC_GFX_COLOR_OLIVEOPC_GFX_COLOR_ORANGEOPC_GFX_COLOR_ORCHIDOPC_GFX_COLOR_PEACHOPC_GFX_COLOR_PINKOPC_GFX_COLOR_PLUMOPC_GFX_COLOR_PURPLEOPC_GFX_COLOR_REDOPC_GFX_COLOR_SIENNAOPC_GFX_COLOR_SLATEOPC_GFX_COLOR_STEELOPC_GFX_COLOR_TANOPC_GFX_COLOR_TURQ¹OPC_GFX_COLOR_VIOLETOPC_GFX_COLOR_WHITEOPC_GFX_COLOR_YELLOW
注 1:CYAN 与 TURQ 表示同一颜色值。
除上面列出的具名图形颜色符号常量外,还有一组以红、绿、蓝(RGB)分量表示颜色的已定义符号常量。图形用户界面(GUI)支持 64 种不同颜色,基于每种颜色 4 个亮度级的 64 种 RGB 排列(64 = 4 x 4 x 4)。基于 RGB 的符号常量格式为:
OPC_GFX_COLOR_RGB<r><g><b>
其中 <r>、<g> 和 <b> 可取值 0、1、2 和 3。该格式的极限情形是黑色(OPC_GFX_COLOR_RGB000)和白色(OPC_GFX_COLOR_RGB333)。
下面列出的中断方法(interrupt method)符号常量用于指定由数据包到达或统计线触发所引起的中断类型。这些常量可赋给以下对象 / 模型对的 intrpt method 属性:
- 节点模型中的 stream 对象
- 节点模型中的 statistic wire 对象。
从建模角度看,只有这些常量的某些赋值会产生效果。例如,对于源为 processor 或 queue 的 stream,中断方法会被忽略,因为这些模块在发送数据包时会主动设定自己的中断方法偏好。此外,statistic wire 的 quiet 中断方法也会被忽略(正确的做法是禁用所有触发)。
表 144:中断方法符号常量
OPC_INTRPT_METHOD_FORCEDOPC_INTRPT_METHOD_QUIETOPC_INTRPT_METHOD_SCHED
下面列出的触发(trigger)符号常量用于指定统计线上启用了哪些触发标志。这些常量可赋给节点模型中 statistics wire 对象的 trigger 属性。由于任何触发组合都是可能的,每个常量的取值都支持对常量进行逻辑“OR”运算,以派生可赋给属性的复合值。该技术的示例见图 10。注意,如果启用了 OPC_TRIG_HIGH_THRESH 或 OPC_TRIG_LOW_THRESH 标志,应为统计线对象属性 high thresh 或 low thresh 赋适当的值。
表 145:统计线触发符号常量
OPC_TRIG_FALLING_EDGEOPC_TRIG_HIGH_THRESHOPC_TRIG_LOW_THRESHOPC_TRIG_REPEATOPC_TRIG_RISING_EDGEOPC_TRIG_ZERO_CROSSING
图 10:统计线触发属性赋值示例
Ema_Object_Attr_Set (mid, obid, "trigger", COMP_CONTENTS,
OPC_TRIG_RISING_EDGE
OPC_TRIG_FALLING_EDGE
OPC_TRIG_REPEAT, EMAC_EOL);
下面列出的数据包字段类型(packet field type)符号常量用于指定数据包格式中字段的类型。这些常量可赋给数据包格式模型中 field 对象的 type 属性。
表 146:数据包字段类型符号常量
OPC_PKF_TYPE_FLOATING POINTOPC_PKF_TYPE_INFOOPC_PKF_TYPE_INTEGEROPC_PKF_TYPE_PACKETOPC_PKF_TYPE_STRUCT
下面列出的数据包编码属性(packet encoding attribute)符号常量用于指定数据包格式内的编码。这些常量可赋给数据包格式模型中 field 对象的 encoding 属性。
表 147:数据包编码属性符号常量
OPC_PKF_ENCODING_BIGEOPC_PKF_ENCODING_LITTLEEOPC_PKF_ENCODING_SIGNED_BIGEOPC_PKF_ENCODING_SIGNED_LITTLEEOPC_PKF_ENCODING_UNSIGNED_BIGEOPC_PKF_ENCODING_UNSIGNED_LITTLEE
下面列出的 ICI 属性类型符号常量用于指定 ICI 内属性的类型。这些常量可赋给 ICI 格式模型中 attribute descriptor 对象的 type 属性。
表 148:ICI 属性类型符号常量
OPC_ICA_TYPE_DOUBLEOPC_ICA_TYPE_INTEGEROPC_ICA_TYPE_STRUCT
下面列出的制图线条类型(cartographic line type)符号常量用于指定制图数据集中的线条所表示的内容。这些常量可赋给制图数据集中 line 对象的 type 属性。支持四种线条类型:国界;海岸、岛屿或湖泊;河流;以及内部边界。
表 149:制图线条类型符号常量
OPC_CDS_LINE_TYPE_COASTOPC_CDS_LINE_TYPE_IBOUNDOPC_CDS_LINE_TYPE_NBOUNDOPC_CDS_LINE_TYPE_RIVER
下面列出的文本大小(text size)符号常量用于指定制图数据集中文本标签的大小。这些常量可赋给制图数据集中 cartographic 对象(通常用作标签或标记城市及其他地标)的 text size 属性。
表 150:文本大小符号常量
OPC_TEXT_SIZE_LARGEOPC_TEXT_SIZE_MEDIUMOPC_TEXT_SIZE_SMALL
下面列出的接口描述标志(interface description flags)符号常量用于指定接口描述的选项。这些常量可赋给 interface description 对象的 flags 属性。这些标志对应于进程、节点与链路模型的接口中符号映射对 limits、comments、默认值、单位与值限制的继承状态。
表 151:接口描述标志符号常量
OPC_ID_INHRT_COMMENTSOPC_ID_INHRT_DEFVALOPC_ID_INHRT_LIMSOPC_ID_INHRT_UNITSOPC_ID_INHRT_VAL_RESTRICT
下面列出的 properties 对象标志符号常量用于指定 properties 对象的选项。这些常量可赋给 properties 对象的 flags 属性,并且可以按位 OR 以使用多个常量。在节点与进程模型域中,这些标志对应 Edit Attributes 对话框的功能。LOWLIM 操作对应 From 值,HILIM 操作对应 To 值,DEFV_AUTOASSIGN 对应 Autoassign default value 复选框,SYM_VAL_RESTRICT 对应符号映射的 Allow other values 复选框。
表 152:properties 对象标志符号常量
EMAC_DEFV_AUTOASSGNEMAC_HILIM_EXCLUEMAC_HILIM_SETEMAC_LOWLIM_EXCLUEMAC_LOWLIM_SETEMAC_SYM_VAL_RESTRICT
下面列出的属性赋值操作(attribute assignment operation)符号常量用于指定属性赋值的操作类型。这些常量可赋给 attribute assignment 对象的 operation 属性。在模型域中,IGNORE 操作对应“promoted”赋值,SET 对应“set”,SUPPRESS 对应“hidden”。
表 153:属性赋值操作符号常量
OPC_AA_IGNOREOPC_AA_SETOPC_AA_SUPPRESS
下面列出的输出向量类型(output vector type)符号常量用于指定输出向量是否为枚举型。这些常量赋给输出向量对象的 type 属性。如果 type 被赋值为 OPC_OV_TYPE_VECTOR_ENUM,则必须在 enum dictionary 属性中指定输出向量字典文件。
表 154:输出向量类型符号常量
OPC_OV_TYPE_VECTOR_DOUBLEOPC_OV_TYPE_VECTOR_ENUM
下面列出的输出向量子元素类型(output vector subelement type)符号常量用于指定输出向量的子元素选项。这些常量可赋给输出向量对象的 type 属性。类型为 OBJ_OV_VECTOR 的对象的 type 值必须是 VECTOR_DOUBLE 或 ENUM。所有其他取值只能与 OBJ_OV_ELEMENT 对象一起使用。
表 155:输出向量子元素类型符号常量
OPC_OV_TYPE_OBJECTOPC_OV_TYPE_STAT_GROUPOPC_OV_TYPE_STATISTICOPC_OV_TYPE_TOP_ELEMENTOPC_OV_TYPE_VECTOR_DOUBLEOPC_OV_TYPE_VECTOR_ENUM
下面列出的输出向量绘制样式(output vector drawing style)符号常量用于指定输出向量的绘制样式选项。这些常量可赋给输出向量对象的 drawing style 属性。
表 156:输出向量绘制样式符号常量
OPC_OV_DRAW_STYLE_BAROPC_OV_DRAW_STYLE_DISCRETEOPC_OV_DRAW_STYLE_LINEAROPC_OV_DRAW_STYLE_NONEOPC_OV_DRAW_STYLE_SAMPHOLDOPC_OV_DRAW_STYLE_SQR_WAVE
下面列出的输出向量阈值模式(output vector threshold mode)符号常量用于指定输出向量的阈值模式选项。这些常量可赋给输出向量对象的 threshold mode 属性。
表 157:输出向量阈值模式符号常量
OPC_OV_THRESHOLD_MODE_GEOPC_OV_THRESHOLD_MODE_GTOPC_OV_THRESHOLD_MODE_LEOPC_OV_THRESHOLD_MODE_LTOPC_OV_THRESHOLD_MODE_NONE
下面列出的输出向量时间单位(output vector time unit)符号常量用于指定输出向量的时间单位选项。这些常量可赋给输出向量对象的 time unit 属性。
表 158:输出向量时间单位符号常量
OPC_OV_TIME_UNITS_GENERICOPC_OV_TIME_UNITS_MONTHSOPC_OV_TIME_UNITS_SECONDS
下面列出的自描述比较器(self description comparator)符号常量用于指定必需自描述的比较器值。这些常量可赋给 required self description 对象的 comparator 属性。支持五种类型:equals、one of、range、contains 和 count。
表 159:自描述比较器符号常量
OPC_SELFDESC_CMP_CONTAINSOPC_SELFDESC_CMP_COUNTOPC_SELFDESC_CMP_EQUALSOPC_SELFDESC_CMP_ONEOFOPC_SELFDESC_CMP_RANGE
下面列出的自描述赋值类型(self description assignment type)符号常量用于指定已赋值自描述的类型值。这些常量可赋给 assigned self description 对象的 type 属性。支持三种类型:constant、characteristic 和 value。
表 160:自描述赋值类型符号常量
OPC_SELFDESC_ASSGN_CHARACTERISTICOPC_SELFDESC_ASSGN_CONSTOPC_SELFDESC_ASSGN_VALUE
下面列出的工程流量增长时间单位(project traffic growth time unit)符号常量用于指定流量增长数据的时间单位。这些常量可赋给 long term study (traffic growth) 对象的 time units 属性。
表 161:工程流量增长时间单位符号常量
OPC_PJ_TIME_UNITS_DAYSOPC_PJ_TIME_UNITS_HOURSOPC_PJ_TIME_UNITS_MINUTESOPC_PJ_TIME_UNITS_MONTHSOPC_PJ_TIME_UNITS_SECONDSOPC_PJ_TIME_UNITS_WEEKSOPC_PJ_TIME_UNITS_YEARS
下面列出的工程流量增长结果存储方式符号常量用于指定存储流量增长数据的方法。这些常量可赋给 long term study (traffic growth) 对象的 result storage method 属性。
表 162:工程流量增长结果存储方式符号常量
OPC_PJ_RESULT_STORE_EACH_SIMULATIONOPC_PJ_RESULT_STORE_SUMMARY_ONLY
下面列出的工程流量增长导入选项符号常量用于指定在 long term study 期间要导入的内容。这些常量可赋给 long term study (traffic growth) 对象的 import options 属性。
表 163:工程流量增长导入选项符号常量
OPC_PJ_IMPORT_NETWORK_AND_TRAFFICOPC_PJ_IMPORT_NOTHINGOPC_PJ_IMPORT_TRAFFIC
下面列出的工程流量增长方法符号常量用于指定计算流量增长的方法。这些常量可赋给 long term study (traffic growth) 对象的 growth method 属性。
表 164:工程流量增长方法符号常量
OPC_PJ_GROWTH_COMPOUND_BY_TABLEOPC_PJ_GROWTH_REGULAR_COMPOUNDOPC_PJ_GROWTH_REGULAR_SIMPLEOPC_PJ_GROWTH_SIMPLE_BY_TABLE
下面列出的外部系统接口类型符号常量用于指定赋给外部系统接口的数据类型。这些常量可赋给 esys interface 对象的 type 属性。
表 165:外部系统接口类型符号常量
OPC_ESYS_TYPE_BITOPC_ESYS_TYPE_BOOLEANOPC_ESYS_TYPE_CHARACTEROPC_ESYS_TYPE_DOUBLEOPC_ESYS_TYPE_INTEGEROPC_ESYS_TYPE_POINTEROPC_ESYS_TYPE_STDLOGICOPC_ESYS_TYPE_STRINGOPC_ESYS_TYPE_UNDEFINED
下面列出的外部系统接口方向符号常量用于指定赋给外部系统接口的数据类型。这些常量可赋给 esys interface 对象的 direction 属性。
表 166:外部系统接口方向符号常量
OPC_ESYS_DIR_INOPC_ESYS_DIR_INOUTOPC_ESYS_DIR_NCOPC_ESYS_DIR_OUT