DA北向接口软件技术手册V310完整版.doc

北向接口 软件技术手册 UniView(DA V1.00 800－810－9292  目 录 软件技术手册 1 UniView(DA 1 1 概述 1 2 功能说明和使用方法 1 2.1 开发工具 1 2.2 初始化客户端连接 1 2.2.1 注册命名服务 1 2.2.2 注册通知服务 1 2.3 获取命名服务对象 1 2.4 获取EMSSessionFactory会话 2 2.5 注册并得到EMSSession会话 2 2.6 获取EMS版本信息 2 2.7 获得事件通道 3 2.8 告警管理 3 2.8.1 告警信息定义 3 2.8.2 objectName说明 4 2.8.3 获取EMS上所有当前告警信息 7 2.8.4 获取EMS上指定网元（指定网元的IP地址信息）的所有当前告警信息 7 概述 为使由UniView(DA网管平台所管理维护的设备能与上层网管进行交互、通信，我司提供北向接口软件。上层网管开发人员可依据该手册对北向接口软件进行二次开发，以达到将设备纳入到综合网管平台进行统一管理的目的。 该北向接口软件采用可靠、高效、已成为业内流行趋势的CORBA通信协议，并参照814规范（“814规范”即为《Multi-Technology Network Management Solution Set Document NML-EML Interface Version 2.1》 TMF 814（2002））。以保证接口的通用性、规范性，保证管理系统与被管系统的互连互通。 北向接口软件支持与多个上层网管系统并行交互的能力。 下面详细说明北向接口软件支持的功能及使用方法。 功能说明和使用方法 开发工具 CORBA客户端开发工具为：JacORB2.2.2。 初始化客户端连接 注册命名服务 根据EMS名字（IP地址）创建命名上下文，然后将此命名上下文绑定在所有命名服务器上的命名服务上，实现对其名字的注册 注册通知服务 完成对命名服务的注册，然后创建通道并进行对通知通道的注册 获取命名服务对象 该软件中命名上下文定义如下： <Class>TMF_MTNM</Class> <Vendor>GWTT</Vendor> <EMSInstance>Uniview DA</EMSInstance> <Version>1_1</Version> <EMS>属性为UniView DA网管的安装IP地址</EMS> 命名树结构如下图： 获取EMSSessionFactory会话 通过窄化编译emsSessionFactory.idl得到的EmsSessionFactory_IHelper.java的narrow方法得到EMSSessionFactory 注册并得到EMSSession会话 实现IDL中方法为： IDL：emsSessionFactory.idl Interface：emsSessionFactory::EmsSessionFactory_I 方法：void getEmsSession( in string user, in string password, in nmsSession::NmsSession_I client, out emsSession::EmsSession_I emsSessionInterface) raises(globaldefs::ProcessingFailureException); 获取EMS版本信息 实现IDL中方法为： IDL：emsMgr.idl Interface：emsMgr::EMSMgr_I 方法：void getEMS(out EMS_T emsInfo) raises(globaldefs::ProcessingFailureException); 获得事件通道 实现IDL中方法为： IDL：emsSession.idl Interface：emsSession::EmsSession_I 方法：void getEventChannel( out CosNotifyChannelAdmin::EventChannel eventChannel) raises(globaldefs::ProcessingFailureException); 告警管理 告警信息定义 属性名 类型 设备是否支持 "notificationId" string 是 "objectName" globaldefs::NamingAttributes_T 是，具体定义见下节 "nativeEMSName" string 是 "nativeProbableCause" string 是 "objectType" notifications::ObjectType_T