综合网络开通系统统一业务接口规范(DSLAM网管分册)V2.0

1、彳国电信china felecom广东电信综合网络开通系统统一业务接口规范（dslam网管分册）（版本：1.4）广东省电信有限公司2006年08月修订控制页修订号修订日期修订内容简述修订人版本号120060824根据会议讨论进行调整刘秀华1. 0220070520增加端口类型、vci、vpi等参数丁明1.032007-12-19增加bras设备参数丁明1.142008-1-9增加”是否为家庭网关设备上网”参数丁明1.1152008-1-10应广州局方的要求增加“业务接入号”参数廖子常1.1262008-1-18针对现量用户换e家终端的需求，补充“批量 业务开通”接口廖子常1.372008-2-

2、1针对e家终端的需求，补充“开双pvc通道” 的接口代替1.3版的“批量业务开通”接口的 e8开通功能，并暂时停用“批量业务开通”接 口。廖子常1.482008-3-17在“业务变更”上补充“现业务所需session数” 和“原业务所需session数”，支持改业务session 值的动作。廖子常1.592008-4-16增加实时查询接口和文件施工接口廖子常2.092008-4-29在“宽带拆机施工接口”文件接口上补充115 现 vci117 现 vpi119 现 vlanid121 现 spvianld123 现 cevlanld125 现 nasip106现槽位号127现接入服务器端口廖子

3、常2.0目录修订控制页21 概述51编写目的51.2 缩略语51.3 参考资料51.4 文档约定52 业务概述53 包体参数定义63接收工单包体63.2 回复包包体83.3 业务所需参数说明83.3.1 装机（开户）83.3.2 拆机（销户）93.3.3 停复机93.3.4 业务变更（移机、改端口、改速率等）103.3.5 竣工测试113.3.6 批量业务开通123.3.7 开双pvc通道134 静态数据定义144.1 业务类型144.2 宽带类型154.3 返回值定义（由科塞补充）154.4 adsl速率164.5 端口类型161概述1.1编写目的本分册主要是用来规范ibss与综合网络开通系

4、统之间传递dslam业 务工单数据的消息包包体参数以及静态数据的定义。1.2缩略语> ibss：综合业务支撑系统> inas：综合网络开通系统1.3参考资料> 综合网络开通系统统一业务接口规范（总册）1.4文档约定2业务概述目前，ibss系统提供的adsl业务主要包括：装机、拆机、停机、复机、移机、 改速率、改端口等adsl主要业务；dslam网管系统针对以上的adsl业务提供对 有关的dslam设备的自动操作和管理功能；dslam系统中的接口模块主要实现的 adsl业务的处理功能，包括： 装机（开户）：接收ibss系统发送的装机（开户）业务工单，根据业务工单的 配置要求，对

5、指定端口进行相应速率的参数配置和打开端口（端口解锁）等操 作。 拆机（销户）：接收ibss系统发送的拆机（销户）业务工单，根据业务工单的 配置要求，对指定端口进行恢复参数配置和关闭端口（端口锁定）等操作。 停机：接收ibss系统发送的停机业务工单，根据业务工单的配置要求，对指 定端口进行关闭端口（端口锁定）操作。 复机：接收ibss系统发送的复机业务工单，根据业务工单的配置要求，对指 定端口进行打开端口（端口解锁）操作。 业务变更：dslam接收ibss系统发送变更业务，根据规则拆分成改速率、 改端口等业务工单，改速率业务根据业务工单的配置要求，对指定端口进行修 改相应业务速率的参数配置操作；

6、改端口业务根据业务工单的配置要求，对更 改的新端口进行相应速率的参数配置和打开端口（端口解锁）操作，对原端口 进行恢复参数配置和关闭端口（端口锁定）操作。 竣工测试：dslam接收ibss系统发送的竣工测试任务，根据测试数据与用 户申请的速率进行对比，并参考其他线路参数（比如衰减）进行综合判断，给 出是否具备开通条件的结论。3包体参数定义3.1接收工单包体公用部分见总册，下表是独有部分:key说明长度校验规则100业务操作代码varchar2(6)101原adsl帐号/专线号varchar2(40)102现adsl帐号/专线号varchar2(40)103原节点机编码varchar2(20)1

7、04现节点机编码varchar2(20)105原槽位号number(3)106现槽位号number(3)107原adsl板卡名称varchar2(40)108现adsl板卡名称varchar2(40)109原端口号number(6)110现端口号number(6)111原adsl速率（下行）varchar2(20)112现adsl速率（下行）varchar2(20)113原宽带类型varchar2(10)114现宽带类型varchar2(10)115现vci116原vci117现vpi118原vpi119现 vlanid120原 vlanid121现 spvianld122原 spvianld

