程序维护手册范例.doc

程序维护手册1. 引言 编写目的 软件维护是软件生命周期的最后一个阶段，它处于系统投入生产性运行以后的时期中,因此不属于系统开发过程。软件维护需要的工作量非常大，虽然在不同应用领域维护成本差别很大，但是，平均说来，大型软件的维护成本高达开发成本的四倍左右。目前国外许多软件开发组织把60%以上的人力用于维护已有的软件，而且随着软件数量增多和使用寿命延长，这个百分比还在持续上升。软件维护就是在软件已经交付使用之后，为了改正错误或者满足新的需要而修改软件的过程。它有如下几种性质的维护：l 改正性维护 因为软件测试不可能暴露出一个大型软件系统中所有潜藏的错误，所以在使用期间，用户必然会发现程序错误，并且把他们遇到的问题报告给维护人员。我们把诊断和改正错误的过程称为改正性维护。l 适应性维护 计算机科学技术领域的各方面都在迅速进步，需要经常地修改版本。为了和变化了的环境适当地配合而进行的修改软件的活动称为适应性维护。l 完善性维护 在软件编写完成之后，投入实践，在使用软件的过程中，用户往往提出增加新功能或修改已有的功能的建议，这就需要进行完善性维护。l 预防性维护为了改进未来的可维护性或可靠性，或为了给未来的改进奠定更好的基础而修改软件时，就需要进行预防性维护。 维护的过程本质上是修改和压缩了的软件定义和开发过程，而且事实上远在提出一项维护要求之前，与软件维护有关的工作已经开始了。 鉴于以上各点，编写维护软件的文档十分重要。它给软件维护人员提供了一份完整，清晰的说明文档，便于其快速有效地进行维护工作。 开发单位 项目的提出者： 开发者： 用户：使用场所： 定义和缩写a. 数据流图描绘系统的逻辑模型，图中没有任何具体的物理元素，只是描绘信息在系统中流动和处理的情况，它表示了数据和处理过程的关系。数据流图有四种基本符号：l 正方形（或立方体）表示数据的源点或终点。l 圆角矩形（或圆形）代表变换数据的处理。 处理不一定是一个程序。一个处理框可以代表一系列程序，单个程序或者程序的 一个模块；它甚至可以代表一种人工处理过程。l 开口矩形（或两条平行横线）代表数据存储。 数据存储可以表示一个文件，文件的一部分，数据库的元素或纪录的一部分等等。 数据存储是处于静止状态的数据。 l 箭头代表数据流，即特定数据的流动方向。数据流是处于运动中的数据。 还有几种附加符号：l 星号表示数据流之间是“与”关系l 加号表示“或”关系l 异或符号表示只能从中选一个b. 数据字典(Data Dictionary，简称DD)是对系统中各类数据描述的集合，是各类数据属性清单，是进行详细的数据收集和数据分析所获得的主要结果。它通常包括以下五个部分：l 数据项，是数据的最小的单位。l 数据结构，是若干数据项有意义的集合。l 数据流，可以是数据项，也可以是数据结构，表示某一处理过程的输入或输出。l 数据存储，处理过程中存取的数据。常常是手工凭证，手工文档，计算机文件。l 处理过程。它们的描述内容如下：1 数据项描述=数据项名，数据项含义说明，别名，类型，长度，取值范围，与其他数据项的逻辑关系取值范围，与其他数据项的逻辑关系定义了数据的完整性约束条件，是设计数据检验功能的依据。2 数据结构描述=数据结构名，含义说明，组成：数据结构或数据项3 数据流=数据流名，说明，流出过程，流入过程，组成：数据结构或数据项l 流出过程，说明该数据流由什么过程来。l 流入过程，说明该数据流到什么过程去。4 数据存储=数据存储名，说明，输入数据流 ，输出数据流，组成：数据结构或数据项，数据量，存取方式l 数据量，说明每次存取多少数据，每天（或每小时，或每周）存取几次的信息。l 存取方法，指的是批处理，还是联机处理；是检索还是更新；是顺序检索还是随机检索；尽可能详细收集并加以说明。5 处理过程=处理过程名，说明，输入：数据流，输出：数据流，处理：简要说明 简要说明中主要说明该处理过程的功能，即“做什么”（不是怎么做）；处理频度要 求，如每小时（或每分钟）处理多少事务，多少数据量；响应时间要求等。这些处理要求是后面物理设计的输入及性能评价的标准。d. 主键：数据库表中的关键域。值互不相同。e. 外部主键：数据库表中与其他表主键关联的域。f. 系统：若未特别指出，统指本机票预定系统。g. SQL: Structured Query Language（结构化查询语言），一种用于访问查询数据库的语言h. SQL SERVER: 系统服务器所使用的数据库管理系统（DBMS）。i. ATM: Asynchronous Transfer Mode (异步传输模式)。j. ROLLBACK: 数据库的错误恢复机制。 参考资料书籍：软件工程导论第三版张海藩 清华大学出版社实用软件工程第二版郑人杰 殷人昆 陶永雷 清华大学出版社 文档： 需求规格说明书，概要设计说明书，详细设计说明书，用户操作手册。2. 系统说明 系统用途 输入：输出：功能： 安全保密 系统提供一定的方式让用户表示自己的身份，系统进行核实，通过鉴定后才提供 机器使用权。常用的方法有：1 用一个用户名或用户标识号来标识用户身份。2 口令。3 系统提供一个随机数，用户根据预先约定好的某一过程或者函数进行计算，系统根据用户计算结果是否正确进一步鉴定用户身份。 系统管理员还可对获得上机权的用户进行权限控制，是不同的用户对于不同的数据对象有不同的操作权限。 总体说明系统的总体功能：系统接收输入的预定机票的旅客信息，为旅客安排航班，印出取票通知和帐单，旅客在飞机起飞的前一天凭取票通知和帐单交款取票，系统校对无误即印出机票给旅客。系统的具体功能：1 接受：旅客信息及取票通知和帐单；2 打印：取票通知和帐单及机票；3 网络输出和加密，输入和解密；4 分辨信息的种类并采取相应的处理步骤；5 判断信息的正误并采取相应的处理步骤；6 进行数据库的查询、修改工作；7 接受并判断错误，输出相应的出错消息； 程序说明1. PersInfoExam 过程： 对在旅客信息界面中输入的各项信息进行初步检验。若发现错误，令 ErrorAppear=T,判断错误类型，并将相应的 错误类型ErrorType或ErrorRank作为参数，转入ErrorHandle过程。若未发现错误，转入PersInfoInput过程。其中的错误种类有：1.数据类型不匹配,ErrorType =T; 姓名 string 旅行目的地 string 性别 string 旅行时间 date 工作单位 string (年/月/日 yy/mm/dd) 身份证号码 long int 2、数据超出规定范围ErrorRank =T;等等 性别只能是男或女；身份证号码按规定必须是13位；旅行时间必须在 定票的当天过一天以后等等2、PersInfoInput 过程： 经检验无误后，将输入界面表单中的数据输入到Class PersInfo Class PersInfo /* 伪码 */ String name= 姓名 ； String sex= 性别； String company= 工作单位； Long int idcode= 身份证号码； Date stime= 旅行时间； （syear/smonth/stime=年/月/日） String denist= 目的地 2操作环境 设备共享一个数据库的若干台电脑，台式打印机若干。 支持软件支持常用的数据库应用软件：VISUAL FOXPRO 5.0 , DELPHI 4.0, POWER BUILDER 6.0 数据库 标识符：姓名，性别，工作单位，身份证号码，旅行时间，旅行目的地。 静态数据：存储在硬盘上的数据。 动态数据：正处于处理过程中的数据。 数据库的存储媒体：硬盘。 3. 维护过程 规则1 设计原则1 密切结合结构（数据）设计和行为（处理）设计。 2有机结合硬件，软件，技术和管理的界面。 3具体程序实现过程中，对记录，字段的引用参照PersInfo 类。 4存储区的标识符也参照PersInfo 类。 5在设计过程中参照瀑布模型，ER模型，层次图，Jackson 程序设计方法。2设计程序变更的准则1 检查可供选择的设计方案，寻找一种与程序的原始设计原理相容的变更设计。2 努力使设计简化。3 能满足可变性要求的设计。4 不降低程序质量。5 用可测试的并具备测试方法的术语描述设计。6 考虑处理时间，存储量和操作过程方面的变化。7 考虑标更对用户服务的干扰以及实施变更的代价与时间。3修改程序代码的准则1 必须要先熟悉整个程序的控制流程。2 不要做不必要的修改。3 不影响原始程序的风格和相容性。4 记录所作过的修改。5 审查软件质量是否符合标准。6 更新程序文档以反映修改并保留修改前的程序代码版本。4重新验证程序的准则1 首先测试程序故障，然后测试程序的未改动部分，最后测试程序的修改部分。2 不允许做修改的维护程序员成为唯一的重新验证程序的人。3 鼓励终端用户参与到重新测试进程中来。4 在重新验证进程中，记录出错的次数与类型，并把结果同所提供的测试功能进行比较，以便估量出程序是否退化。 验证过程 每当软件被修改后，都要校验其正确性。维护员应该有选择地作些重新测试工作，不仅要证实新的逻辑的正确性，而且要校验实程序的为修改部分是否无损害，并且整个程序运行正确。若发现错误，则要马上进行修正。 出错及纠正方法 经查询还有余票，但输入旅客信息后却发现已没有余票。发生这种情况的原因是：有多台计算机同时输入订购同一次航班的旅客信息，在查询余票时，其他输入信息并未写入磁盘，票数并未修改。此时，应该等待数秒后重新查询余票。 专门维护过程 系统运行一段时间后，由于记录的不断增加，删除和修改，会使数据库的物理存储变坏。例如，逻辑上属于同一记录型或同一关系的数据被分散到了不同的文件或文件的多个碎片上。这样就会降低数据库存储空间的利用率和数据的访存效率，使数据库的性能下降。这是就要进行数据库的重组织。在重组过程中，按原设计要求重新安排记录的存储位置，调整数据区和溢出区，回收“垃圾”，减少指针链等。 程序清单及流程图详见概要设计和详细设计文档。其中专业理论知识内容包括：保安理论知识、消防业务知识、职业道德、法律常识、保安礼仪、救护知识。作技能训练内容包括：岗位操作指引、勤务技能、消防技能、军事技能。二培训的及要求培训目的安全生产目标责任书为了进一步落实安全生产责任制，做到“责、权、利”相结合，根据我公司2015年度安全生产目标的内容，现与财务部签订如下安全生产目标：一、目标值：1、全年人身死亡事故为零，重伤事故为零，轻伤人数为零。2、现金安全保管，不发生盗窃事故。3、每月足额提取安全生产费用，保障安全生产投入资金的到位。4、安全培训合格率为100%。二、本单位安全工作上必须做到以下内容： 1、对本单位的安全生产负直接领导责任，必须模范遵守公司的各项安全管理制度，不发布与公司安全管理制度相抵触的指令，严格履行本人的安全职责，确保安全责任制在本单位全面落实，并全力支持安全工作。 2、保证公司各项安全管理制度和管理办法在本单位内全面实施，并自觉接受公司安全部门的监督和管理。 3、在确保安全的前提下组织生产，始终把安全工作放在首位，当“安全与交货期、质量”发生矛盾时，坚持安全第一的原则。 4、参加生产碰头会时，首先汇报本单位的安全生产情况和安全问题落实情况；在安排本单位生产任务时，必须安排安全工作内容，并写入记录。 5、在公司及政府的安全检查中杜绝各类违章现象。 6、组织本部门积极参加安全检查，做到有检查、有整改，记录全。 7、以身作则，不违章指挥、不违章操作。对发现的各类违章现象负有查禁的责任，同时要予以查处。 8、虚心接受员工提出的问题，杜绝不接受或盲目指挥；9、发生事故，应立即报告主管领导，按照“四不放过”的原则召开事故分析会，提出整改措施和对责任者的处理意见，并填写事故登记表，严禁隐瞒不报或降低对责任者的处罚标准。 10、必须按规定对单位员工进行培训和新员工上岗教育；11、严格执行公司安全生产十六项禁令，保证本单位所有人员不违章作业。 三、 安全奖惩： 1、对于全年实现安全目标的按照公司生产现场管理规定和工作说明书进行考核奖励；对于未实现安全目标的按照公司规定进行处罚。 2、每月接受主管领导指派人员对安全生产责任状的落