首页   当前位置:全部素材 > 规范图集 > 图标图集

GB/T26805.5-2011工业控制计算机系统软件第5部分:用户软件文档1范围GB/T26805的本部分规定了工业控制软件的用户软件文档应提供的各类信息,以便指导该类文档的编制。本部分适应于工业控制软件的用户软件文档编制。2规范性引用文件下列文件中的条款通过GB/T26805的本部分的引用而成为本部分的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本部分,然而,鼓励根据本部分达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本部分。GB/T8567一2006计算机软件文档编制规范3术语和定义GB/T8567一2006确立的以及下列术语和定义适用于GB/T26805的本部分。3.1工业控制软件industrial control software适用于工业过程测量和控制的专用软件。除具备数据处理软件的一般特点外,应具有更高的实时性、并发性、高可靠性和可维护性等特点。3.2工业过程industrial process基本完成一个或一系列物理变化或化学变化的一组运行。[GB/T17212-1998的P1.0.0.06]注:其他过程和物质或能量的输送和/或暂时贮存、信息的传输可看作是工业过程的一部分。3.3过程测量process measurement确定各过程变量值的信息获取。[GB/T17212-1998的P1.0.0.093.4过程控制process control为达到规定的目标而对影响过程状况的变量的操纵。[GB/T17212-1998的P1.0.0.10]3.5文档document一种数据媒体和其上所记录的数据。它具有永久性并可以由人或机器阅读。[GB/T11457-2006的2.495]3.6软件文档software documentation以人们可读的形式出现的技术数据和信息。包括计算机列表和打印输出,它们描述或规定软件设霸Z.ZC.ET
GB/T26805.5-2011计或细节,说明软件具备的能力,或为使用软件以便从软件系统得到所期望的结果而提供的操作指令。[GB/T11457-2006的2.1493]3.7用户文档集user documentation一套文档,它为使用系统或部件以期获得所希望结果的最终用户提供系统指令方面的信息。[GB/T11457-2006的2.1089]3.8用户软件文档user software documentation用以提供软件的标识、用途和适用范围、功能规格说明、数据规格说明、操作环境等综合信息的一类用户文档。3.9委托单位entrustment company亦称交办单位。指为用户软件的开发提供资金,并且通常(但并非绝对)提出软件需求的单位。3.10承办单位undertaker从事用户软件的开发、研制的单位。4背景信息在编制用户软件文档时,应提供以下背景信息:a)开发软件的委托单位,承办单位和协作单位(如果有的话);b)描述软件的设计层次和设计方法,指出软件所具有的显著特点,以及是否计划进行修改等;?)说明软件能够提供的产品形式,例如提供光盘和文档手册等;d)列出与用户软件文档有关的辅助文档的清单(例如程序员指南,安装指南),列出这些文档资料的作者、标题、序号、发表日期和出版单位,并说明如何取得这些文档;?)给出用户软件文档中用到的、可能引起混滑的专门术语的定义,对略语和缩写词要注明原文。5用户软件文档的主要内容5.1软件的标识5.1.1概述软件的标识包括提供软件名、版本和日期、派生软件和关键字等内容。对软件名、版本和日期以及派生软件,议进行显示。5.1.2软件名提供用以标识软件的标号和名称,还要提供描述软件主要功能的子标号。5.1.3版本和日期5.1.3.1版本提供软件的版本标识(版本、修订本、版本号和发行号),还要提供版本数字序号的简要说明。它应包括适用于这些项的保密性和私密性要求,处理它们的安全措施和关于复制和许可证条款的说明和制约。软件版本的标识应符合GB/T8567一2006中7.22的规范性要求。5.1.3.2日期提供原版本和现行版本的出版日期。5.1.4派生软件对同时流行但又有不少差别的同类软件需提供辅助标识,例如说明是否运行于不同的设备或操作系统。2霸Z.ZC.ET
GB/T26805.5-20115.1.5关键字可以用来描述软件的特征以及进行查询和实现检索的描述符或关键字。5.2用途和适用范围5.2.1用途简述软件的用途。5.2.2适用范围简述软件的各种功能以及在应用方面的限制,以便使委托单位或用户能够决定是否满足其软件需求,因而决定是否采用。5.3程序规格说明5.3.1问题描述综合描述软件中每一程序所要解决的问题。5.3.2问题求解5.3.2.1约定和术语给出用户软件文档所用到的各项规则的细节,例如:a)约定在求解问题时所用字符或符号的含义;b)约定字符和符号组合后的特定含义;?)指明所使用的前缀、后缀、符号、精度、舍入、坐标系统、值域和缩写表的含义;d)约定各种技术规则的含义等。5.3.2.2求解问题的原理和算法描述与指定助能有关以及与程序的结构组织有关的解题方法和算法以及参考文献。5.3.3程序结构白可定儿票的解翘按所指定的解题方法,描述程序单元的组织,例如:a)程序;b)子程序;c)模块:d)程序段;e)公共存储区。可以按图解方式表示,例如:a)采用树形结构图:b)采用适当的文字结构描述;?)必须包括单元名描述,描述它们的入、出,以及它们之间的相互关系。5.3.4程序规模按常用单位,例如字节数或源代码行数,指出程序的总规模。5.3.5功能规格说明5.3.5.1功能逐项说明软件中每一程序所具备的各项功能及其极限范围。5.3.5.2出错和恢复a)指出软件可能产生的出错信息的种类和采用的出错处理方法;b)指出为确保再启动和恢复,用户必须遵循的处理规则和详细步骤。5.3.6性能5.3.6.1概述逐项说明软件的全部性能。筑Z.Z0
GB/T26805.5-20115.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)描述包含在每一结构单元中的籥人数据的内容及逻辑结构或数据格式,Eb)描述数据对特定数据媒体的依赖性。5.4.2输出数据规格说明5.4.2.1数据描述按描述输人数据时所用的同一方法,对每项输出数据的内容及格式进行描述。5.4.2.2输出媒体描述记录输出数据的数据媒体(打印机、显示器、数码显示、网络终端等)的输出显示格式(例如采用棒图显示)。最好给出若干打印或显示格式的实例。注:输人与输出数据描述可以合并编写,例如对交互作用的软件,5.4.3中间数据如果用户需要了解软件的工作情况,应描述中间数据的内容和格式。5.4.4文卷和记录格式如果用户需要了解软件的工作情况,应描述文卷和记录的格式。5.4.5字符集或通信码列出所采用的字符集或通信码,例如AII,BCD等。5.4.6对数据或文卷的约束描述对数据或文卷的各种限制,例如规定文卷能包含的最多记录数,对数值大小进行限制等。5.4.7数据加工如果需用其他设备或软件去加工适用于软件的输人数据,则需列出这些需求,例如列出文卷生成方式。5.4.8数据备份描述创和保留备份数据的过程,这些备份数据在发生错误、缺陷、故障或事故时可以用来代替主要的数据拷贝。霸Z.ZC.ET
GB/T26805.5-20115.5操作环境5.5.1语言如果用户希望能与其他软件联用或对软件所提供的源代码稍加修改,则需指出所用的程序设计语言,最好列出所参考的标准文本,提供文本的名称、派生文本、版本以及如何取得编译程序或解释程序。还要指出与标准文本不相符合的内容。5.5.2其他软件需求说明为运行软件所需要的支持软件。例如操作系统及子例程的名称、版本、日期、数据库管理系统的名称和版本等。列出相应的参考文档。5.5.3硬件需求指出运行软件所需的最小硬件配置和布署,最好给出配置和布署的文档以及其他相应的参考文档,例如配置图、布署图等。5.5.4运行5.5.4.1访问控制提供用户可见的软件访问与保密性特点的概述。访问控制应包括以下内容:a)怎样获得和从谁哪里获得令;b)如何在用户的控制下添加、删除或变更令;?)与用户生成的输出报告及其他媒体的存储和标记有关的保密性和私密性要求。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应用举例提供有助于用户了解软件工作的典型示例。在这些示例中,应包括对数据的列表与显示,以及对结果进行检查等有关内容。5霸Z.ZC.ET
评星:
  • 0
  • 0

