[go: up one dir, main page]

WO2013010399A1 - 一种网管系统中隧道保护配置方法及系统 - Google Patents

一种网管系统中隧道保护配置方法及系统 Download PDF

Info

Publication number
WO2013010399A1
WO2013010399A1 PCT/CN2012/075808 CN2012075808W WO2013010399A1 WO 2013010399 A1 WO2013010399 A1 WO 2013010399A1 CN 2012075808 W CN2012075808 W CN 2012075808W WO 2013010399 A1 WO2013010399 A1 WO 2013010399A1
Authority
WO
WIPO (PCT)
Prior art keywords
tunnel
protection
network management
management system
port
Prior art date
Legal status (The legal status is an assumption and is not a legal conclusion. Google has not performed a legal analysis and makes no representation as to the accuracy of the status listed.)
Ceased
Application number
PCT/CN2012/075808
Other languages
English (en)
French (fr)
Inventor
陈冬平
Current Assignee (The listed assignees may be inaccurate. Google has not performed a legal analysis and makes no representation or warranty as to the accuracy of the list.)
ZTE Corp
Original Assignee
ZTE Corp
Priority date (The priority date is an assumption and is not a legal conclusion. Google has not performed a legal analysis and makes no representation as to the accuracy of the date listed.)
Filing date
Publication date
Application filed by ZTE Corp filed Critical ZTE Corp
Publication of WO2013010399A1 publication Critical patent/WO2013010399A1/zh
Anticipated expiration legal-status Critical
Ceased legal-status Critical Current

Links

Classifications

    • H—ELECTRICITY
    • H04—ELECTRIC COMMUNICATION TECHNIQUE
    • H04L—TRANSMISSION OF DIGITAL INFORMATION, e.g. TELEGRAPHIC COMMUNICATION
    • H04L63/00—Network architectures or network communication protocols for network security
    • H04L63/02—Network architectures or network communication protocols for network security for separating internal from external traffic, e.g. firewalls
    • H04L63/0272—Virtual private networks
    • H—ELECTRICITY
    • H04—ELECTRIC COMMUNICATION TECHNIQUE
    • H04L—TRANSMISSION OF DIGITAL INFORMATION, e.g. TELEGRAPHIC COMMUNICATION
    • H04L41/00—Arrangements for maintenance, administration or management of data switching networks, e.g. of packet switching networks
    • H04L41/34—Signalling channels for network management communication