8、123现 cevlanld124原 cevlanld125现 nasip126原 nasip127现接入服务器端口128原接入服务器端口129现业务所需session数营业前台录入的session数 量130原业务所需session数营业前台录入的session数 量131新终端设备类型0：传统 moden1:家庭网关132旧终端设备类型0：传统 moden1：家庭网关133现业务接入号varchar2(30)134旧业务接入号varchar2(30)135批量开通信息136需开双通道的相关线路信息3.2回复包包体公有部分见总册3.3业务所需参数说明3.3.1装机（开户）宽带112系统同步返回

9、处理结果key说明是否必须备注100业务操作代码是102现adsl帐号/专线号是104现节点机编码是106现槽位号是108现adsl板卡名称是110现端口号是112现adsl速率（下行）是114现宽带类型是115现vci117现vpi119现 vlanid121现 spvianld123现 cevlanld125现 nasip127现接入服务器端口129现业务所需session数营业前台录入的 session 数量131现终端设备类型133现业务接入号3.3.2拆机（销户）宽带112系统同步返回处理结果key说明是否必须备注100业务操作代码102现adsl帐号/专线号是104现节点机编码是1

10、06现槽位号是108现adsl板卡名称是110现端口号是112现adsl速率（下行）是114现宽带类型是116原vci118原vpi120原 vlanid122原 spvianld124原 cevlanld126原 nasip128原接入服务器端口132原终端设备类型133现业务接入号3.3.3停复机宽带112系统同步返回处理结果虚拟拨号业务存在该业务，专线业务不存在该业务key说明是否必须备注100业务操作代码£102现adsl帐号/专线号是104现节点机编码是106现槽位号是108现adsl板卡名称是110现端口号是112现adsl速率（下行）是114现宽带类型是133现业务接入

11、号3.3.4业务变更（移机、改端口、改速率等）宽带门2系统同步返回处理结果key说明是否必须备注100业务操作代码是101原adsl帐号/专线号是102现adsl帐号/专线号是103原节点机编码是104现节点机编码是105原槽位号是106现槽位号是107原adsl板卡名称是108现adsl板卡名称是109原端口号是110现端口号是111原adsl速率（下行）是112现adsl速率（下行）是113原宽带类型是114现宽带类型是115现vci116原vci117现vpi118原vpi119现 vlanid120原 vlanid121现 spvianld122原 spvianld123现 cevla

12、nld124原 cevlanld125现 nasip126原 nasip127现接入服务器端口128原接入服务器端口131现终端设备类型132原终端设备类型133现业务接入号134旧业务接入号129现业务所需session数营业前台录入的session数 量130原业务所需session数营业前台录入的session数 量3.3.5竣工测试宽带门2系统同步返回接收确认，异步返回处理结果key说明是否必须备注100业务操作代码是102现adsl帐号/专线号是104现节点机编码是106现槽位号是108现adsl板卡名称是110现端口号£112现adsl速率（下行）114现宽带类型是115

13、现vci117现vpi119现 vlanid121现 spvianld123现 cevlanld125现 nasip127现接入服务器端口133现业务接入号3.3.6批量业务开通（该接口暂时不启用）（该接口暂停使用，需重新启用另行标明） 宽带门2系统同步返回处理结果key说明是否必须备注100业务操作代码是135批量开通信息是该字段是多记录数据信息，每条记 录以英文半角分号”；”分隔，记录 末尾也带上分号”；”，记录里的字 段间用英文半角逗号”，”分隔。记录中的字段信息按顺序排列如 下：1. 现adsl帐号/专线号2. 现节点机编码3. 现槽位号4. 现adsl板卡名称5. 现端口号6. 现a

14、dsl速率（下行）7. 现宽带类型8. 现 vci9. 现 vpi10. 现 vlanid11. 现 spvianld12. 现 cevlanld13. 现 nasip14. 现接入服务器端口15. 现业务所需session数16. 现终端设备类型17. 现业务接入号3.3.7开双pvc通道宽带112系统同步返回处理结果key说明是否必须备注100业务操作代码136需开双通道的相关线路信息该字段是多记录数据信息，每条记 录以英文半角分号”；”分隔，记录 末尾也带上分号”；”，记录里的字 段间用英文半角逗号”，”分隔。记录中的字段信息按顺序排列如 下：1. 现槽位号2. 现端口号3. 现vci4