作品评论(0)

登录 后参与讨论
相关推荐:
本站所有资源由用户上传,仅供学习和交流之用;未经授权,禁止商用,否则产生的一切后果将由您自己承担!素材版权归原作者所有,如有侵权请立即与我们联系,我们将及时删除
浏览:118 次数:3
下载:免费下载 收藏:0
等级:
编号:200372 3
文件格式:pdf文本
文件大小:207.27KB
投稿:1001 进入
上传时间:2022/8/15 18:52:05
如有侵权请联系删除

您可能在找这些:

网站首页 典尚平台 建筑素材 三维模型 室内装修 视频素材网 上传教程 帮助中心 热门搜索 版权申明 关于我们 联系典尚

Copyright © 2000-2020 www.jzsc.net.粤ICP备07047611号 All Rights Reserved.

客服QQ:609470690 客服电话:0755-83549300 深圳市典尚风设计有限公司

Copyright© 2016典尚平台 JZSC.NET

网站推荐使用腾讯、Chrome浏览器浏览,不推荐360,很卡

粤公网安备 44030302000908号

QQ咨询
推广分享
×
复制本页url网址

推广详情

如您已登录,分享网址将自动加载您的推广编号,您将获得2元/注册用户的奖励。

推广记录  积分记录

网站首页
回顶部