Evaluation of maintainability enhancement for TCP/TSP revision 6.0 update .20

摘要

ABSTRACT (Continue on reveree elde if neceeemry end Identity by block number)A system of documentation which was designed to aid programmers of theCommand and Control System Maintenance Agency (CCSMA) in maintaining theTrident Command and Control System software was evaluated. This system iscalled "Maintainability Enhancement for TCP/TSP Revision 6.0 Update .20" orsimply 6.0/. 20. It is essentially a hierarchical method of charting softwareprocedures and the relationship between procedures. The difficulty of tryingto overlay a structured documentation technique on programs which areinherently non-structured (written in low-level language and patched) is discussed. Discrepancies which arose between the newly constructed chartsand the original listings are highlighted. A conclusion of this study isthat rather than improving clarity, applying structured documentation tonon-structured programs may result in the opposite effect—incomplete,inconsistent, and ambiguous documentation—because a hierarchical formatcannot adequately represent a non-hierarchical program.SECNAVINST 3560.1 and MIL-STD 1679 (Navy) are considered by CCSMA to berelevant documents for maintenance purposes. Therefore, the documentationsystem was checked for conformance with applicable sections of 3560.1 and1679. In addition, the documentation system was compared with applicablesections of FIPS PUB 38, published by the National Bureau of Standards.Although officially FIPS PUB 38 applies to ADP and not to embedded computersystems, it provides good guidelines for program documentation and maintenance.It was found that 6.0/. 20 does not include coverage of many of theapplicable sections of the three documents.