15、. 现vpi5. 现vlanid6. 现spvianld7. 现cevlanld8. 现nasip9. 现接入服务器端口10. 现业务接入号4静态数据定义4.1业务类型3字节编码，标识具体对应的业务操作类型。代码操作说明备注001装机002拆机003停复机004业务变更包括：端口变更、速率变更、移机等005竣工测试006批量业务开通主要应用于e家终端批量开通双通道 （该动作已由007代替，暂停使用）007开双pvc通道主要应用于e家终端批量开通双通道4.2宽带类型代码操作说明备注g01普通adslg02adsl2+4.3返回值定义（由科塞补充）错误代码错误描述00成功01旧端口不存在02新端口

16、不存在03i0 dslam没有配置默认业务04新dslam没有配置业务05i0 dslam 不可 ping06i0 dslam没有snmp权限07新dslam不可ping08新dslam没有snmp权限09旧端口业务复位失败10新端口业务操作失败11ib dslam机型配置错误12新dslam机型配置错误13系统没有旧dslam信息14系统没有新dslam信息15系统没有配置业务18dms通信不上19业务系统忙20dms忙21dms不支持旧dslam型号22dms不支持新dslam型号40测试失败41和dslam通信失败42查询超时43和dqs通信失败44和dqs连接不上45dslam返回数据

17、矛盾50操作失败4,4 adsl 速率不同本地网的码值有可能不一致代码描述50adsl缺省51adsl 512k52adsl1m53adsl1.5m54adsl2m55adsl4m56adsl6m57adsl8m58adsl10m59adsl5m70adsl3m71adsl 60k72adsl 下行 128k80itv 2m 升 4m81itv 3m 升 4m4.5端口类型错误代码错误描述0不指定端口信息1pvc2vlan3svlan4vbase5实时查询接口5.1端口业务信息查询接门名称imqryadportinfo功能说明查询当前宽带的端口承载的所有在用宽带的业务数据输入列表参数（使用tu

18、xedo的string方式输入数据，数据使用xml封装）字段说明类型长度可空备注acc nbr业务接入号varchar30n输出列表参数（使用tuxedo的string方式输出数据，数据使用xml封装）响应结果集输出，单记录输出参数。字段说明类型长度可空备注result结果number6n0表示处理成功； 其他表示失败message结果描述varchar2300y错误描述ndev out nbr节点机编码varchar220yslot槽位号number3yfrunit outadsl板卡名称varciiar240yport nbr端口号number9y查询到业务数据记录，多行输出参数字段说明类

19、型长度可空备注acc nbr业务接入号varchar30nprod id产品标识number9n参见静态表“产品 标识”dialacct宽带帐号varchar30nadslsl业务速率number2参考静态表“adsl 速率”session业务session数number2n接口说明：该接口由ibss系统提供，由dslam系统调用。输入xml格式<?xml version二"1.0" encoding二"gb2312"><request><param><acc_nbr >业务号码 </acc_nbr&

20、gt;</param></request>输出xml格式<?xml version=zzl. 0z，encoding二"gb2312"><response><!- result,只有0表示成功，其他字符表示失败>vresult> 处理结果 v/result>vmessage> 错误原因 v/message> vndev_out_nbr> 节点机编码 v/ndev_out_nbr> <slot> 槽位号 </slot>vfrunit_out>adsl

21、板卡名称v/frunit_out> vport_nbr>端 口 号v/port_nbr><record>vacc_nbr> 业务接入号 v/acc_nbr><prodd>产品标识</prodd> vdialacct> 宽带帐号 v/dialacct> <adslsl> 业务速率 v/adslsl> <session>业务 session 数</session></ record >< record ></ record ></ res

22、ponse >6文件接口6.1宽带拆机施工接口6.1.1接口描述宽带拆机在ibss竣工后，以文件方式定时批量发送工单给dts系统做 拆机施工，dts以文件方式把处理结果批量返回给ibss。 接口交互方案ibss提供ftp服务器，每天00点至8点间定吋生成前天竣工的宽带拆 机工单记录文件，存放在固定目录下，dts定时扫描该目录提取文件。ftp服务器地址、帐号、密码和存放目录不在该协议上，另由各分公司提供。 施工工单文件格式文件名：dslam. order. yyyymmdd. txt文件数据以文木方式存储，一行一条记录，每行以结束。每张工单以subs_id唯一标识，每张工单存在一条或多条记录（由于一个 端口可能存在承载多个在用宽带服务），每张工单相关的记录在文件上连续存 放。记录中的字段间用ascii码的逗号t分隔，记录末尾不带此分隔符，因 此字段内容不能包括t，若字段内容存在逗号请用分号代替。文件的第一行是字段名称，字段名称见下面的“记录字段说明”表。表61记录字段说明:字段名称说明类型可空备注subsd订单标识number(10)n唯一标识一张工单ndev out nbr节点机编码varchar2(20)n被拆的宽带使用的资源slot槽位号number(3)n被拆的宽带使用的资源frunit