1、ICS 33 040M 11Y口中华人民共和国通信行业标准波分复用(WDM)系统网络管理接口技术要求第4部分：基于CORBAIDL的接口Technical Specification for Interface of WDM Network Management SystemPart 4：Interface based on CORBAlDL20070720发布 2007-1 2-01实施中华人民共和国信息产业部发布目 次前言1范围12规范性引用文件13术语、定义和缩略语14接口规范241配置管理“242故障管理8943性能管理9444通用管理11145公共管理119附录A(规范性附录)性能文
2、件格式定义134刖 吾YD厂r 1 3504-2007波分复用(wDM)系统网络管理接口技术要求分为4个部分：第1部分：接口功能；第2部分：通用信息模型部分；第3部分：基于GDMOCMIP的信息模型部分；第4部分：基于CORBAIDL的接口。本部分对应于TMFSl4(2003)Multi-Technology Network Management Solution Set DocumentNMLEML Interface Version 30，与TMFSl4的一致性程度为非等效。本部分附录A为规范性附录。本部分由中国通信标准化协会提出并归口。本部分起草单位：中兴通讯股份有限公司、中国移动通信集
3、团公司本部分主要起草人：年庆飞、张建强、陈捷、明正勤YD厂r 1 3504-2007波分复用(WDM)系统网络管理接口技术要求第4部分：基于CORBAIDL的接口1范围本部分规定了wDM网管系统EMSNMS之间基于CORBA IDL的接口规范，包括配置管理、故障管理、性能管理、通用管理、公共管理等内容。本部分适用于WDM网元管理系统(EMS)与WDM网络管理系统(NMs)之间的接口。2规范性引用文件下列文件中的条款通过本部分的引用而成为本部分的条款。凡是注日期的引用文件，其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本部分。然而，鼓励根据本部分达成协议的各方研究是否可使用这些文件的最
4、新版本。凡是不注日期的引用文件，其最新版本适用于本部分。YDT 13832005 波分复用(WDM)网元管理系统技术要求YDfr 13501-2005 波分复用(WDM)系统网络管理接口技术要求第1部分：接口功能部分YDgr 13502-2005 波分复用(WDM)系统网络管理接口技术要求第2部分：通用信息模型部分TMF513(2003) Multi-TechnologyNetworkManagementBusinessAgreementNMLDmInterface Version 3 0TMF814(2003)1MF814A(2003)Multi-Technology Network Man
5、agement Information Agreement NM巴-日LInterface Version 30Multi-Technology Network Management Solution Set Document NML-EMLInterface Version 301M FoRUM M曰心d Implementation Statement(IS)Template and GuidelinesNMLEM皿hlterface Version 303术语、定义和缩略语31术语和定义下列术语和定义适用于本部分。311 网络管理系统Network Management SystemNM
6、S指WDM传送网网络管理系统，即为了管理WDM传送网网络所使用的软硬件系统。网络管理系统提供全网的端到端网络视图，能够管理网络内由不同设备供应商提供的WDM网元或WDM子网。312网元管理系统Element Management SystemEMS指WDM传送网网元管理系统，即为了管理一个或多个WDM网元所使用的软硬件系统。网元管理系统管理由单一设备供应商提供的WDM网元或WDM子网。注：本部分中的网元管理系统是传统意义上的网元管理系统和子网管理系统(SNMS)的统称。32缩略语下列缩略语适用于本部分：YD厂r 1 3504-2007CORBA Common Object Request Br
7、oker Architecture 公共对象请求代理结构CTP Connection Termination Point 连接终端点EMS Element Management System 网元管理系统FIP File Transfer Protocol 文件传送输】协议F1甲 Floating Termination Point 浮动终端点NMS Network Management System 网络管理系统OCH Optical Channel 光通路(光通道)OMO Object Management Group 对象管理组织OMS Optical Multiplex Section
8、 光复用段OTS Optical Transmission Section 光传送段(光放大段)PTP Physical Termination Point 物理终端点TP TorminationPoint 终端点TCA Threshold Crossed Alex 越门限告警UTC Universal Coordinated Time 协调世界时WDM Wavelength Division Multiplexing 波分复用4接口规范41配置管理411 EMS管理模块(module emsMgr)EMS_T定义structEMS Tfglobaldefs：NamingAttributes_
9、T name；string uscrLabel；string nativeEMSName；string owner；string emsVersion；string type；globaldefs：NVSList_T additionallnfo；说明表示EMS信息。属性描述globaldefs：NamingAttributes_T name表示EMS名称，是一个厂家内EMS的惟一名称。string userLabel表示EMS友好名称，缺省是厂家给出的EMS名称。2string nadveEMSNalnc表示EMS的本地名称。string owner表示EMS的所有者。string emsV
10、ersion表示EMS的软件版本。string type表示EMS类型，包括“EMS”、“SNMS”、“EMSSNMS”。globaldefs：NVSList_T additionalInfo表示附加信息，取值见下表名称 取值 说明“A1armStatus” “Indeterminate”表示未确定； 告警状态，取当前的最高(严重)告警级别“Critical”袭示严重：“Major表示主要；“Minor”表示次要；“Warning”表示警告；“Cleared”表示清除“OpemtionStatus” “Available表示可用： 操作状态“UnAvailable”：表示不可用“Locatio
11、n” EMS所在的地理位置 位置信息(精确到机房)EMSMgrI接口说明本接口为EMS管理接口，提供对EMS相关信息的管理，本接口继承公共管理部分的Common_I接口。查询EMS信息(getEMS)定义void getEMS(out EMS_T emsInfo)raises(globaldefs：ProcessingFailureException)说明用于NMS向EMS查询EMS信息。输入参数无。输出参数3YD厂r 1 3504-2007out EMS_T emsInf0表示EMS信息。返回值无。异常内部处理错误(EXCPT_INTERNAL_ERROR)。查询所有首层拓扑连接(getAl
12、lTopLevelTopologicalLlnks)定义void getAllTopLevelTopologicalLinks(in unsigned long how_many，out topologicalLink：TopologicaiLinkList_T topoList，out topologicaiLink：TopologicalLinkIterator_I topolt)raises(globaldefs：ProcessingFailureException)；说明用于NMs EMS查询所有首层拓扑连接，这里的首层拓扑连接指EMs管理的子网间的拓扑连接。输入参数in unsign
13、ed long how_many表示迭代查询数据方式下首次查询的数目。输出参数out topologicaiLink：TopologicalLinkList-T topoList表示首次查询返回的拓扑连接列表。out topologicalLink：TopologicaiLinldterator-I topolt表示迭代查询拓扑连接接口。返回值无。异常(1)未实现此操作(EXCPT_NOT_IMPLEMENTED)。(2)内部处理错误(EXCPT_INTERNAL_ERROR)。查询所有首层拓扑连接名称(getAIITopLevelTopologicalLinkNames)定义void get
14、AllTopLevelTopologicalLinkNames(in unsigned long,how_many，out globaldefs：NamingAttributesList_T nameList，4out globaldefs：NamingAth-ibutesIterator_I namer)raises(globaidefs：ProcessingFailureException)；说明用于NMS从EMS查询所有首层拓扑连接的名称。输入参数in unsigned long how_many表示迭代查询数据方式下首次查询的数日。输出参数out globaldefs：NamingAt
15、tributesList_T nameList表示首层拓扑连接的名称列表。out globaidefs：NamingAttributeslterator_I namelt表示迭代查询名称接口。返回值无。异常(1)未实现此操作(EXCPT_NOT_IMPLEMENTED)。(2)内部处理错误(EXCPT_INTERNAL_ERROR)。查询首层拓扑连接(getTopLevelTopologiealLink)定义void geflopLevelTopolo茸【calLink(in globaldefs：NamingAttributes_T name，out topologicalLink：Topo
16、logiealLink_T topoLink)raises(globaldefs：ProcessingFailureException)说明用于指定名称查询拓扑连接信息。输入参数in globaldefs：NamingAttributes T name表示拓扑连接名称。输出参数out topologicalLink：TopologicaiLink_T topoLink表示拓扑连接。返回值无。异常5YD厂r 1 3504-2007(1)未实现此操作(EXCPT NOT_IMPLEMENTED)。(2)内部处理错误(EXCPT_INTERNAL_ERROR)。查询所有当前告警(getAllEMSA
17、ndMEAetiveAlarms)定义void getAllEMSAndMEActiveAlarms(in notifications：ProbableCauseLisLT excludeProbCauseList，in notifications：PerceivedSeverityList T excludeSeverityList,in unsigned long how_many,out notifications：EventList_T cventList，out notificatlons：EventIterator_I evenflt)raises(globaldefs：Proce
18、ssingFailureException)：说明用于NMS从EMS查询所有当前告警(包括越门限告警)，包括所有网元以及EMS本身产生的告警。查询条件包括告警原因和告警级别。输入参数in notifications：PerceivedSeverityListT excludeseverityList表示被排除的告警级别，如果列表是空，表示不捧除。in notifications：ProbableCanseLisLT excludeProbCausvList表示被排除的告警原因，如果列表是空表示不排除。in unsigned long how_many表示迭代器第一次返回的数据数目。输出参数ou
19、t notifications：EventList_T eventList表示符合条件的当前告警列表。out notifications：EventIterator_I evenflt用于获得剩余查询数据的事件迭代器操作接口。返回值无。异常(1)内部处理错误(EXCPT_INTERNAL_ERROR)。(2)打开的迭代器数目过多(EXCPT_TOO_MANY OPEN 1TERATORS)。 查询所有首层子网(getAUTopLevelSubnetworks)定义void getAllTopLevelSubnetworks(6in unsigned long how_many,out mult
20、iLayerSubnetwork：SubnetworkList_T sLisLout mulfiLayerSubnetwork：SubnctworkItccator_I sit)raises(globaldefs：ProcessingFailumException)；说明用于查询EMS内的所有首层予网信息。首层子网指包含物理层且位于子网包含关系的最顶层的子网。输入参数in unsigned long how_many表示迭代器第一次返回的数据数目。输出参数out mulfiLayerSubnetwork：SubnctworkList_T sList表示首层子网列表。out multiLayer
21、Subnetwork：Subnetworkitexator_I sit表示迭代查询子网接口。返回值无。异常内部处理错误(EXCPT_INTERNAL_ERROR)。 查询所有首层子同名称(getAllTopLevelSubnetworkNames)定义void getAllTopLevelSubnetworkNames(in unsigned long how_many，out globaldefs：NamingAttributesList_T nameList，out globaldefs：NamingAttributesIterator_I namelt)raises(globaldefs
22、：ProcessingFailurcExccption)：说明用于查询EMS内的所有首层子网名称。输入参数in unsigned long how_many表示迭代器第一次返回的数据数目。输出参数out globaldefs：NamingAttributesList_T nameList表示首层子网名称列表。out globaldefs：NamingAttributeslterator_l nameIt表示迭代查询子网名称接口。7YD厂r 1 3504-2007返回值无。异常内部处理错误(EXCPT_INTERNAL_ERROR)。刨建告警级别表(createASAP)定义void creat
23、eASAP(in aSAP：ASAPCreateModifyData_T newASAPCreateData，out aSAP：ASAP_T newASAP,out globaldefs：NVSList T additionalInfo)raises(globaldefs：ProcessingFailureExeeption)；说明用于创建告警级别表。输入参数in aSAP：ASAPCreateModifyData_T newASAPCreateDam表示告警级别表创建数据。输出参数out aSAP：ASAP_T newASAP表示创建成功的告警级别表。out globaldefs：NVSLi
24、st_T additionailnfo表示附加信息。返回值无。异常(1)内部处理错误(EXCPT_INTERNAL_ERROR)。(2)无效的输入(EXCPT_INVALID_INPUT)。(3)友好名称已存在(EXCPT_USERLABEL_IN_USE)。(4)未实现此操作(EXCPT_NOT_IMPLEMENTED)。删除告警级别表(deleteASAP)定义void deleteASAP(in globaidefs：NamingAttributes_T aSAPName,，out globaldefs：NVSList_T additionailnfo)raises(globaldefs
25、：ProcessingFailureException)说明8用于删除告警级别表。输入参数in globaldefs：NamingAttributes_T aSAPName表示告警级别表名称。输出参数inout globaldefs：NVSList_T addifionallnfo表示附加信息。返回值无。异常(1)内部处理错误(EXCPT_INTERNAL_ERROR)。(2)无效的输入(EXCPT_INVALID_INPUT)。(3)实体未找到(EXCPT_ENTITY_NOT_FOUND)。(4)未实现此操作(EXCPT_NOT_IMPLEMENTED)。分配告警级别表(assignASA
26、P)(可选)定义void assignASAP(in globaldefs：NamingAttdbutes_T aSAPName，in globaldefs：NamingAttributes_T rcsourceNamc，in transmissionParameters：LayerRate_T layerRate，inout globaldefs：NVSListT addifionalInfo)raises(globaldefs：ProeessingFailureExeeption)；说明用于分配告警级别表。输入参数in globaldefs：NamingAttdbutes_T aSAPNa
27、me表示告警级别表名称。in globaldefs：NamingAttributes_T resouleeName表示告警级别表分配到的资源名称，这里为终端点名称。in transmissionParameters：LayerRate_T layerRate表示告警级别表分配到的资源层速率。inout globaldefs：NVSLisLT additionalInfo表示附加信息。输出参数out globaldefs：NVSList_T additionallnfo表示附加信息。9YD厂r 1 3504_-21007返回值无。异常(1)内部处理错误(EXCPT_INTERNAL_ERROR)
28、。(2)无效的输入(EXCPT_INVALID_INPUT)。(3)未实现此操作(EXCPT_NOT_IMPLEMENTED)。 解除告警级别表分配(deassignASAP)(可选)定义void deassignASAP(in globaldefs：NamingAttributes_T resourceName。in IransmissionParameters：LayerRate_T layerRate。inout globaldefs：NVSList_T additionalInfo)raises(globaldefs：ProcessingFailureF-,xeeption)；说明用于
29、解除告警级别表分配。输入参数in globaldefs：NamingAttributes_T aSAPName表示告警级别表名称。in globaldefs：NamingAttributes_T rcsourceName表示告警级别表分配到的资源名称，这里为终端点名称。in transmissionParameters：LayerRate_T layerRate表示告警级别表分配到的资源层速率。inout globaldefs：NVSListS additionalInfo表示附加信息。输出参数out globaldefs：NVSListT additionalInfo表示附加信息。返回值无。
30、异常(1)内部处理错误(EXCPT_INTERNAL_ERROR)。(2)无效的输入(EXCPT_INVALID_INPUT)。(3)未实现此操作(EXCPT斑)T_IMPLEMENTED)。获取所有告警级别表(getAIIASAPs)定义10YD厂r 13504-2007void getAIlASAPs(in unsigned long how_many，out aSAP：ASAPList_T aSAPList，out aSAP：ASAPIterator_I asapIt)raises(globaldefs：ProcessingFailureException)；说明用于获取EMS内所有告警
31、级别表。输入参数in unsigned long how_many表示返回数据的最大数目。输出参数out aSAP：ASAPList_T aSAPList表示告警级别表列表。out aSAP：ASAPIterator_I asaplt表示迭代获取告警级别表接口。返回值无。异常(1)内部处理错误(EXCPT INTERNAL_ERROR)。(2)打开的迭代器数目过多(EXCPT TOO MANY_OPEN_ITERATORS)。(3)未实现此操作(EXCPT_NOT_IMPLEMENTED)。 获取所有告警级别表名称(getAIIASAPNames)定义void getAllASAPNames(
32、in unsigned long how_many，out globaldefs：NamingAttributesList_T nameList，out globaldefs：NamingAttributesIterator_I namelt)raises(globaldefs：ProcessingFailureException)；说明用于获取EMS内所有告警级别表名称。输入参数in unsigned long how_many表示返回数据的最大数目。输出参数out globaldefs：NamingAttributesList_T nameList t表示告警级别表列表。YD厂r 1 35
33、04-2007out globaldefs：NamingAttributesIterator_I namelt表示迭代获取告警级别表名称接121。返回值无。异常(1)内部处理错误(EXCPT_INTERNAL_ERROR)(2)打开的迭代器数目过多(EXCPT_TOO_MANY_OPEN_HF-RATORS)。(3)未实现此操作(EXCPT_NOT_IMPLEMENTED)。获取告警级别表(getASAP)定义void getASAP(in globaldefs：NamingAttributcs_T aSAPName，out aSAP：ASAP_T aSAP)raises(globaldefs
34、：ProeessingFailureExeeption)；说明用于指定名称获取告警级别表。输入参数in globaldefs：NamingAttributes_T aSAPName表示告警级别表名称。输出参数out aSAP：ASAP_T aSAP最示告警级别表。返回值无。异常(1)内部处理错误(EXCPT_INTERNAL_ERROR)。(2)打开的迭代器数目过多(EXCPT_TOO_MANY_OPEN HERATORS)(3)未实现此操作(EXCPT_NOT_IMPLEMENTED)。412拓扑连接模块(module lopoIogicaILInk)TopologicalLink_T定义s
35、truct TopologicalLink T(globaldefs：NamingAttributes_T name；string userLabel；12string nativeEMSName；string owner；globaldefs：CormectionDirection-T direction；transmissionParameters：LayerRate_T rate；globaldefs：NamingAttributes_T aEndTP；globaldefs：NamingAttributes_T zEndTP；globaldefs：NVSLisLT additionalI
36、nfo；)；说明表示拓扑连接信息。属性描述globaldefs：NamingAttributes_T name表示拓扑连接名称。string userLabel表示拓扑连接的友好名称。string nativeEMSNme表示拓扑连接在EMS的本地名称。suing owner表示拓扑连接的所有者。globaldefs：ConnectionDirection_T direction表示拓扑连接的方向。transmissionParameters：LayerRate_T rate表示拓扑连接的层速率。globaldefs：NamingAttributes_T aEndTP表示拓扑连接的A端点。gl
37、obaldefs：Naming&ttributes_T zEndTP表示拓扑连接的z端点。globaldefs：NVSList_T additionalInfo表示附加信息。TopologicalLinkLlst_T定义typedef sequenceTopologicalLinkList_T；说明表示拓扑连接列表。TopologicalLinkIterator_I接口13YD厂r 13504-2007说明表示迭代查询拓扑连接接口。 查询下一批拓扑连接数据(next_n)定义boolean next_n(in unsigned long how_many,out TopologicalLink
38、List_T topoLinkList)raises(globaldefs：ProcessingFailureExeeption)；说明通过迭代器查询下一批拓扑连接数据。输入参数in unsigned long how_many表示返回数据的最大数目。输出参数out TopologicalLinkList_T topoLinkList表示查询得到的拓扑连接列表。返回值boolean表示操作结果，为真表示操作成功，为假表示操作失败。异常内部处理错误(EXCPT_INTERNAL_ERROR)。查询迭代器数据数日(getLength)定义unsigned long getLength()raise
39、s(globaldefs：ProeessingFailureException)说明用于查询迭代器中剩余数据的数目。输入参数无。输出参数无。返回值unsigned long表示数据数目。异常14内部处理错误(EXCPT_INTERNAL_ERROR)。删除选代器(destroy)定义voiddesUoy()raises(globaldefs：ProcessingFailureException)说明用于删除迭代器。输入参数无。输出参数无。返回值无。异常内部处理错误(EXCPT_INIERNALERROR)。413网元模块(module managedElement)CommunicationS
40、tate_T定义enm CommumcationSmte_T【CS_AVAILABLE,CS UNAVAILABLEl；说明表示EMS与网元之间的通讯状态。属性描述CS AVAILABLE表示通讯正常。CS_UNAVAK,ABLE表示通讯失效。ManagedElement_T定义sUuct ManagedElement_T(YD厂r 1 3504-27globaldefs：NamingAttributes_T name；string userLabel；string nativeEMSName；siring owner；string location；string version；string
41、 productName；CommunicationState_T communicationState；boolean emsInSyncState；transmissionParameters：LayerRateList_T supportedRates；globaldefs：NVSList_T additionallnfo；说明表示EMS的一个基本管理单位，即网元。属性描述globaldcfs：NamingAttributes_T name表示网元名称。siring userLabel表示网元友好名称。string nativeEMSName表示网元在EMS本地的名称。string ow
42、ner表示网元的所有者名称。string location表示网元所在的物理位置。string version表示网元的版本。string productName表示网元的产品名称，厂家对这个产品的命名。CommunieationState T communicafionSmte表示网元的连接状态，即EMS与网元的连接状态。boolean emsInSyncStam表示EMS是否能够保持EMS数据与网元数据是同步的，并且能够发送所有适当的通知。当EMS将此属性设置为假时，表示EMS需要与网元进行数据同步并且不能产生适当的通知(如对象创建、删除、属性改变通知)：当EMS将此属性设置回到宾表示数据
43、重新同步结束同时通知可以在适当的时候产生。transmissionParameters：LayerRateList_T supportedRates16YD厂r 1350斗_2007表示网元支持的交叉连接速率。globaldofs：NVSListT addifionslInfo表示附加信息，包括告警状态、操作状态、位置信息，参见EMS3的定义。ManagedEiementList_T定义typedef sequenceManagedElementList_T；说明表示网元信息列表。ManagedElementlterator_l接口说明表示迭代查询网元接口。查询下一批两元数据(next_n)定
44、义boolean next_n(in unsigoed long how_many,out ManagedElementlAstT meList)raises(globaldefs：ProccssingFvJlumExccpfion)；说明通过迭代器查询下一批网元数据。输入参数in unsigned long how_many表示返回数据的最大数目。输出参数out ManagedElementListJ meList表示查询得到的网元列表。返回值boolean表示操作结果，为真表示操作成功，为假表示操作失败。异常内部处理错误(EXCPT_INTERNALERROR)。查询迭代器数据数日(get
45、Length)定义17YD厂r 13504_2007unsigned long getLength()raises(globaldefs：ProeessingFailureException)说明用于查询迭代器中剩余数据的数目。输入参数无。输出参数无。返回值unsigned long表示数据数目。异常内部处理错误(EXCPT_INTERNAL_ERROR)。删除迭代器(destroy)定义voiddestroy()raises(globaldefs：ProcessingFailureException)说明用于删除迭代器。输入参数无。输出参数无。返回值无。异常内部处理错误(EXCPT INTE
46、RNAL_ERROR)。414 网元管理模块(module managed日ementManager)ManagedElementMgr_I接口说明网元管理接口，用于查询和修改网元信息，本接口继承公共管理部分的Common_I接口。查询所有网元信息(getAllManagedElements)定义void getAllManagedElements(18in unsigned long how_many,out managedElement：ManagedElemcntList_T meList,out managedElement：ManagedElementlteratorI meh)raises(globaldefs：ProceasingFaiinrcExpfion)；说明用于NMS从EMS查询所有网元。输入参数in unsigned long how_many表示首次迭代查询的数目。输出参数out managedElement：ManagedElementLisLT meJAst_表示网元信息列表。out managedElement：ManngcdElementItcrator_I mcIt表示迭代查询网元接口。返回值无。异常内部处理错误(EXCPT_INTERNAL ERROR)。查询所有网元名称(getAIIMann