Definitions

  • the technical solutions adopted by the present invention include:
  • a protection point generation module which is used to generate a protection point
  • the created tunnel information is stored in a special tunnel information table, and the dedicated tunnel information is The table is stored in the database.
  • FIG. 1 is a schematic flow chart of a tunnel protection configuration method in a network management system according to the present invention. The method of the present invention will be described in detail below with reference to FIG. 1 and the difference between the method of the present invention and the conventional technical solution.
  • the server receives the created tunnel command and the packet sent by the client, and transmits the packet to the adapter.
  • the adapter creates the work and protects the two tunnels, sends the packet to the device, and waits for the device to answer.
  • Equipment at After the correct response within the specified time the adapter sends a notification to the synchronization module (the synchronization module is used for data synchronization between the network management system and the device), performs the warehousing operation, and completes the entire tunnel creation process.
  • the TP table in the database needs to be searched to obtain the tunnel information that has been created. Because the TP table not only stores the tunnel information, but also stores all the information about the board, PTP (physical terminal point) information, CTP (connection terminal point) information, FTP (floating terminal point) information, and so on, so that the TP table The number of records is very large. In order to be able to find tunnel information from the TP table, it has to use an iterative query algorithm (need to create a series of operations such as iterators, iterative queries, and delete iterators).
  • the tunnel on which the protection point depends is only displayed in a very simple manner by the tunnel number, and the working tunnel and the protection tunnel are no longer fixedly attached to the ports of the specific board.
  • the client sends a general configuration packet to create a tunnel protection.
  • the common configuration packet is a general-purpose packet that is applicable to all devices managed by the NMS.
  • the common configuration packet includes: protection type, various protection parameters, and protection relationship. And other information.
  • the server converts it to a F-port packet, and then transmits the converted F-port packet to the adapter.
  • the adapter then converts the F-port packet to a Qx packet and sends it to the device. After the device responds normally, the server puts the F-port packet into the database and completes the entire tunnel protection creation process.
  • the server receives the created tunnel command and the packet sent by the client, and transmits the packet to the adapter.
  • the adapter creates the work and protects the two tunnels, and sends the packet to the device and waits for the device to answer. After the device responds correctly within the specified time, the adapter sends a notification to the synchronization module to perform the inbound operation and complete the entire tunnel creation process.
  • the server When the server receives the PTN linear 1+1 path protection command from the client, it invokes the common configuration framework and starts the process of dynamically generating the protection point. In the process of dynamically generating protection points, all the already created ones can be obtained by looking up the special tunnel information table in the database. Tunnel information.
  • the user can choose the protection type, here select PTN linear 1+1 path protection.
  • the user can configure various protection parameters, such as: return mode, recovery waiting time and other parameters.
  • the client collects all the configurations selected by the user, including the protection type, various protection parameters, and protection relationships, and constructs a complete common configuration packet and sends it to the server. .
  • the server converts it to a F-port packet, and then transmits the converted F-port packet to the adapter.
  • the adapter then converts the F-port packet to a Qx packet and sends it to the device.
  • the server enters the F-port packet and completes the entire tunnel protection creation process. Finally, the PTN linear 1+1 path protection is successfully created.
  • the tunnel protection configuration system in the network management system of the present invention includes a tunnel creation module 201, a protection point generation module 202, a tunnel protection creation module 203, and a database 204. .
  • the tunnel creation module 201 is configured to create a tunnel, and the created tunnel includes a working tunnel and a protection tunnel. The created tunnel is not fixed under the port of the board.
  • the protection point generation module 202 is configured to generate a protection point.
  • the tunnel protection creation module 203 is used to create tunnel protection.
  • the tunnel to which the tunnel protection depends is no longer fixedly attached to the port of the specific board, first, it conforms to the TMF standard organization, and secondly, it can adapt to the port migration and extraction of the project.
  • the board operation requirements do not need to change the tunnel protection service that was created after a series of complicated operations, which greatly improves the ease of use and maintainability of the network management.

Landscapes

  • Engineering & Computer Science (AREA)
  • Computer Networks & Wireless Communication (AREA)
  • Signal Processing (AREA)
  • Computer Hardware Design (AREA)
  • Computer Security & Cryptography (AREA)
  • Computing Systems (AREA)
  • General Engineering & Computer Science (AREA)
  • Data Exchanges In Wide-Area Networks (AREA)

Abstract

本发明公开了一种网管系统中隧道保护配置方法，包括：创建隧道；所述隧道不固定挂靠在单板的端口之下；生成保护点；创建隧道保护。采用本发明方法配置隧道保护业务，既符合TMF组织规定，又适应了工程上的端口迁移和拔板操作需求，不用改变已创建好的隧道保护业务，极大提高了网管的易用性和可维护性。本发明还提供了一种网管系统中隧道保护配置系统，包括隧道创建模块、保护点生成模块、隧道保护创建模块和数据库。

Description

