ICS 25. 040. 40
中华人民共和国国家标准
GB/T26805.5-2011
工业控制计算机系统
第5部分：用户软件文档
Industrial control computer system-Software--Part 5:User software document2011-07-29发布
中华人民共和国国家质量监督检验检疫总局中国国家标准化管理委员会
2011-12-01实施
GB/T26805.5—2011
2规范性引用文件
3术语和定义
背景信息
用户软件文档的主要内容
5.1软件的标识
5.2用途和适用范围
程序规格说明
数据规格说明
操作环境
终端操作
应用举例
合同款项
安装与支持
置信度·
产品编号
参考文献
建筑321---标准查询下载网
wwwwiz321.net
GB/T26805《工业控制计算机系统软件》分为以下几部分：
第1部分：评价体系；
第2部分：测试方法；
第3部分：文档管理指南；
一第4部分：工程化文档规范；
第5部分：用户软件文档。
本部分是GB/T26805的第5部分。本部分由中国机械工业联合会提出。本部分由全国工业过程测量和控制标准化技术委员会(SAC/TC124)归口。本部分负责起草单位：西南大学。GB/T26805.5—2011
本部分参加起草单位：北京研华兴业电子科技有限公司、深圳市研祥软件技术有限公司、中国计算机学会工业控制计算机专业委员会。本部分主要起草人：黄巧莉、杨颂华、张为群、刘枫、吕静、张渝。本部分参加起草人：刘学东、刘永池、陈志列、程剑锋、杨孟飞。I
1范围
工业控制计算机系统软件
第5部分：用户软件文档
GB/T26805.5—2011
GB/T26805的本部分规定了工业控制软件的用户软件文档应提供的各类信息，以便指导该类文档的编制。
本部分适应于工业控制软件的用户软件文档编制。2规范性引用文件
下列文件中的条款通过GB/T26805的本部分的引用而成为本部分的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容或修订版均不适用于本部分，然而，鼓励根据本部分达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本部分。
GB/T8567一2006计算机软件文档编制规范3术语和定义
GB/T8567一2006确立的以及下列术语和定义适用于GB/T26805的本部分。3.1
工业控制软件industrialcontrolsoftware适用于工业过程测量和控制的专用软件。除具备数据处理软件的一般特点外，应具有更高的实时性、并发性、高可靠性和可维护性等特点。3.2
industrialprocess
工业过程
基本完成一个或一系列物理变化或化学变化的一组运行。[GB/T17212—1998的.P1.0.0.06]注：其他过程和物质或能量的输送和/或暂时贮存、信息的传输可看作是工业过程的一部分。3.3
过程测量
processmeasurement
确定各过程变量值的信息获取。[GB/T17212—1998的P1.0.0.09]3.4
process control
过程控制
为达到规定的目标而对影响过程状况的变量的操纵。[GB/T17212-1998的P1.0.0.10]
文档document
一种数据媒体和其上所记录的数据。它具有永久性并可以由人或机器阅读。［GB/T11457—2006的2.495]
软件文档softwaredocumentation以人们可读的形式出现的技术数据和信息。包括计算机列表和打印输出，它们描述或规定软件设建筑321---标准查询下载网
wwjz321.net
GB/T26805.5—2011
计或细节，说明软件具备的能力，或为使用软件以便从软件系统得到所期望的结果而提供的操作指令。[GB/T11457-—2006的2.1493]
用户文档集
userdocumentation
一套文档，它为使用系统或部件以期获得所希望结果的最终用户提供系统指令方面的信息。[GB/T11457—2006的2.1089]
user software documentation
用户软件文档
用以提供软件的标识、用途和适用范围、功能规格说明、数据规格说明、操作环境等综合信息的一类用户文档。
委托单位entrustment company
亦称交办单位。指为用户软件的开发提供资金，并且通常（但并非绝对)提出软件需求的单位。3.10
承办单位undertaker
从事用户软件的开发、研制的单位。4背景信息
在编制用户软件文档时，应提供以下背景信息：a）开发软件的委托单位，承办单位和协作单位（如果有的话)；描述软件的设计层次和设计方法，指出软件所具有的显著特点，以及是否计划进行修改等；b)
说明软件能够提供的产品形式，例如提供光盘和文档手册等；c）
列出与用户软件文档有关的辅助文档的清单(例如程序员指南，安装指南），列出这些文档资d)
料的作者、标题、序号、发表日期和出版单位，并说明如何取得这些文档；给出用户软件文档中用到的、可能引起混淆的专门术语的定义，对略语和缩写词要注明原文。e）
5用户软件文档的主要内容
5.1软件的标识
5.1.1概述
软件的标识包括提供软件名、版本和日期、派生软件和关键字等内容。对软件名、版本和日期以及派生软件，建议进行显示。
5.1.2软件名bzxZ.net
提供用以标识软件的标号和名称，还要提供描述软件主要功能的子标号。5.1.3版本和日期
5.1.3.1版本
提供软件的版本标识（版本、修订本、版本号和发行号），还要提供版本数字序号的简要说明。它应包括适用于这些项的保密性和私密性要求，处理它们的安全措施和关于复制和许可证条款的说明和制约。软件版本的标识应符合GB/T8567一2006中7.22的规范性要求。5.1.3.2日期
提供原版本和现行版本的出版日期。5.1.4派生软件
对同时流行但又有不少差别的同类软件需提供辅助标识，例如说明是否运行于不同的设备或操作系统。
5.1.5关键字
可以用来描述软件的特征以及进行查询和实现检索的描述符或关键字。5.2用途和适用范围
5.2.1用途
简述软件的用途。
5.2.2适用范围
GB/T26805.5-—2011
简述软件的各种功能以及在应用方面的限制，以便使委托单位或用户能够决定是否满足其软件需求，因而决定是否采用。
5.3程序规格说明
5.3.1问题描述
综合描述软件中每一程序所要解决的问题。5.3.2问题求解
5.3.2.1约定和术语
给出用户软件文档所用到的各项规则的细节，例如：a）约定在求解问题时所用字符或符号的含义；约定字符和符号组合后的特定含义；b）
指明所使用的前缀、后缀、符号、精度、舍人、坐标系统、值域和缩写表的含义；c
d）约定各种技术规则的含义等。5.3.2.2求解问题的原理和算法
描述与指定功能有关以及与程序的结构组织有关的解题方法和算法以及参考文献。5.3.3程序结构
按所指定的解题方法，描述程序单元的组织，例如：a）程序；
b）子程序；
c）模块；
d）程序段；
e）公共存储区。
可以按图解方式表示，例如：
a）采用树形结构图；
b）采用适当的文字结构描述；
c）必须包括单元名描述，描述它们的人口、出口，以及它们之间的相互关系。5.3.4程序规模
按常用单位，例如字节数或源代码行数，指出程序的总规模。5.3.5功能规格说明
5.3.5.1功能
逐项说明软件中每一程序所具备的各项功能及其极限范围。5.3.5.2出错和恢复
a）指出软件可能产生的出错信息的种类和采用的出错处理方法；b）指出为确保再启动和恢复，用户必须遵循的处理规则和详细步骤。5.3.6性能
5.3.6.1概述
逐项说明软件的全部性能。
建筑321---标准查询下载网
wjz321.net
GB/T26805.5—2011
5.3.6.2时间特性
定量说明软件的时间特性，例如：实时响应时间、采样时间、调节控制周期、处理时间（更新处理时间、编译速度、通信速率、检索时间等）、数据传输与转换时间以及运行时间等。5.3.6.3精度
说明软件输出数据所能达到的精度，或者说明软件所能达到的控制精度。5.3.6.4可再入性
说明软件中的子程序能被中断并由中断它的程序再行进入，以及对中断它的程序和被中断的程序能给出正确结果的能力。
5.3.6.5灵活性
说明用户需求(如操作方式、运行环境、结果精度和时间特性等)有某些变化时，软件的适应能力。5.3.6.6可靠性
说明软件在确保其可靠性时所采取的技术措施。5.3.7安全
说明软件在安全方面的设计考虑，即说明如何对程序和数据进行保护以拒绝对它们的未经许可的访问，还要说明在安全方面实际能达到的程度。5.3.8保密
描述为保证软件中数据记录的安全，能提供的保护机制和保密措施。5.4数据规格说明
5.4.1输入数据规格说明
规定对输人数据的要求：
a）描述包含在每一结构单元中的输入数据的内容及逻辑结构或数据格式；b）描述数据对特定数据媒体的依赖性。5.4.2输出数据规格说明
5.4.2.1数据描述
按描述输人数据时所用的同一方法，对每项输出数据的内容及格式进行描述。5.4.2.2输出媒体
描述记录输出数据的数据媒体（打印机、显示器、数码显示、网络终端等）的输出显示格式（例如采用棒图显示）。最好给出若干打印或显示格式的实例。注：输人与输出数据描述可以合并编写，例如对交互作用的软件。5.4.3中间数据
如果用户需要了解软件的工作情况，应描述中间数据的内容和格式。5.4.4文卷和记录格式
如果用户需要了解软件的工作情况，应描述文卷和记录的格式。5.4.5字符集或通信码
列出所采用的字符集或通信码，例如ASCI,BCD等。5.4.6对数据或文卷的约束
描述对数据或文卷的各种限制，例如规定文卷能包含的最多记录数，对数值大小进行限制等。5.4.7数据加工
如果需用其他设备或软件去加工适用于软件的输人数据，则需列出这些需求，例如列出文卷生成方式。
5.4.8数据备份
描述创建和保留备份数据的过程，这些备份数据在发生错误、缺陷、故障或事故时可以用来代替主要的数据拷贝。
5.5操作环境
5.5.1语言
GB/T26805.5—2011
如果用户希望能与其他软件联用或对软件所提供的源代码稍加修改，则需指出所用的程序设计语言，最好列出所参考的标准文本，提供文本的名称、派生文本、版本以及如何取得编译程序或解释程序。还要指出与标准文本不相符合的内容。5.5.2其他软件需求
说明为运行软件所需要的支持软件。例如操作系统及子例程的名称、版本、日期、数据库管理系统的名称和版本等。
列出相应的参考文档。
5.5.3硬件需求
指出运行软件所需的最小硬件配置和布署，最好给出配置和布署的文档以及其他相应的参考文档，例如配置图、布署图等。
5.5.4运行
5.5.4.1访问控制
提供用户可见的软件访问与保密性特点的概述。访问控制应包括以下内容：a）怎样获得和从谁哪里获得口令；b）如何在用户的控制下添加、删除或变更口令；c）与用户生成的输出报告及其他媒体的存储和标记有关的保密性和私密性要求。5.5.4.2控制命令
提供一份运行软件所需的所有控制命令的清单，对命令的格式及功能进行说明。5.5.4.3运行方法
对所有可能的工作方式，提供实现每一程序的起动、停止、暂停、中断和再起动的命令，包括提供对数据文卷的操作规则。
5.5.4.4操作员信息
如果所显示的信息本身是未予解释的，对所有这些信息，包括所需的操作员工作命令，需要提供一份清单并进行解释。
5.5.4.5运行准备
提供在使用软件以前所需的工作命令，例如主文卷数据输人方法，打印机安装规格说明。5.5.4.6备用拷贝的生成
如果允许生成备用拷贝，描述如何生成程序备用拷贝的方法。5.5.5通信
5.5.5.1与其他系统的通信
描述通信接口，例如描述主计算机端的有关信息或网络的有关信息，如波特率。5.5.5.2通信协议
提供与所采用的通信协议有关的信息，例如采用二进制同步通信协议，高级数据链路通信协议等。5.6终端操作
5.6.1操作前提
说明终端的配置构成，连接步骤、数据和参数输入步骤以及控制规定等。5.6.2操作
说明在终端上进行查询、检索、参数设定和修改数据文卷的能力与过程。5.7应用举例
提供有助于用户了解软件工作的典型示例。在这些示例中，应包括对数据的列表与显示，以及对结果进行检查等有关内容。
wiz321.net
建筑321---标准查询下载网
GB/T26805.5—2011
合同款项
提供有关合同款项的足够信息，常用的包括：a)
有关版权、保密、安全的法定条件和条款，例如是否允许软件或文档拷贝；b）
软件能提供的产品形式；
安装；
培训；
e）维护；
f）质量保证。
5.9安装与支持
5.9.1安装
提供软件安装所需的全部技术信息。5.9.2修改
向用户提供修改软件所需的足够信息，例如使软件用于其他环境或改作其他用途时所需的信息。5.9.3测试
描述用以测试程序的方法，例如通过对输入进行取样测试是否能得到预期的输出。5.9.4支持
提供有关支持的可用性和实现软件开发的辅助信息。5.10置信度
提供从事软件的支持、维护和进一步开发的组织、单位或个人的名称、姓名及通讯地址。5.11标准
列出所遵循的标准名称、标准号及年代号。5.12产品编号
提供软件的产品编号。
GB/T11457-2006
GB/T17212—1998
参考文
信息技术软件工程术语
GB/T26805.5—2011
工业过程测量和控制
可术语和定义[idtIEC60902：1987]建筑321---标准查询下载网
wwjz321.net
GB/T26805.5-2011
打印日期：2011年12月9日F009A中华人民共和
国家标准
工业控制计算机系统
第5部分：用户软件文档
GB/T26805.5—2011
中国标准出版社出版发行
北京复兴门外三里河北街16号
邮政编码：100045
网址 www.spc.net.cn
电话：6852394668517548
中国标准出版社秦皇岛印刷厂印刷各地新华书店经销
开本880×12301/16
：印张0.75字数15千字
2011年11月第一版
2011年11月第次印刷
书号：155066·1-43726定价16.00元如有印装差错由本社发行中心调换版权专有侵权必究
举报电话：(010)68533533