2ghz数字蜂窝移动通信网网络管理通用技术要求+第3部分+接口分析.pdf

中华人民共禾口 y 口 国通信行业标准 y d 厂r1 5 8 4 1 2 0 0 7 y d ，t15 8 4 2 2 0 0 7 y d 厂r15 8 4 3 2 0 0 7 y d 厂r15 8 4 4 2 0 0 7 2 g h z 数字蜂窝移动通信网 网络管理通用技术要求 2 0 0 7 0 5 1 6 发布 ( 第1 部分至第4 部分 2 0 0 7 0 5 16 实施 中华人民共和国信息产业部发布 y 口 中华人民共和国通信行业标准 y d 厂r15 8 4 3 2 0 0 7 2 g h z 数字蜂窝移动通信网 网络管理通用技术要求 第3 部分接口分析 t e c h n i c a ls p e c i f i c a t i o nf o r2 g h zd i g i t a lc e l l u l a rm o b i l e c o m m u n i c a t i o n sn e t w o r km a n a g e m e n tg e n e r a l p a r t3in t e r f a c ea n a l y s i s 2 0 0 7 0 5 16 发布2 0 0 7 0 5 1 6 实施 中华人民共和国信息产业部发布 目次 y d 厂r15 8 4 3 2 0 0 7 前言一 1 范围- - - - - 1 2 规范性引用文件1 3 缩略语1 4 公共管理接口分析- 1 4 1 公共控制对象类分析1 4 2 访问人口点接口分析4 4 3 通知管理接口分析7 4 4 链路监视功能接口分析1 4 4 5 通知日志管理接口分析1 8 4 6 文件传输功能接口分析1 8 5 配置管理接口分析2 0 5 1 公共配置管理接口分析2 0 5 2 基本配置管理接口分析“2 4 5 3 配置信息同步功能3 1 6 故障管理接口分析3 l 6 1 管理对象类图3 l 6 2 管理对象类分析一3 1 7 性能管理接口分析4 4 7 1 性能采集管理接口分析4 4 7 2 性能门限管理功能5 1 附录a ( 资料性附录) 版本表示方法5 7 附录b ( 资料性附录) f i l t e r 的约束建议”5 8 附录c ( 资料性附录) 文件命名规则一6 3 附录d ( 规范性附录) 管理对象实例的命名规则“6 5 附录e ( 规范性附录) 告警可能原因( p r o b a b l e c a u s e ) 列表6 8 附录f ( 规范性附录) 文件格式的s c h e m a 定义7 9 附录g ( 规范性附录) 采集活动的状态定义8 0 参考文献8 6 y d 厂r15 8 4 3 2 0 0 7 刖吾 本标准是2 g h z 数字蜂窝移动通信网网络管理技术要求系列标准之一。该系列标准的预计结构为： 系列标准由四项标准组成，各项标准又分为多个部分标准。该系列标准和部分标准的名称预计如下： 1 2 g h z 数字蜂窝移动通信网网络管理通用技术要求通用部分基本原则 2 2 g h z 数字蜂窝移动通信网网络管理通用技术要求通用部分接e l 功能 3 2 g h z 数字蜂窝移动通信网网络管理通用技术要求通用部分接口分析 4 2 g h z 数字蜂窝移动通信网网络管理通用技术要求通用部分基于c o r b a 技术的管理接口设计 5 2 g h zw c d m a 数字蜂窝移动通信网网络管理技术要求( 第一阶段)第1 部分配置网络资源模型 6 2 g h zw c d m a 数字蜂窝移动通信网网络管理技术要求( 第一阶段)第2 部分性能网络资源模型 7 2 g h zw c d m a 数字蜂窝移动通信网网络管理技术要求( 第一阶段)第3 部分基于c o r b a 技术的网络资源模型设计 8 2 g h zc d m a 2 0 0 0 数字蜂窝移动通信网网络管理技术要求( 第一阶段)第1 部分配置网络资源 模型 9 2 g h zc d m a 2 0 0 0 数字蜂窝移动通信网网络管理技术要求( 第一阶段)第2 部分性能网络资源 模型 1 0 2 g h zc d m a 2 0 0 0 数字蜂窝移动通信网网络管理技术要求( 第一阶段)第3 部分基于c o r b a 技术的网络资源模型设计 1 1 2 g h zt d s c d m a 数字蜂窝移动通信网网络管理技术要求( 第二阶段)第1 部分配置网络 资源模型 1 2 2 g h zt d s c d m a 数字蜂窝移动通信网网络管理技术要求( 第二阶段)第2 部分性能网络 资源模型 1 3 2 g h zt d s c d m a 数字蜂窝移动通信网网络管理技术要求( 第二阶段) 第3 部分基于c o r b a 技术的网络资源模型设计 本标准对应于第三代移动通信伙伴项目( 3 g p p ) 的以下t s3 2 系列标准和第三代移动通信伙伴项目 第二组( 3 g p p 2 ) 的以下标准： 1 3 g p p t s3 2 3 6 2 t e l e c o m m u n i c a t i o n m a n a g e m e n t ；e n t r y p o i n t 琢p ；i n f o r m a t i o ns e r v i c e ( 电信管理； 入口点集成参考点；分析部分) 2 3 g p p t s3 2 3 0 2 t e l e c o m m u n i c a t i o n m a n a g e m e n t ；c o n f i g u r a t i o n m a n a g e m e n t ；n o t i f i c a t i o n i n t e g r a t i o n r e f e r e n c ep o i n t ( i r p ) ：i n f o r m a t i o ns e r v i c e ( 电信管理；配置管理；通知集成参考点；分析部分) 3 3 g p pt s3 2 3 5 2t e l e c o m m u n i c a t i o nm a n a g e m e n t ；c o m m u n i c a t i o ns u r v e i l l a n c ei r p ；i n f o r m a t i o n s e r v i c e ( r e l e a s e6 ) ( 电信管理；链路监视集成参考点；分析部分) 4 3 g p p t s3 2 3 4 2 t e l e c o m m u n i c a t i o n m a n a g e m e n t ；f i l e t r a n s f e r 冲；i n f o r m a t i o ns e r v i c e ( 电信管理； 文件传输集成参考点；分析部分) 5 3 g p pt s3 2 3 1 2t e l e c o m m u n i c a t i o nm a n a g e m e n t ；g e n e r i ci n t e g r a t i o nr e f e r e n c ep o m t ( i r p ) i i y d 几15 8 4 3 2 0 0 7 m a n a g e m e n t ；i n f o r m a t i o ns e r v i c e ( 电信管理；通用集成参考点；分析部分) 63 g p pt s3 2 6 0 2t e l e c o m m u n i c a t i o nm a n a g e m e n t ；b a s i cc mi n t e g r a f i o nr e f e r e n c ep o i n t ( i r p ) ： i n f o r m a t i o ns e r v i c e ( 电信管理；基本配置集成参考点；分析部分) 73 g p pt s3 2 6 6 2t e l e c o m m u n i c a t i o nm a n a g e m e n t ；k e r n e lc m i n t e g r a t i o nr e f e r e n c ep o i n t ( i r p ) ： i n f o r m a t i o ns e r v i c e ( 电信管理；公共配置集成参考点；分析部分) 83 g p p t s 3 2 3 1 1 - 2 t e l e c o m m u n i c a t i o n m a n a g e m e n t ；p a r t2 ：a l a r m i n t e g r a t i o n r e f e r e n c e p o i n t ( i r p ) ； i n f o r m a t i o ns e r v i c e ( 电信管理；告警集成参考点；分析部分) 9 3 g p pt s3 2 4 1 2t e l e c o m m u n i c a t i o nm a n a g e m e n t ；p e r f o r m a n c ei n m g r a t i o nr e f e r e n c ep o i n t ( i r p ) ； i n f o r m a t i o ns e r v i c e ( 电信管理；性能集成参考点；分析部分) 1 0 3 g p p t s3 2 3 0 0t e l e c o m m u n i c a t i o nm a n a g e m e n t ；c o n f i g u r a t i o nm a n a g e m e n t ；n a m ec o n v e n t i o nf o r m a n a g e do b j e c t s ( 电信管理；配置管理；管理对象命名) 1 1 3 g p p 2s s 0 0 2 8 一a ( v e r s i o n1 0 ) o a m & pf o rc d m a 2 0 0 0 ( 3 g p pr 4d e l t as p e c i f i c a t i o n ) ( c d m a 2 0 0 0 网络的操作、管理、维护和指配) 本标准与上述国际标准之间的主要差异为： 一细化了上述国际标准中各管理接口部分的操作和通知描述，完善参数定义； 一根据我国第三代移动通信网网络管理应用需求，要求访问人口点对象( e p i r p ) 应为p e r s i s t e n t 的c o r b a 对象； 一定义了中国2 g h z 数字蜂窝移动通信网网络管理技术要求系列文稿的版本格式和相应取值； 一增加告警可能原因的取值约定； 一规范了文件名称定义格式并示例； 一增加了过滤条件( f i l t e r ) 的明确定义，并且根据应用需求对其进行简化。 本标准与上述3 g p p 和3 g p p 2 相关标准的一致性程度为非等效。 本标准的附录a ，b ，c 为资料性附录，附录d ，e ，f 和g 为规范性附录。 本标准由中国通信标准化协会提出并归口。 本标准起草单位：北京邮电大学、中国移动通信集团公司、中国联合通信有限公司 本标准主要起草人：芮兰兰、李文璩、姚羿志、李冶文、高柏峰、王烨、王勇、王智立、王峰 i y d 厂r15 8 4 3 2 0 0 7 2 g h z 数字蜂窝移动通信网网络管理通用技术要求 第3 部分接口分析 1 范围 本标准规定 “ 2 g h z 数字蜂窝移动通信网( 以下简称3 g ) 网络管理接口中与网络技术无关的通用管理 部分的接口分析。 本标准适用于2 g h z 数字蜂窝移动通信网中w c d m a ，c d m a 2 0 0 0 和t d ，s c d m a 技术的网络管理。 2 规范性引用文件 下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的 修改单( 不包括勘误的内容) 或修订版均不适用于本标准。然而，鼓励根据本标准达成协议的各方研究 是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。 y d t1 5 8 4 1 2 0 0 7 2 g h z 数字蜂窝移动通信网网络管理通用技术要求第1 部分基本原则 y d t1 5 8 4 2 2 0 0 7 2 g h z 数字蜂窝移动通信网网络管理通用技术要求第2 部分接口功能 3 缩略语 下列缩略语适用于本标准。 d n d i s t i n g u i s h e dn a m e 可识别名 i r p i n t e g r a t e dr e f e r e n c ep o i n t集成参考点 r d nr e l a t i v ed i s t i n g u i s h e dn a m e 相对可识别名 4 公共管理接口分析 4 1 公共控制对象类分析 4 1 1 g e n e r i c l r p 对象类分析 g e n e f i c l r p 对象类代表了包含在i r p a g e n t ( 见下文4 1 3 节的定义) 下的管理域控制对象的信息，该 对象类不实例化，作为父类被继承，每个i r p a g e n t 至少应包含一个g e n e d c i r p 子类的实例。 4 1 1 1 属性描述 表1g e n e r i c l r p 属性 属性名中文名称说明 类型和取值说明限定 i i r p i di r p 对象标识符命名属性，即i r p 的r d n 值 字符串( 命名属性类型) m r 4 1 2 m a n a g e d g e n e r i c l r p 对象类分析 m a n a g e d g e n e f i c i r p 对象类定义了i r p 对象的通用操作，该对象类从g e n e r i c l r p 对象类继承而来 不实例化，仅作为父类被继承。 m a n a g e d g e n e d c l r p 中定义了如下3 个操作。 4 1 2 1 获取i r p 版本g e t l r p v e r s i o n ( m ) y d l15 8 4 3 2 0 0 7 行为 “n m s 调用该操作获取该 r p 所支持的版本信息。版本信息的表示建议参见本规范的附录a 。” 输入参数 无。 输出参数 v e r s i o n n u m b e r s e t “参数v e r s i o n n u m b e r s e t 表示该i r p 所支持的版本集合，取值为字符串的集合，版本的表示建议 见本规范的附录a 。” 前提条件 无。 后继条件 如果操作成功，贝l j r e s u l t = “s u c c e s s ” 如果操作失败，贝l j r e s u l t = “f a i l u r e ” 返回值 r e s u l t “返回值聆s u l t 标识操作的成功与否。” 异常 如果返回其他原因的异常，则应扔出异常：“g e t l r p v e r s i o n ”。 4 1 2 2 获取i r p 操作概述信息g e t o p e r a t i o n p r o f i l e ( o ) 行为 “n m s 调用该操作获取指定版本的嘶f 支持的操作信息。” 输人参数 i r p v e r s i o n “参数i r p v e r s i o n 指明要获取该版本的i r p 的操作信息。” 输出参数 o p e r a t i o n n a m e p r o f i l e “该参数表示该版本的啦对象支持的操作名称的集合。” o p e r a d o n p a r a m e t e r p r o f i l e 一一“该参数表示与该版本的i r p 所支持的操作名称相对应的操作参数集的集合。 o p e r a d o n n a m e p r o f i ! l e 与o p e r a t i o n p a r a m e t e r p r o m e 共- 同表达了该版本的啦所支持的操作及操作中所支持的 参数。” 前提条件 命题1 ：“给定的版本信息正确”。 后继条件 如果操作成功，贝y r e s u l t = “s l i c c e s s ” 如果操作失败，卿j r e s u l t = “f a i l u r e ” 返回值 2 y d t15 8 4 3 2 0 0 7 r e s u l t “返回值r e s u l t # v 示识操作的成功与否。” 异常 若命题1 不满足，则扔出异常“i n v a l i d p a r a m e t e r ”。 如果返回其他原因的异常，则应扔出异常：“g e t o p e r a t i o n p r o f i l e ”。 4 1 2 3 获取i r p 通知概述信息g e t n o t i f i c a t i o n p r o f i l e o ) 行为 “n m s 调用该操作获取指定版本的m p e j f 支持的通知的信息。” 输人参数 i r p v e r s i o n “该参数指明要获取该版本的i r p 的通知信息。” 输出参数 n o l i f i c a t i o n n a m e p r o f i l e “参数n o t i f i c a t i o n n a m e p r o f i l e 表示该版本的i r p 对象支持的通知名称集合。” n o f i f i c a f i o n p a r a m e t e r p r o f i l e “参数n 而f i c 撕o i l p a r a m e t e r p r o f i k 表示与该版本的啦所支持的通知名称相对应的通知参数集的 集合。n o t i f i c a t i o n n a m e p r o f i l e 与n 嘶f i c 撕0 n p a r a m e t e 删e 共同表达了该版本的啦所支持的通知及通知中 所支持的参数。” 前提条件 命题1 ：“给定的版本信息正确”。 后继条件 如果操作成功，贝l j r e s u l t = “s u c c e s s ” 如果操作失败，n r e s u l t = “f a i l u r e ” 返回值 r e s u l t “返回值r e s u l t 标识操作的成功与否。” 异常 若命题1 不满足，则扔出异常“i n v a l i d p a r a m e t e r ”。 如果返回其他原因的异常，则应扔出异常：“g e t n o t i f i c a t i o n p r o f i l e ”。 4 1 3i r p a g e n t 对象类分析 i r p a g e n t x t 象类是对e m s 所支持功能的封装，一个e m s 中可以实例化一个或多个i r p a g e n t 实例，一 个i r p a g e n t ：实例下可包含一个或多个管理域控制对象的实例。 4 1 3 1 属性描述 表2i r p a g e n t 的信息 属性名说明 取值说明限定 i r p a g e n t l di r p a g e n t 对象标识符，是命名属性，即l r p a g e m 的r d n 值 字符串( 命名属性类型)m r s y s t e m d n系统标识，即i r p a g e n t 的d n 值。d n 的命名规则见本规范的附录d字符串 c r 4 1 3 1 1 可发送的通知描述 y d 厂r15 8 4 3 2 0 0 7 表3 i r p a g e n t 可发送通知 中文名称 英文名称限定 对象创建通知 n o f i f y o b j e c t c r e a t i o n m 对象删除通知n o t i f y o b j e c t d e l e t i o nm 对象属性值改变通知 n o t i f y a t l y i b u t e v a l u e c h a n g e m 告警确认状态改变通知n o t i f 3 ，a c k s t a t e c h a n g e dm 变化的告警通知 n o t i f y c h a n g e d a l a r r n c 清除的告警通知n o t i f y c l e a r e d a l a r mm 新的告警通知n o d f 3 ，n e w a l a r l nm 增加说明通知 n o t i f y c o m m e n t s m 告警信息列表重建通知n o d f 3 ，a l a r m l i s t r e b u i l t m 潜在错误告警列表通知 n o t i f y p o t e n t i a l f a u l t y a l a r m l i s t o 4 2 访问入口点接口分析 4 2 1 概述 入口点对象是网管系统与被管系统交互的首要访问对象( 该功能主要针对c o r b a 建模) 。网管系统 通过人口点对象获取被管系统中管理域控制对象的引用( r e f e r e n c e ) ，并从而调用相关操作来执行特定 的管理功能。人e l 点对象将网管系统从需要存储大量被管对象的引用( r e f e r e n c e ) 的繁琐工作中解脱出 来。通过利用入口点对象，网管系统可以根据需要随时访问人口点对象获取指定的被管对象的引用 ( r e f e r e n c e ) 。为了增加管理的灵活性，在人口点对象中增加了版本协商机制，即网管系统首先获得被 管系统所支持的管理域控制对象的概述信息，然后网管系统选择需要的版本，再获得对应的管理域控制 对象的引用值。 e m s 向n m s 提供一个入口点对象的引用，n m s 可以通过某种方式( 如从存储文件中) 获得人口点对 象的引用( 指针) ，n m s 获取入口点对象引用的方式不在本规范的定义范围之内( 如果是通过文件方式 获取，该文件中应仅包含入口点对象的引用信息) 。在本规范中e p i r p 完成人口点对象的功能，该人口 点对象应为p e r s i s t e n t 的c o r b a 对象。 4 2 2 管理对象类图 访问人口点对象e e n u , 的对象类图如图1 所示。 4 g e 。脚。口 ll m 哪g 鲥g e 。商c 啦 i 、i 伞 e p i r pi 弋” e p i r p o i m a t i o n s e p h , p n o t i f i c a f i o n s + g e f l r p o u a i n e o + n o l l f y i r p l n f o c h a n g e s o + g e t l r p r e f e r e n c e 0 + r e l e a s e r s , p r e f e r e n c e 0 图1访问入口点对象类图 y d ，i1 5 8 43 2 0 0 7 4 2 3e p i r p 对象类分析 4 2 3 1 操作描述 4 2 3 1 1 获取管理域控制对象概述信息g e t l r p o u t l i n e ( m ) 行为 “n m s 调用该操作从e m s 的人口点获取所需的管理域控制对象的概述信息，n m s 可以根据特定的 需求设置获取管理域控制对象概述信息的过滤条件。” 输入参数 i r p v e r s i o n “参数i r p v e r s i o n 是n m s 要获取管理域控制对象概述信息的过滤条件，如该参数为空，则被管 系统应返回所支持的所有版本的i r p 概述信息。” 输出参数 s u p p o r t e d l r p l i s t “参数s u p p o r t e d i r p l i s t 是e m s 根据过滤条件返回的管理域控制对象概述信息的列表，其取值 为序列，其中每个元素项包括：系统d n 和i r p 列表。i r p 列表同样也为序列，每个元素项包括：i r p i d ， 该i r p 支持的规范版本列表，以及该i r p 所管理的范围( 可选，管理范围即该i r p 所管理的网络资源对 象实例的d n 列表，若管理范围包括接入网，则只需给出所管理的b s c f u n c t i o n 对象的d n 列表即可。若 该i r p 为e p i r p 、c s i r p 、n o t i f i c a t i o n i r p 和f i l e t r a n s f e r i r p ，则所管理范围为空) 。” 前提条件 命题1 ：“给定的i r p v e r s i o n 是合法的。” 后继条件 如果操作成功，则r e s u l t = “s u c c e s s ” 如果操作失败，则r e s u l t = “f a i l u r e ” 返回值 r e s u k “返回值r e s u l t 标识操作的成功与否。” 异常 如果前提条件命题1 不成立，则应扔出异常：“i n v a l i d l r p v e r s i o n ”。 如果返回其他原因的异常，则应扔出异常：“g e t l r p o u t l i n e ”。 4 2 3 1 _ 2 获取管理域控制对象引用g e t l r p r e f e r e n c e ( m ) 行为 “n m s 调用该操作从e m s 的入口点获取所需的管理域控制对象的引用值。” 输入参数 m a n a g e r l d e n f i f i e r “参数m a n a g e r l d e n t i f i e r 是n m s 的标识符，为字符串表示。” s y s t e m d n “参数s y s t e m d n 是e m s 系统中包含要获取的管理域控制对象的i r p a g e n t 的d n 值。” i r p i d y d t15 8 4 3 2 0 0 7 “参数i p 啦i d 是n m s 要获取的管理域控制对象的命名属性值。” 输出参数 i r p r e f e r e n c e “参数i r p r e f e r e n c e 是e m s 返回的管理域控制对象的引用值。” 前提条件 命题1 ：“给定的s y s t e m d n 、i r p i d 是合法的以及他们通过组合形成的i r p d n 是合法的。” 后继条件 如果操作成功，则r e s u l t = “s u c c e s s ” 如果操作失败，则r e s u l t = “f a i l u r e ” 返回值 r e s u l t “返回值r e s u l t 标识操作的成功与否。” 异常 如果前提条件命题1 不成立，则应扔出异常：“i n v a l i d r e q u e s t e d p a r a m e t e r s ”。 如果返回其他原因的异常，则应扔出异常：“g e t l r p r e f e r e n c e ”。 4 2 3 1 3 释放管理域控制对象引用r e l e a s e l r p r e f e r e n c e ( m ) 行为 “n m s 调用该操作释放已经获取到且不用的指定管理域控制对象的引用。e m s 是否真正删除该对象 不在本规范定义范围之内。” 输入参数 m a n a g e r l d e n t i f i e r “参数m a n a g e r l d e n t i f i e r 是n m s 的标识符，为字符串表示。” i r p r e f e r e n c e “参数i r p r e f e r e n c e 是n m s 要释放的管理域控制对象的引用值。” 输出参数 无。 前提条件 命题1 ：“给定的i r p r e f e r e n c e 是合法的。” 命题2 ：“给定的m a n a g e r l d e n t i f i e r 与i r p r e f e r e n c e 是匹配的，即该i r p r e f e r e n c e 是由该 m a n a g e r l d e n d f i e r 通过g e t i r p r e f e r e n c e 操作获取的。” 后继条件 如果操作成功，则r e s u l t = “s u c c e s s ” 如果操作失败，则r e s u l t = “f a i l u r e 返回值 r e s u l t “返回值r e s u l t 标识操作的成功与否。” 异常 6 y d l15 8 4 3 2 0 0 7 如果前提条件命题1 或命题2 不成立，则应扔出异常：“u n k n o w n l r p r e f e r e n c e ”。 如果返回其他原因的异常，则应扔出异常：“r e l e a s e l r p r e f e r e n c e ”。 4 2 3 2 通知描述 4 2 3 2 1 e p 中i r p 信息改变通知n o t i f y l r p i n f o c h a n g e s ( m ) 当人1 3 点中存储的i r p 的信息发生改变时，如有新的 r p 注册到人口点对象中，人口点对象中原有的 r p 注销或者入1 3 点对象中存储的i r p 信息发生变化，e m s 会根据要求向n m s 发出人口点中i r p 信息改变 通知，入口点中i r p 信息改变通知的格式如表4 所示。 表4 入口点中i r p 信息改变通知格式 参数名称中文名称限定说明 o b j e c t c l a s s对象类名 m y 发出通知的管理对象类，即e p i r p 对象 o b j c c t l n s t a n c e 对象实例标识符 m y 发出通知的管理对象实例，目p e p i r p 对象实 n o t i f i c a t i o n l d 通知号 m n 通知标识符。用来在需要时惟一标识通知，可进行通知的关 e v e n t t i m e事件时间m y 指明事件发生时间 s y s t e m d n 系统标识 c y 产生通知的被管系统( 1 i p l r p a g e n t ) 标识 n o t i f i c a d o n t y p e 通知类型 m y 上报的通知的类型，即e p 中珏t p 信息改变通知( n o t i f y l r p l n f o c h a n g e s ) 础d n i r p 的d n 值 m n e p 中存储的发生信息改变的1 r p 的d n 值，由包含该己p 的i r p a g e a t 的 s y s t e m d n 和i r p 的r 【 n 共同组成 c h a n g e m o d e 改变模式 m n e p 中i r p 信息改变的模式，包括：注册、注销和变化 a d d i t i o n a l t e x t 附加信息 0 n 该通知的附加说明信息 注：y 表示该参数可作为通知定购时的过滤条件，n 表示该参数不可作为通知定购时的过滤条件( 下同) 。 4 3 通知管理接口分析 4 3 1 通知定购管理接口分析 4 3 1 1 通知定购管理对象类圈 通知定购功能中引入对知, l o d f i c a d o n i r p ，该对象对通知的定购活动进行了封装，对象类图如图2 所示。 图2 通知管理对象类图 7 y d f l15 8 4 3 2 0 0 7 4 3 1 2 管理对象类分析 4 3 1 2 1 n o t i f i c a t i o n l r p 类描述 n o t i f i c a t i o n i r p x 象完成通知的定购活动，对通知定购进行了封装。 4 3 1 _ 2 2 操作描述 4 3 1 2 2 1 定购通知s u b s c r i b e ( m ) 行为 “n m s 调用该操作向e m s 定购一个或多个指定的通知。” 输人参数 m a n a g e r r e f e r e n c e 一一“参数m a n a g e r r e f e r e n c e 是n m s 侧事件接收者对象的引用( 如在c o r b a 接口中为 c o s n o t i f y c o m m ：s e q u e n e e p u s h c o n s u m e r 对象的i o r 。事件通道通过对m a n a g e r r e f e r e n c e 调用p u s h 操 作将事件信息传送给n m s 。该参数的类型是从c o r b a 事件服务中c o s n o t i f y c o m m 模块导入的 s e q u e n c e p u s h c o n s u m e r 类型。y l i m e t i c k ( o ) “参数f i m e t i c k 定义了一个定时器，该定时器超时后，通知的定购将被取消，以回收通知通道 资源。一般情况下，n m s 每隔一段时间调用g e t s u b s c r i p t i o n s t a t u s 操作可刷新一次定时器的时间，以此保 证相关的通道资源没有被释放。该参数以m i l l 为单位，如果取值为1 到1 5 之间时，内部定时器被设为1 5 ： 如果取值大于或等于1 5 时，内部定时器被设为输入的值；如果输入为空或者为零时表示无限值，即定时 器永不超时。” n o d f i c a t i o n c a t e g o r y s e t “参数n o t i f i c a f i o n c a t e g o r y s e t 定义了可过滤通知种类的集合，集合中的每个元素指明一个通知 种类，如配置管理相关的通知、性能管理相关的通知等。由相应管理域控制对象i r p 的名称以及版本号 来表示，表明该版本i r p 中所支持的所有通知。” f i l t e r “参数f i l t e r 定义定购过滤条件。该过滤条件在n o t i f i c a t i o n c a t e g o r y s e t 定义的所有通知种类的基 础上进行。n o t i f i c a t i o n c a t e g o r y s e t 与f l t e r 共同构成了对通知定购的过滤条件。f i l t e r 为字符串类型，其取 值遵循o m gc o r b a 服务规范t r a d e rs e r v i c e 中的定义。如果f i l t e r 值为空表示对n o t i f i c a t i o n c a t e g o r y s e t 定义的条件没有额外约束。对f i l t e r 取值的约定建议见本规范附录b 。” 输出参数 s u b s c r i p t i o n i d “参数s u b s c r i p t i o n l d 是通知定购的标识符。n m s 通过该值可以惟一标识定购。” 前提条件 命题1 ：“如果参数n o d f i c a t i o n c a t e g o r y s e t 非空，且给定的通知种类集合中至少有一个种类还没有被 该m a n a g e r r e f e r e n c e 定购”； 命题2 ：“如果参数n o t i f i c a t i o n c a t e g o r y s e t 非空，且n o t i f i c a t i o n c a t e g o r y s e t 中所有的通知种类都要被 i r p a g e n t 支持”； 命题3 ：“如果参数n o t i f i c a t i o n c a t e g o r y s e t 为空，且e m s 支持的所有通知种类中至少有一个还没有 y d r15 8 4 3 2 0 0 7 被该m a n a g e r r e f e r e n c e 定购”。 命题4 ：“输入参数合法”。 后继条件 如果操作成功，则r e s u l t = “s u c c e s s ”，且该次定购的有效通知种类集合为输入参数中定购通知种类集 合与输入参数m a n a g e r r e f e r e n c e 对应的已有定购通知种类集合的差集。如果参数n o t i f i c a t i o n c a t e g o r y s e t 为空，则为e m s 支持的所有通知种类与输入参数m a n a g e r r e f e r e n c e 对应的已有定购通知种类集合的差集。 原来已定购的通知种类集合及其过滤条件保持不变。 如果操作失败，则r e s u l t - - - “f a i l u r e ” 返回值 r e s u l t “返回值r e s u l t 标识操作的成功与否。” 异常 如果前提条件命题1 或命题3 不成立，则应扔出异常：“a l r e a d y s u b s c r i b e d 。 如果命题2 不成立，则应扔出异常：“a t l e a s t o n e n o t i f i c a t i o n c a t e g o r y n o t s u p p o r t e d 。 若命题4 不满足，则扔出异常“i n v a l i d p a r a r n e t e r ”。 如果输入参数不支持，则应扔出异常“p a r a m e t e r n o t s u p p o r t e d ”。 如果返回其他原因的异常，则应扔出异常： a t t a c h ”。 4 3 1 2 2 2 撤销定购u n s u b s c r i b e ( m ) 行为 “n m s 调用该操作撤销向e m s 的通知定购。” 输人参数 m a n a g e r r e f e r e n c e “参数m a n a g e r r e f e r e n c e 是打算撤销定购的归属n m s 侧事件接收者对象的引用。” s u b s c r i p t i o n i d “参数s u b s c d p f i o n i d 是标识定购的l 隹标识符。如果该参数为空表示撤销m a n a g e r r e f e r e n c e 以前 定购的所有通知定购。” 输出参数 无。 前提条件 命题1 ：“给定合法的m a n a g e r r e f e r e n c e 和合法的s u b s e 邱f i o n l d ，该s u b s c r i p t i o n i d 是由m a n a g e r r e f e r e n c e 定购的，且当前有效。” 命题2 ：“s u b s c r i p t i o n l d 空缺，但给定合法的m a n a g e r r e f e r e n c e 。若有的s u b s c r i p t i o n m 已经被撤销， 则重复撤销仍返回成功。” 后继条件 针对命题1 ：如果操作成功，则r e s u l t = “s u c c e s s ”，指定的定购被撤销； 针对命题2 ：如果操作成功，则r e s u l t = “s u c c e s s ”，与该n m s 侧事件接收者对象相关的所有定购被撤销； 如果操作失败，则r e s u l t = “f a i l u r e ” 9 y d 厂r15 8 4 3 2 0 0 7