一种网管系统中隧道保护配置方法及系统 技术领域
本发明属于隧道保护技术， 尤其涉及一种网管系统中隧道保护配置方 法及系统。 背景技术
在网管系统隧道保护业务配置过程中， 对于使用传统技术的隧道保护 业务配置， 当配置保护关系需要选择相关隧道时， 由于它依赖的隧道都是 固定挂靠在具体单板的端口之下， 当工程需求上遇到需要进行端口迁移（如 增删端口、 修改端口属性等）或拔板操作时， 相关端口和单板属性都进行 了变更， 相应地， 固定挂靠在具体单板端口之下的隧道以及相关隧道保护 业务都必须随之变更。 由于配置隧道保护业务比较复杂， 一般工程应用中， 用户一旦配置好该业务后， 不希望该业务经常变更， 更不希望由于其他变 更引起该隧道保护业务的关联变更。
另外， 在 TMF ( TeleManagement Forum )组织对分组传送网 （PTN, Packet Transport Network )描述中， 段层保护、 隧道保护和伪线保护等保护 类型和单板端口的关系都是松散的绑定关系， 这和 MSTP ( Multi-Service Transfer Platform,也即基于 SDH 的多业务传送平台）中通道和端口之间的 固定嵌套关系完全不同。
综上所述， 传统技术的隧道保护业务配置局限性显而易见： 它既不符 合 TMF组织规定， 又无法适应工程上的端口迁移和拔板操作。 因此， 必须 要对传统技术方案进行优化， 以解决该问题。 发明内容
本发明要解决的技术问题是提供一种网管系统中隧道保护配置方法及 系统， 利用本发明方案来配置隧道保护业务， 既符合 TMF组织规定， 又适 应了工程上的端口迁移和拔板操作需求。
为解决上述技术问题， 本发明所釆用的技术方案包括：
一种网管系统中隧道保护配置方法， 包括：
创建隧道， 所述隧道不固定挂靠在单板的端口之下；
生成保护点；
创建隧道保护。
其中， 所述隧道包括工作隧道和保护隧道。
其中， 所述创建隧道时， 客户端界面下发的创建隧道报文是符合多协 议标签交换 ( MPLS , Multi-Protocol Label Switching ) 中的标签交换路径 ( LSP, Label Switching Path )规范的一种报文， 该报文携带的隧道号码不 固定挂靠在具体单板的端口之下。
其中， 已创建的隧道信息存放于专门的隧道信息表中；
所述生成保护点时， 通过查找所述专门的隧道信息表获得已创建的隧 道信息。
一种网管系统中隧道保护配置系统， 包括：
隧道创建模块， 该模块用于创建隧道， 所述隧道不固定挂靠在单板的 端口之下；
保护点生成模块， 该模块用于生成保护点；
隧道保护创建模块， 该模块用于创建隧道保护。
其中， 所述隧道包括工作隧道和保护隧道。
其中， 本发明网管系统中隧道保护配置系统还包括数据库；
已创建的隧道信息存放于专门的隧道信息表中， 所述专门的隧道信息 表存放于所述数据库中。
本发明的有益效果为：
使用本发明技术方案来配置隧道保护业务， 由于隧道保护所依赖的隧 道不再固定挂靠在具体单板的端口之下， 所以， 首先， 它符合 TMF标准组 织的规定， 其次， 能适应工程上的端口迁移和拔板操作需求， 不用改变原 来经过一系列复杂操作后创建好的隧道保护业务， 极大地提高了网管的易 用性和可维护性。
另外， 釆用本发明技术方案， 在动态生成保护点过程中， 不需要查找 数据库中十分庞大的 TP (终端点）表， 而只需要简单查找专门的隧道信息 表就可以获取已经创建好的隧道信息。 由于专门的隧道信息表只存储了隧 道信息， 所以隧道信息表的记录数比较小； 而且在查库时， 不需要使用迭 代查询算法进行查找， 也不需要使用层速率等信息， 只需要根据网元信息 进行简单过滤即可； 因此查找效率得到了很大提升。 附图说明
图 1为本发明网管系统中隧道保护配置方法的流程示意图；
图 2为本发明网管系统中隧道保护配置系统的结构示意图。 具体实施方式
下面结合附图和具体实施方式对本发明作进一步详细说明。
图 1为本发明网管系统中隧道保护配置方法流程示意图，下面结合图 1 以及本发明方法与传统技术方案的差别来详细描述本发明方法。
如图所示， 本发明网管系统中隧道保护配置方法包括如下步骤： 1 : 创建隧道
服务器端接收客户端下发的创建隧道命令和报文， 透传给适配器， 适 配器创建工作和保护两条隧道， 下发报文给设备并等待设备应答。 设备在 规定时间内正确应答后， 适配器发送通知给同步模块（同步模块用于网管 系统和设备之间的数据同步）， 进行入库操作， 完成整个隧道创建过程。
在传统技术方案中， 创建隧道时， 客户端界面下发创建隧道报文携带 的隧道号码固定挂靠在具体单板的端口之下。
根据本发明方法， 创建隧道时， 客户端界面下发的创建隧道报文是符 合多协议标签交换（MPLS , Multi-Protocol Label Switching ) 中的标签交换 路径（LSP, Label Switching Path )规范的一种报文， 该报文携带的隧道号 码不再固定挂靠在具体单板的端口之下。 釆用本发明方法， 创建的隧道不 再固定挂靠在具体单板的端口之下， 隧道和单板端口的关系是松散的绑定 关系。
2: 生成保护点
服务器端接收到客户端下发的创建隧道保护命令时， 调用通用配置框 架， 开始启动动态生成保护点过程。 在动态生成保护点过程中， 需要查找 数据库， 以便获取创建隧道保护所必须的、 并且已经创建好的隧道信息。
根据传统技术方案， 在动态生成保护点过程中， 需要查找数据库中 TP 表， 以获取已经创建好的隧道信息。 由于 TP表不但存储了隧道信息， 还存 储了所有单板信息、 PTP (物理终端点）信息、 CTP (连接终端点）信息、 FTP (浮动终端点）信息等等许多信息记录，使得 TP表的记录数非常庞大。 为了能够从 TP表查找出隧道信息， 不得不使用迭代查询算法（需要进行创 建迭代器、 迭代查询、 删除迭代器等一系列操作）进行查找。 而且， 在迭 代查询过程中， 必须将网元和层速率等信息结合起来一起作为过滤条件进 行查询。 显然， 使用这种迭代查询算法比较复杂， 而且， 迭代查询算法本 身也经常暴露出各种问题。 当数据量很大时， 使用这种迭代查询算法效率 也不高。
釆用本发明方法， 使用专门的隧道信息表来存放已经创建好的隧道信 息， 在动态生成保护点过程中， 不再需要查找数据库中 TP表， 而只需要查 找专门的隧道信息表就可以获取已经创建好的隧道信息。 由于专门的隧道 信息表只存储了隧道信息， 所以隧道信息表的记录数不大， 不需要使用迭 代查询算法进行查找； 而且， 也不需要层速率等信息， 只需要根据网元信 息进行过滤即可。 显然， 这样查找起来既简单又高效。
釆用本发明方法， 保护点所依赖的隧道只是非常简洁地以隧道号展现 出来， 工作隧道和保护隧道不再固定挂靠在具体单板的端口之下。
3: 创建隧道保护
客户端下发创建隧道保护通用配置报文， 通用配置报文是对网管系统 管理的所有设备都适用的一种通用报文， 该通用配置报文包括： 保护类型、 各种保护参数以及保护关系等信息。 服务器端接收到该通用配置报文后， 将其转换为 F口报文，然后将转换后的 F口报文传给适配器。适配器再将 F 口报文转换为 Qx报文下发给设备。等到设备正常应答后，服务器端将 F口 报文入库并完成整个隧道保护创建过程。
下面再以配置 PTN线性 1+1路径保护整个流程为具体实例对本发明方 法做进一步详细描述：
1 : 创建隧道
服务器端接收客户端下发的创建隧道命令和报文， 透传给适配器， 适 配器创建工作和保护两条隧道， 下发报文给设备并等待设备应答。 设备在 规定时间内正确应答后， 适配器发送通知给同步模块， 进行入库操作， 完 成整个隧道创建过程。
2: 生成保护点
服务器端接收到客户端下发的创建 PTN线性 1+1路径保护命令时， 调用通用配置框架， 开始启动动态生成保护点过程。 在动态生成保护点过 程中， 通过查找数据库中专门的隧道信息表就可以获取已经创建好的所有 隧道信息。
3: 创建隧道保护
首先， 进入新建保护关系组界面， 用户可以选择保护类型， 这里选择 PTN线性 1+1路径保护。
接着， 进入保护参数界面， 用户可以配置各种保护参数， 如： 返回方 式、 恢复等待时间等一系列参数。
然后， 进入保护关系界面。 用户可以在保护点中选择工作和保护隧道。 最后， 用户点击 "完成" 按钮， 此时， 客户端收集以上用户选择的所 有配置， 包括保护类型、 各种保护参数以及保护关系等信息， 构造成一条 完整的通用配置报文， 下发给服务器。 服务器端接收到该通用配置报文后， 将其转换为 F口报文，然后将转换后的 F口报文传给适配器。适配器再将 F 口报文转换为 Qx报文下发给设备。等到设备正常应答后，服务器端将 F口 报文入库并完成整个隧道保护创建过程， 最终成功创建好 PTN线性 1+1路 径保护。
图 2为本发明网管系统中隧道保护配置系统结构示意图， 如图所示， 本发明网管系统中隧道保护配置系统， 包括隧道创建模块 201、保护点生成 模块 202、 隧道保护创建模块 203和数据库 204。
其中， 隧道创建模块 201 用于创建隧道， 创建的隧道包括工作隧道和 保护隧道， 创建的隧道不固定挂靠在单板的端口之下。
保护点生成模块 202用于生成保护点。
隧道保护创建模块 203用于创建隧道保护。
数据库 204用于存放专门的隧道信息表， 该隧道信息表中存放已创建 的隧道信息。
本发明网管系统中隧道保护配置系统的具体实施方案可参见以上对本 发明网管系统中隧道保护配置方法的描述， 此处不再赘述。 以上所述的具体实施例， 对本发明的目的、 技术方案和有益效果进行 了进一步详细说明， 所应注意的是， 以上所述仅为本发明的具体实施例而 已， 本领域的技术人员可以对本发明进行各种改动和变型而不脱离本发明 的精神和范围。 这样， 倘若本发明的这些修改和变型属于本发明权利要求 记载的技术方案及其等同技术的范围之内， 则本发明也意图包含这些改动 和变型在内。
工业实用性
通过本发明的技术方案， 由于隧道保护所依赖的隧道不再固定挂靠在 具体单板的端口之下， 所以， 首先， 它符合 TMF标准组织的规定， 其次， 能适应工程上的端口迁移和拔板操作需求， 不用改变原来经过一系列复杂 操作后创建好的隧道保护业务， 极大地提高了网管的易用性和可维护性。

Claims

权利要求书
1、 一种网管系统中隧道保护配置方法， 其中， 所述方法包括： 创建隧道， 所述隧道不固定挂靠在单板的端口之下；
生成保护点；
创建隧道保护。
2、 根据权利要求 1所述的网管系统中隧道保护配置方法， 其中， 所述 隧道包括工作隧道和保护隧道。
3、 根据权利要求 1或 2所述的网管系统中隧道保护配置方法， 其中， 所述创建隧道时， 客户端界面下发的创建隧道报文是符合多协议标签交换 MPLS中的标签交换路径 LSP规范的一种报文， 该报文携带的隧道号码不 固定挂靠在具体单板的端口之下。
4、 根据权利要求 1或 2所述的网管系统中隧道保护配置方法， 其中， 已创建的隧道信息存放于专门的隧道信息表中；
所述生成保护点时， 通过查找所述专门的隧道信息表获得已创建的隧 道信息。
5、 一种网管系统中隧道保护配置系统， 其中， 包括：
隧道创建模块， 用于创建隧道， 所述隧道不固定挂靠在单板的端口之 下；
保护点生成模块， 用于生成保护点；
隧道保护创建模块， 用于创建隧道保护。
6、 根据权利要求 5所述的网管系统中隧道保护配置系统， 其中， 所述 隧道包括工作隧道和保护隧道。
7、 根据权利要求 5或 6所述的网管系统中隧道保护配置系统， 其中， 还包括数据库；
已创建的隧道信息存放于专门的隧道信息表中， 所述专门的隧道信息 表存放于所述数据库中
PCT/CN2012/075808 2011-07-19 2012-05-21 一种网管系统中隧道保护配置方法及系统 Ceased WO2013010399A1 (zh)

Applications Claiming Priority (2)

Application Number Priority Date Filing Date Title
CN201110201942.2A CN102891760B (zh) 2011-07-19 2011-07-19 一种网管系统中隧道保护配置方法及系统
CN201110201942.2 2011-07-19

Publications (1)

Publication Number Publication Date
WO2013010399A1 true WO2013010399A1 (zh) 2013-01-24

Family

ID=47535136

Family Applications (1)

Application Number Title Priority Date Filing Date
PCT/CN2012/075808 Ceased WO2013010399A1 (zh) 2011-07-19 2012-05-21 一种网管系统中隧道保护配置方法及系统

Country Status (2)

Country Link
CN (1) CN102891760B (zh)
WO (1) WO2013010399A1 (zh)

Families Citing this family (3)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
CN105099748A (zh) * 2014-05-23 2015-11-25 中兴通讯股份有限公司 一种业务隧道迁移方法及系统
CN105634856B (zh) * 2014-11-21 2020-03-31 中兴通讯股份有限公司 业务性能参数的确定方法及装置
CN106301869B (zh) * 2015-06-24 2020-02-04 中兴通讯股份有限公司 一种建立ptn业务割接计划的方法及装置

Citations (2)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
CN1622555A (zh) * 2003-11-27 2005-06-01 上海贝尔阿尔卡特股份有限公司 用于媒体网关的端口动态绑定模块及其动态绑定方法
CN101984591A (zh) * 2010-10-13 2011-03-09 中兴通讯股份有限公司 一种传送多协议标记交换网络中业务收敛的方法及系统

Family Cites Families (4)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
CN101394260B (zh) * 2007-09-17 2011-06-08 华为技术有限公司 一种实现主备倒换及负荷分担的方法和装置
CN101404613B (zh) * 2008-11-20 2011-04-20 华为技术有限公司 一种数据保护的方法和设备
CN101605083B (zh) * 2009-07-15 2012-01-25 中兴通讯股份有限公司 一种环网的保护子网发现方法及装置
CN102035712B (zh) * 2009-09-29 2013-12-18 华为技术有限公司 多协议标签交换的环网保护方法、装置和系统

Patent Citations (2)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
CN1622555A (zh) * 2003-11-27 2005-06-01 上海贝尔阿尔卡特股份有限公司 用于媒体网关的端口动态绑定模块及其动态绑定方法
CN101984591A (zh) * 2010-10-13 2011-03-09 中兴通讯股份有限公司 一种传送多协议标记交换网络中业务收敛的方法及系统

Also Published As

Publication number Publication date
CN102891760B (zh) 2017-11-10
CN102891760A (zh) 2013-01-23

Similar Documents

Publication Publication Date Title
CN103763129B (zh) 一种PCIe设备管理方法及装置
WO2011011951A1 (zh) 一种交易凭据打印方法及系统
CN101876984A (zh) 一种数据管理系统及其数据关联查询方法和装置
CN110138579B (zh) 用户侧设备的配置方法和相关装置
CN107710196A (zh) 一种管理资源对象的方法和系统
WO2009056039A1 (en) A METHOD AND DEVICE FOR REALIZING AUTOMATICAL DISTRIBUTION OF QinQ BUSINESS LABEL TERMINAL TO TERMINAL
WO2018010555A1 (zh) 一种北向接口lte业务自动配置方法、北向接口装置及存储介质
WO2019223178A1 (zh) 跨平台任务调度方法、系统、计算机设备和存储介质
CN104378240A (zh) 一种灵活自定义拓扑视图进行监控的方法
CN102131205B (zh) 多模系统中的网络管理方法及系统
CN113709250B (zh) 一种基于订阅发送模式的跨域用户数据同步方法
WO2013010399A1 (zh) 一种网管系统中隧道保护配置方法及系统
CN101848110B (zh) 一种tr069网络管理方法和设备
CN103368764B (zh) 一种虚拟网络的实现方法及网络管理系统
CN103368969A (zh) 传输管理eml-nml间全量配置同步的方法及系统
CN112468600B (zh) 一种基于网络矩阵的应用消息通知方法、系统及存储介质
WO2016091013A1 (zh) 业务处理方法及装置
CN102752158A (zh) 业务流量监控方法及装置
US20150236918A1 (en) Method and system for creating single snmp table for multiple openflow tables
US20080109540A1 (en) Method and System for Distributing Software Components
CN103200029A (zh) 网管对PTN/IPRan设备的标签分配和管理的方法
CN106612207B (zh) 以太网设备rstp信息的管控方法和装置
CN102014034B (zh) 一种基于树形虚拟局域网的层次化虚拟网络及其配置方法
CN100401684C (zh) 网络管理层通过网元管理层实现信息管理的方法
CN117580074A (zh) 双模基站的网管适配系统及方法

Legal Events

Date Code Title Description
121 Ep: the epo has been informed by wipo that ep was designated in this application

Ref document number: 12815039

Country of ref document: EP

Kind code of ref document: A1

NENP Non-entry into the national phase

Ref country code: DE

122 Ep: pct application non-entry in european phase

Ref document number: 12815039

Country of ref document: EP

Kind code of ref document: A1