ＩＣＳ ２５．０４０．４０ Ｎ １８ ａ亘 中华人民共和国国家标准 ＧＢ／Ｔ ２６８０５．５—２０ １ 工业控制计算机系统 １ 软件 第５部分：用户软件文档 Ｉｎｄｕｓｔｒｉａｌ ｃｏｎｔｒｏｌ ｃｏｍｐｕｔｅｒ ｓｙｓｔｅｍ—Ｓｏｆｔｗａｒｅ— Ｐａｒｔ ５：Ｕｓｅｒ ｓｏｆｔｗａｒｅ ２０１ １－０７－２９发布 ｄｏｃｕｍｅｎｔ ２０１１－１２－０１实施 丰瞀髁鬻瓣警镤赞星发布 中国国家标准化管理委员会厘１９ ＧＢ／Ｔ ２６８０５．５—２０ １１ 目 次 前言・………………………－． １范围……………………・・ 。１ ２规范性引用文件………－－ １ ３术语和定义…………・・… ｌ ４背景信息……・・・………・ ２ ５用户软件文档的主要内容 ２ ５．１软件的标识…………・ ２ ５．２用途和适用范围・…… ３ ５．３程序规格说明・・…・…・ ３ ５．４数据规格说明………・ ４ ５．５操作环境・…………… ５ ５．６终端操作……………－ ５ ５．７应用举例……………・ ５ ５．８合同款项……・……… ６ ５．９安装与支持…………・ ６ ５．１０置信度……・…・・・・・・… ６ ５．１ｌ标准…………………－ ６ ５．１２产品编号・・・・・・………・ ６ 参考文献……………………－ ７ ＧＢ／Ｔ ２６８０５．５－－２０１１ 刖 暑 ＧＢ／Ｔ ２６８０５（工业控制计算机系统软件》分为以下几部分： ——第１部分：评价体系； ——第２部分：测试方法； ——第３部分：文档管理指南； ——第４部分：工程化文档规范； ——第５部分：用户软件文档。 本部分是ＧＢ／Ｔ ２６８０５的第５部分。 本部分由中国机械工业联合会提出。 本部分由全国工业过程测量和控制标准化技术委员会（ｓＡＣ／ＴＣ １２４）归口。 本部分负责起草单位：西南大学。 本部分参加起草单位：北京研华兴业电子科技有限公司、深圳市研祥软件技术有限公司、中国计算 机学会工业控制计算机专业委员会。 本部分主要起草人：黄巧莉、杨颂华、张为群、刘枫、吕静、张渝。 本部分参加起草人：刘学东、刘永池、陈志列、程剑锋、杨孟飞。 ＧＢ／Ｔ ２６８０５．５—２０１１ 工业控制计算机系统软件 第５部分：用户软件文档 １范围 ＧＢ／Ｔ ２６８０５的本部分规定了工业控制软件的用户软件文档应提供的各类信息，以便指导该类文 档的编制。 本部分适应于工业控制软件的用户软件文档编制。 ２规范性引用文件 下列文件中的条款通过ＧＢ／Ｔ ２６８０５的本部分的引用而成为本部分的条款。凡是注日期的引用文 件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本部分，然而，鼓励根据本部分达成 协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本 部分。 ２００６计算机软件文档编制规范 ＧＢ／Ｔ ８５６７ ３术语和定义 ＧＢ／Ｔ ８５６７－－２００６确立的以及下列术语和定义适用于ＧＢ／Ｔ ２６８０５的本部分。 ３．１ 工业控制软件ｉｎｄｕｓｔｒｉａｌ ｃｏｎｔｒｏｌ ｓｏｆｔｗａｒｅ 适用于工业过程测量和控制的专用软件。除具备数据处理软件的一般特点外，应具有更高的实时 性、并发性、高可靠性和可维护性等特点。 ３．２ 工业过程ｉｎｄｕｓｔｒｉａｌ ｐｒｏｃｅｓｓ 基本完成一个或一系列物理变化或化学变化的一组运行。 ［ＧＢ／Ｔ １７２１２－－１９９８的ＰＩ．０．０．０６］ 注：其他过程和物质或能量的输送和／或暂时贮存、信息的传输可看作是工业过程的一部分。 ３．３ 过程测量ｐｒｏｃｅｓｓ ｍｅａｓｕｒｅｍｅｎｔ 确定各过程变量值的信息获取。 ＥＧＢ／Ｔ １７２１２ １９９８的Ｐ１．０．０．０９３ ３．４ 过程控制ｐｒｏｃｅｓｓ ｃｏｎｔｒｏｌ 为达到规定的目标而对影响过程状况的变量的操纵。 ［ＧＢ／Ｔ １７２１２－－１９９８的Ｐ１．０．０．１０］ ３．５ 文档ｄｏｃｕｍｅｎｔ 一种数据媒体和其上所记录的数据。它具有永久性并可以由人或机器阅读。 ［ＧＢ／Ｔ １１４５７－－２００６的２．４９５］ ３．６ 软件文档 ｓｏｆｔｗａｒｅ ｄｏｃｕｍｅｎｔａｔｉｏｎ 以人们可读的形式出现的技术数据和信息。包括计算机列表和打印输出，它们描述或规定软件设 １ ＧＢ／Ｔ ２６８０５．５—２０１１ 计或细节，说明软件具备的能力，或为使用软件以便从软件系统得到所期望的结果而提供的操作指令。 ［ＧＢ／Ｔ １１４５７－－２００６的２．１４９３］ ３．７ 用户文档集ｕｓｅｒ ｄｏｃｕｍｅｎｔａｔｉｏｎ 一套文档，它为使用系统或部件以期获得所希望结果的最终用户提供系统指令方面的信息。 ［ＧＢ／Ｔ １１４５７－－２００６的２．１０８９３ ３．８ 用户软件文档ｕｓｅｒ ｓｏｆｔｗａｒｅ ｄｏｃｕｍｅｎｔａｔｉｏｎ 用以提供软件的标识、用途和适用范围、功能规格说明、数据规格说明、操作环境等综合信息的一类 用户文档。 ３．９ 委托单位ｅｎｔｒｕｓｔｍｅｎｔ ｃｏｍｐａｎｙ 亦称交办单位。指为用户软件的开发提供资金，并且通常（但并非绝对）提出软件需求的单位。 ３．１０ 承办单位ｕｎｄｅｒｔａｋｅｒ 从事用户软件的开发、研制的单位。 ４背景信息 在编制用户软件文档时，应提供以下背景信息： ａ）开发软件的委托单位，承办单位和协作单位（如果有的话）； ｂ）描述软件的设计层次和设计方法，指出软件所具有的显著特点，以及是否计划进行修改等； ｃ）说明软件能够提供的产品形式，例如提供光盘和文档手册等； ｄ）列出与用户软件文档有关的辅助文档的清单（例如程序员指南，安装指南），列出这些文档资 料的作者、标题、序号、发表日期和出版单位，并说明如何取得这些文档； ｅ） 给出用户软件文档中用到的、可能引起混淆的专门术语的定义，对略语和缩写词要注明原文。 ５用户软件文档的主要内容 ５．１软件的标识 ５．１．１概述 软件的标识包括提供软件名、版本和日期、派生软件和关键字等内容。对软件名、版本和日期以及 派生软件，建议进行显示。 ５．１．２软件名 提供用以标识软件的标号和名称，还要提供描述软件主要功能的子标号。 ５．１．３版本和日期 ５．１．３．１版本 提供软件的版本标识（版本、修订本、版本号和发行号），还要提供版本数字序号的简要说明。它应 包括适用于这些项的保密性和私密性要求，处理它们的安全措施和关于复制和许可证条款的说明和制 约。软件版本的标识应符合ＧＢ／Ｔ ８５６７ ２００６中７．２２的规范性要求。 ５．１．３．２日期 提供原版本和现行版本的出版日期。 ５．１．４派生软件 对同时流行但又有不少差别的同类软件需提供辅助标识，例如说明是否运行于不同的设备或操作 系统。 ２ ＧＢ／Ｔ ２６８０５．５—２０１１ ５．１．５关键字 可以用来描述软件的特征以及进行查询和实现检索的描述符或关键字。 ５．２用途和适用范围 ５．２．１用途 简述软件的用途。 ５．２．２适用范围 简述软件的各种功能以及在应用方面的限制，以便使委托单位或用户能够决定是否满足其软件需 求，因而决定是否采用。 ５．３程序规格说明 ５．３．１问题描述 综合描述软件中每一程序所要解决的问题。 ５．３．２问题求解 ５．３．２．１约定和术语 给出用户软件文档所用到的各项规则的细节，例如： ａ）约定在求解问题时所用字符或符号的含义； ｂ） 约定字符和符号组合后的特定含义； ｃ）指明所使用的前缀、后缀、符号、精度、舍入、坐标系统、值域和缩写表的含义； ｄ） 约定各种技术规则的含义等。 ５．３．２．２求解问题的原理和算法 描述与指定功能有关以及与程序的结构组织有关的解题方法和算法以及参考文献。 ５．３．３程序结构 按所指定的解题方法，描述程序单元的组织，例如： ａ）程序； ｂ）子程序； ｃ）模块； ｄ）程序段； ｅ）公共存储区。 可以按图解方式表示，例如： ａ）采用树形结构图； ｂ）采用适当的文字结构描述； ｃ）必须包括单元名描述，描述它们的入口、出口，以及它们之间的相互关系。 ５．３．４程序规模 按常用单位，例如字节数或源代码行数，指出程序的总规模。 ５．３．５功能规格说明 ５．３．５．１功能 逐项说明软件中每一程序所具备的各项功能及其极限范围。 ５．３．５．２出错和恢复 ａ） 指出软件可能产生的出错信息的种类和采用的出错处理方法； ｂ）指出为确保再启动和恢复，用户必须遵循的处理规则和详细步骤。 ５．３．６性能 ５．３．６．１概述 逐项说明软件的全部性能。 ３ ＧＢ／Ｔ ２６８０５．５—２０１ １ ５．３．６．２时间特性 定量说明软件的时间特性，例如：实时响应时间、采样时间、调节控制周期、处理时间（更新处理时 间、编译速度、通信速率、检索时间等）、数据传输与转换时间以及运行时间等。 ５．３．６．３精度 说明软件输出数据所能达到的精度，或者说明软件所能达到的控制精度。 ５．３．６．４可再入性 说明软件中的子程序能被中断并由中断它的程序再行进入，以及对中断它的程序和被中断的程序 能给出正确结果的能力。 ５．３．６．５灵活性 说明用户需求（如操作方式、运行环境、结果精度和时间特性等）有某些变化时，软件的适应能力。 ５．３．６．６可靠性 说明软件在确保其可靠性时所采取的技术措施。 ５．３．７安全 说明软件在安全方面的设计考虑，即说明如何对程序和数据进行保护以拒绝对它们的未经许可的 访问，还要说明在安全方面实际能达到的程度。 ５．３．８保密 描述为保证软件中数据记录的安全，能提供的保护机制和保密措施。 ５．４数据规格说明 ５．４．１输入数据规格说明 规定对输入数据的要求： ａ）描述包含在每一结构单元中的输入数据的内容及逻辑结构或数据格式； ｂ）描述数据对特定数据媒体的依赖性。 ５．４．２输出数据规格说明 ５．４．２．１数据描述 按描述输入数据时所用的同一方法，对每项输出数据的内容及格式进行描述。 ５．４．２．２输出媒体 描述记录输出数据的数据媒体（打印机、显示器、数码显示、网络终端等）的输出显示格式（例如采用 棒图显示）。最好给出若干打印或显示格式的实例。 注：输人与输出数据描述可以合并编写，例如对交互作用的软件。 ５．４．３中间数据 如果用户需要了解软件的工作情况，应描述中间数据的内容和格式。 ５．４．４文卷和记录格式 如果用户需要了解软件的工作情况，应描述文卷和记录的格式。 ５．４．５字符集或通信码 列出所采用的字符集或通信码，例如ＡＳＣ ＩＩ，ＢＣＤ等。 ５．４．６对数据或文卷的约束 描述对数据或文卷的各种限制，例如规定文卷能包含的最多记录数，对数值大小进行限制等。 ５．４．７数据加工 如果