JPH01233621A - Program specification preparing system - Google Patents

Program specification preparing system

Info

Publication number
JPH01233621A
JPH01233621A JP6262288A JP6262288A JPH01233621A JP H01233621 A JPH01233621 A JP H01233621A JP 6262288 A JP6262288 A JP 6262288A JP 6262288 A JP6262288 A JP 6262288A JP H01233621 A JPH01233621 A JP H01233621A
Authority
JP
Japan
Prior art keywords
program
section
reading
file
program specification
Prior art date
Legal status (The legal status is an assumption and is not a legal conclusion. Google has not performed a legal analysis and makes no representation as to the accuracy of the status listed.)
Pending
Application number
JP6262288A
Other languages
Japanese (ja)
Inventor
Toshifumi Aoki
青木 敏文
Current Assignee (The listed assignees may be inaccurate. Google has not performed a legal analysis and makes no representation or warranty as to the accuracy of the list.)
NEC Solution Innovators Ltd
Original Assignee
NEC Software Chubu Ltd
Priority date (The priority date is an assumption and is not a legal conclusion. Google has not performed a legal analysis and makes no representation as to the accuracy of the date listed.)
Filing date
Publication date
Application filed by NEC Software Chubu Ltd filed Critical NEC Software Chubu Ltd
Priority to JP6262288A priority Critical patent/JPH01233621A/en
Publication of JPH01233621A publication Critical patent/JPH01233621A/en
Pending legal-status Critical Current

Links

Landscapes

  • Stored Programmes (AREA)

Abstract

PURPOSE:To obtain a program specification without a miss by editing data necessary for the preparation of the program specification based on read source program information and defining a graphic form and a ruled line in the program specification. CONSTITUTION:After the processing of the respective reading parts of a program heading part reading part 5, an input/output section reading part 6, a file section reading part 6, a communication section reading part 8, a file opening reading part 9 and a subroutine reading part 10, a control part 4 sends a control command to an editing part 12 and a plotting control part 13, necessary data are read from a data holding part 11, and the preparation of a program specification is executed. Thus, the program specification, in which a program name, a file name necessary for it, a flowchart, etc., are clearly indicated, can be obtained by a printer 14.

Description

【発明の詳細な説明】 〔産業上の利用分野〕 本発明はソースプログラムからプログラム仕様書を作成
する方式に関する。
DETAILED DESCRIPTION OF THE INVENTION [Field of Industrial Application] The present invention relates to a method for creating a program specification from a source program.

〔従来の技術〕[Conventional technology]

システム開発作業においては、システム分析作業、概要
設計、基本設計、プログラム仕様書作成等の詳細設計、
プログラム製造、プログラム単体テスト、システムテス
トという順序に各作業が発生するわけであるが、このよ
うなシステム開発作業が完了した後に、システムのメン
テナンス作業が発生すると必ずプログラム仕様書の存在
が重要となってくる。プログラム仕様書が存在しないプ
ログラムがあると、そのプログラムに関係する前後のプ
ログラムとの関係がはっきりせず、システムのメンテナ
ンス上支障を来すからである。
In system development work, system analysis work, general design, basic design, detailed design such as program specification creation,
Each task occurs in the order of program production, program unit testing, and system testing, but after such system development work is completed, the existence of program specifications is always important when system maintenance work occurs. come. This is because if there is a program for which a program specification does not exist, the relationship between the program and the programs before and after it is not clear, which causes problems in system maintenance.

従来、プログラム仕様書は、テンプレートや定規等を使
用し手書きで作成するのが通例であう九。
Traditionally, program specifications have been created by hand using templates, rulers, etc.9.

この場合、通常は基本設計のドキュメントに基づいて作
成されるが、ドキュメントが完備されていなかったり、
より詳細なプログラム仕様書を必要とするときには、S
E等コンピュータ要員がプログラムソースリストやフロ
ーチャート等を参照しながら作成していた。
In this case, it is usually created based on the basic design document, but the document is not complete or
When more detailed program specifications are required, S
Computer staff such as E were creating the program while referring to the program source list, flowcharts, etc.

〔発明が解決しようとする課題〕[Problem to be solved by the invention]

上述した従来のプログラム仕様書作成方式は、コンピュ
ータ要員がプログラム仕様書を手書きで作成していたた
めに、ドキエメンテーション作業1こ時間がかかったり
、手書き作業であったため、作成者によりプログラム仕
様書の表現が異なり、しかもその作成や変更に対してミ
スが起こりやすく、作業時間のロスが多いという欠点が
ある。
In the conventional method of creating program specifications described above, computer personnel created the program specifications by hand, which required time for the documentation process. The disadvantage is that the expressions are different, and it is easy to make mistakes when creating or changing them, resulting in a lot of work time loss.

〔課題を解決するための手段〕[Means to solve the problem]

本発明のプログラム仕s書作成方式は、ソースプログラ
ム群のうちから予め指定されたソースプログラムを読み
取るプログラム読取手段と、該ソースプログラムに対す
るプログラム仕様書を作成するのに必要な予め定められ
ているソースプログラム情報を前記読み取られたソース
プログラムのうちから判読する情報判読手段と、該判読
されたソースプログラム情報に基づき、#紀プログラム
仕様書の作成に必要なデータを編集したり、前記グログ
ラム仕様書内の図形や罫線を定義する編集手段とを設け
たことから構成されている。
The program specification creation method of the present invention includes a program reading means for reading a prespecified source program from a group of source programs, and a predetermined source necessary for creating a program specification for the source program. an information reading means for reading program information from the read source program; and based on the read source program information, editing the data necessary for creating the program specification, This configuration includes editing means for defining figures and ruled lines.

〔実施例〕〔Example〕

次に、本発明について図面を参照して説明する。 Next, the present invention will be explained with reference to the drawings.

第1図は本発明の一実施例構成、第2図は本実施例で入
力されるコボル言語によるソースプログラムイメージフ
ァイルの内容の一例、第3図は本実施例により得られた
プログラム仕様書の一例を示す。
Fig. 1 shows the configuration of an embodiment of the present invention, Fig. 2 shows an example of the contents of a source program image file written in Kobol language input in this embodiment, and Fig. 3 shows the program specification obtained by this embodiment. An example is shown.

第1図において、1はソースプログラム送出部、2はプ
ログラム読取部、3はファイル部、4は制御部、5はプ
ログラム見出し部判読部、6は入出力節判読部、7はフ
ァイル節判読部、8は通信節判読部、9はファイル開設
判読部、10はサブルーチン判読部、12は編集部、1
3は作図制御部、11はデータ保持部、14はプリンタ
である。
In FIG. 1, 1 is a source program sending section, 2 is a program reading section, 3 is a file section, 4 is a control section, 5 is a program header section reading section, 6 is an input/output section reading section, and 7 is a file section reading section. , 8 is a communication section reading section, 9 is a file opening reading section, 10 is a subroutine reading section, 12 is an editing section, 1
3 is a drawing control section, 11 is a data holding section, and 14 is a printer.

ソースプログラム送出部1は、磁気テープ等に格納され
たソースプログラム群を送出し、プログラム読取部2は
、ソースプログラム送出部1から伝達されるソースプロ
グラム群のうちから、プログラム仕様書作成が予め指定
されているソースプログラムを選択的lこ読取り、ファ
イル部3はプログラム読取部2から出力されたソースプ
ログラムをファイル化する。
The source program sending unit 1 sends out a source program group stored on a magnetic tape or the like, and the program reading unit 2 specifies in advance that the program specifications should be created from among the source programs transmitted from the source program sending unit 1. The file section 3 selectively reads the source program that is being read, and the file section 3 converts the source program output from the program reading section 2 into a file.

制御部4は、プログラム仕様書を作成するために、以下
のような各種制御を行う制御部である。
The control unit 4 is a control unit that performs the following various controls in order to create a program specification.

プログラム見出し部判読部5は、プログラムの最初に伝
達される、第2図に例示されたようなPROGRAM−
ID文21で示されるプログラム名や、AUTHOR文
22で示文机2作成者名や、DATE−WRITTEN
文23で示される作成年月日や、注釈行24.25を解
析して業務名や処理概要を判読するものである。
The program header section reading section 5 reads a PROGRAM-- such as the one illustrated in FIG. 2, which is transmitted at the beginning of the program.
The program name shown in the ID statement 21, the name of the author of the writing desk 2 in the AUTHOR statement 22, and the DATE-WRITTEN
The creation date shown in the sentence 23 and the annotation lines 24 and 25 are analyzed to decipher the business name and processing outline.

入出力節判読部6は、上記プログラム見出し部を構成す
るPROGRAM−ID文21やAUTHOR文22や
D文机2−WRITTEN文23や注釈行24.25等
の後lこ伝達されるプログラム環境部入出力節の中の5
ELECT文26を判読するものであり、プログラムが
使用しているファイルの内部ファイル名や、ファイル構
成や、アクセス方法等プログラムが使用する外部媒体の
定義情報と実行プログラムと媒体間のデータ転送や処理
に関する情報を判読するものである。
The input/output clause reading section 6 reads the program environment section that is transmitted after the PROGRAM-ID statement 21, AUTHOR statement 22, D-written statement 2-WRITTEN statement 23, annotation line 24, 25, etc. that constitute the program header section. 5 in the input/output clause
It interprets the ELECT statement 26, including the internal file name of the file used by the program, the file structure, the access method, etc., and the definition information of the external medium used by the program, as well as the data transfer and processing between the execution program and the medium. It is used to decipher information related to

ファイル節判読部7は、上記プログラム環境部入出力節
の中の5ELECT文26の後に伝達さレルファイル節
27のファイルのレコード長、ブロック長の判読と、コ
ピー命令28の存在を検査するものである。
The file clause reading unit 7 reads the record length and block length of the file in the real file clause 27 that is transmitted after the 5ELECT statement 26 in the input/output section of the program environment section, and checks the existence of a copy command 28. be.

通信節判読部8は、プログラムと通信管理システム間で
情報交換を行うための通信領域情報の存在を通信節29
により検査するものである。
The communication clause reading unit 8 detects the existence of communication area information for exchanging information between the program and the communication management system by checking the communication clause 29.
It is to be inspected by

ファイル開設判読部9は、プログラムの手読部において
、ファイルの入力用、出力用、入出力兼用、追加用のフ
ァイル開設時の0PEN命令30を解析するものである
The file opening reading section 9 is a manual reading section of the program that analyzes the 0PEN command 30 when opening a file for input, output, input/output, or addition.

サブルーチン判読部10は、プログラム手続部において
、ある実行単位の中のあるプログラムから他のプログラ
ムへ制御を移すCALL命令31を基に、プログラムが
使用しているサブルーチン名を判読するものである。
The subroutine reading unit 10 reads the name of a subroutine used by a program based on a CALL instruction 31 that transfers control from one program to another in a certain execution unit in the program procedure division.

データ保持部11は、上記プログラム見出し部判読部分
5.入出力節判読部、ファイル節判絖部7、通信部判読
部8.ファイル開設判読部9及びサブルーチン判読部1
0から出力されたデータ、例えば、プログラム名、内部
ファイル名、レコード長等が保持されるものである。
The data holding section 11 includes the program header reading section 5. Input/output section reading section, file section reading section 7, communication section reading section 8. File opening reading unit 9 and subroutine reading unit 1
Data output from 0, for example, program name, internal file name, record length, etc., are held.

編集部12は、プログラム仕様書の作成に必要なデータ
を編集加工したり、また、プログラム仕様書の図形や罫
線を定義し、作図制御部13は、プログラム仕様書の作
成に必要な作図をするだめの各種制御を行ない、プリン
タ14は、プログラム仕様書を出力し、単なる文字や記
号のみでなく、プログラム仕様書の作図のために必要な
図形、例えばフローを示すための図形や罫線等を打出す
こともできる。
The editing section 12 edits and processes the data necessary for creating the program specifications, and also defines the figures and ruled lines of the program specifications, and the drawing control section 13 draws the diagrams necessary for creating the program specifications. The printer 14 outputs the program specifications and prints not only characters and symbols but also figures necessary for drawing the program specifications, such as figures and ruled lines to show the flow. You can also take it out.

以下、本実施例について、第2図を参照しながらその動
作を説明する。
The operation of this embodiment will be described below with reference to FIG. 2.

プログラム仕様書を作成するときには、第2図にその内
容を示した、コボル言語によるソースプログラムイメー
ジファイルが、ソースプログ2ム送出部1から順次送出
されて、プログラム読取部2においては、予め指定され
ているソースプログラムのみが読取られ、これがファイ
ル部3に送出される。そして、ファイル部3からプログ
ラムが、プログラム見出し部判読部51.入出力節判読
部6゜ファイル節判読部71通信節判読部8.ファイル
開設判続部9.サブルーチン判読部10に順次伝達され
る。
When creating a program specification, source program image files written in the Kobol language, the contents of which are shown in FIG. Only the source program that is currently available is read and sent to the file section 3. Then, the program is transferred from the file section 3 to the program header section reading section 51. Input/output clause reading unit 6゜File clause reading unit 71 Communication clause reading unit 8. File Opening Judgment Department 9. The information is sequentially transmitted to the subroutine reading section 10.

すなわち、PROGRAM−ID文21とAUTHOR
文22とDATE−WRITTEN文23と注釈行から
なる業務名24と処理概要25は、プログラム見出し部
判読部5で検出・解析されてそれら自体が、また5EL
ECT文26は入出力筒判読部6により検出されてその
プログラムが使用しているファイルの内部ファイル名や
ファイル編成やアクセスモード等が、ファイル節27は
ファイル節判読部7により検出されてファイルのレコー
ド長、ブロック長、ブロッキングファクタ等が、またC
0PY命令28は同じくファイル節+(1読部7により
検出されて登碌集原文集のメンバ名が、また通信節29
は通信部判続部8で検出されて通信節の有無情報が、ま
た0PEN命令30はファイル開設判読部9により検出
されてファイル開設時のオープンモード情報が、またC
ALL命令31はサブルーチン判読部10により検出さ
れてプログラムが使用しているサブルーチン名がそれぞ
れデータ保持部11に保持される。
That is, PROGRAM-ID statement 21 and AUTHOR
The task name 24 and processing summary 25, which are composed of a statement 22, a DATE-WRITTEN statement 23, and an annotation line, are detected and analyzed by the program header section reading section 5, and are themselves read into the 5EL.
The ECT statement 26 is detected by the input/output cylinder reading unit 6 and contains the internal file name, file organization, access mode, etc. of the file used by the program, and the file clause 27 is detected by the file clause reading unit 7 and contains information about the file. The record length, block length, blocking factor, etc.
The 0PY instruction 28 is also the file section + (detected by the 1 reader 7 and the member name of the collection original text collection is also the communication section 29
The 0PEN command 30 is detected by the communication section judgment section 8 and the presence/absence information of the communication section is detected, and the 0PEN command 30 is detected by the file opening interpretation section 9 and the open mode information at the time of file opening is detected.
The ALL instruction 31 is detected by the subroutine reading section 10, and the subroutine names used by the program are each held in the data holding section 11.

そして、上記各判読部の処理後、制御部4は編集部12
および作図制御部13に対し制御指令を送出し、データ
保持部11から必要とするデータを読取らせて第3図に
示すようなプログラム仕様書の作成を行なわせる。これ
によりプログラム名やそれに必要なファイル名、フロー
チャート等が 4明示されたプログラム仕様書をプリン
タ14より得ることができる。
After the processing by each of the reading sections described above, the control section 4 sends the editing section 12
Then, a control command is sent to the drawing control section 13 to read necessary data from the data holding section 11 and to create a program specification as shown in FIG. As a result, a program specification document clearly indicating the program name, necessary file names, flowcharts, etc. can be obtained from the printer 14.

なお、本実施例では第3図で示した形式で出力結果が得
られるが、プログラム仕様書作成指示時に簡単なパラメ
ータを与えてやれば、制御部4と編集部12により、そ
の指定パラメータの条件に従って点線と実線を使い分け
たり、チャート部における図形を変えたりすることもで
きる。
In this embodiment, the output result is obtained in the format shown in FIG. 3, but if a simple parameter is given when instructing the creation of a program specification, the control section 4 and editing section 12 will be able to adjust the conditions of the specified parameter. You can also use dotted lines and solid lines or change the shapes in the chart section.

〔発明の効果〕〔Effect of the invention〕

以上説明したように、本発明によれば、プログラム仕様
書作成のプログラムを実行させることにより、一定のフ
ォーマットで短時間のうちにプログラム仕様書を作成す
ることができ、従来の手書きによるプログラム仕様書と
異なり、ミスの無い均一な品質のプログラム仕様書が得
られる。
As explained above, according to the present invention, by executing a program specification creation program, a program specification can be created in a fixed format in a short time, and the program specification can be created in a short time compared to the conventional handwritten program specification. Unlike this, program specifications with uniform quality and no errors can be obtained.

更に、何度プログラムの変更を行なっても、完全に書き
直された形になって出力されるのでドキュメント作業工
数が大巾に短縮される。
Furthermore, no matter how many times a program is changed, it is output in a completely rewritten form, which greatly reduces the number of man-hours required for document work.

【図面の簡単な説明】[Brief explanation of the drawing]

第1図は本発明の一実施例構成、第2図は本実施例で入
力されるコボル言語によるソースプログラムイメージフ
ァイル、第3図は本実施例により得られたプログラム仕
様書の一例を示す。 l・・・・・・ソースプログラム送出部、2・・・・・
・グログ2ム読取部、3・・・・・・ファイル部、4・
・・・・・制御部、5・・・・・・プログラム見出し部
判読部、6・・・・・・入出力節判読部、7・・・・・
・ファイル節判読部、8・・・・・・通信節判読部、9
・・・・・・ファイル開設判読部、lO・・・・・・サ
ブルーチン判読部、11・・・・・・データ保持部、1
2・・・・・・編集部、13・・・・・・作図制御部、
14・・・・・・プリンタ、21・・・・・・PROG
RAM−ID文、22・・・・・・AUTHOR文、2
3・・・・・・DATE−WRITTEN文、24,2
5・・・・・・注釈行、26・・・・・・5ELECT
文、27・・・・・・ファイル節、28・・・・・・コ
ピー命令、29・・・・・・通信節、30・・・・・・
0PEN命令、31・・・・・・CALL命令。 代理人 弁理士   内 原   音 第 1 図
FIG. 1 shows the configuration of an embodiment of the present invention, FIG. 2 shows a source program image file in Kobol language input in this embodiment, and FIG. 3 shows an example of a program specification obtained by this embodiment. l... Source program sending section, 2...
・Glog 2m reading section, 3...File section, 4.
...Control unit, 5...Program heading section reading section, 6...Input/output section reading section, 7...
・File section interpretation section, 8...Communication section interpretation section, 9
...File opening reading section, lO... Subroutine reading section, 11... Data holding section, 1
2...Editing section, 13...Drawing control section,
14...Printer, 21...PROG
RAM-ID statement, 22...AUTHOR statement, 2
3...DATE-WRITTEN statement, 24,2
5...Comment line, 26...5ELECT
Sentence, 27...File clause, 28...Copy command, 29...Communication clause, 30...
0PEN instruction, 31...CALL instruction. Agent Patent Attorney Uchihara Sound Figure 1

Claims (1)

【特許請求の範囲】 ソースプログラム群のうちから予め指定されたソースプ
ログラムを読み取るプログラム読取手段と、 該ソースプログラムに対するプログラム仕様書を作成す
るのに必要な予め定められているソースプログラム情報
を前記読み取られたソースプログラムのうちから判読す
る情報判読手段と、 該判読されたソースプログラム情報に基づき、前記プロ
グラム仕様書の作成に必要なデータを編集したり、前記
プログラム仕様書内の図形や罫線を定義する編集手段 とを設けたことを特徴とするプログラム仕様書作成方式
[Scope of Claims] Program reading means for reading a prespecified source program from a group of source programs; and the reading means for reading predetermined source program information necessary for creating a program specification for the source program. an information reading means for reading out of the source program that has been read; and an information reading means that reads information from the read source program; and, based on the read source program information, edits data necessary for creating the program specification, and defines figures and ruled lines in the program specification. A program specification creation method characterized by comprising an editing means for editing.
JP6262288A 1988-03-15 1988-03-15 Program specification preparing system Pending JPH01233621A (en)

Priority Applications (1)

Application Number Priority Date Filing Date Title
JP6262288A JPH01233621A (en) 1988-03-15 1988-03-15 Program specification preparing system

Applications Claiming Priority (1)

Application Number Priority Date Filing Date Title
JP6262288A JPH01233621A (en) 1988-03-15 1988-03-15 Program specification preparing system

Publications (1)

Publication Number Publication Date
JPH01233621A true JPH01233621A (en) 1989-09-19

Family

ID=13205602

Family Applications (1)

Application Number Title Priority Date Filing Date
JP6262288A Pending JPH01233621A (en) 1988-03-15 1988-03-15 Program specification preparing system

Country Status (1)

Country Link
JP (1) JPH01233621A (en)

Cited By (1)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
JPH03130828A (en) * 1989-10-17 1991-06-04 Nec Corp Flow chart producing device

Citations (1)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
JPS5797129A (en) * 1980-12-09 1982-06-16 Fujitsu Ltd Producing system of operation flow

Patent Citations (1)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
JPS5797129A (en) * 1980-12-09 1982-06-16 Fujitsu Ltd Producing system of operation flow

Cited By (1)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
JPH03130828A (en) * 1989-10-17 1991-06-04 Nec Corp Flow chart producing device

Similar Documents

Publication Publication Date Title
US7917850B2 (en) Document managing system and method thereof
CN100543725C (en) A kind of method for the E-seal location
CN110968294A (en) Business domain model establishing system and method
CN100440219C (en) Apparatus and method for generating PDF document
JPH01233621A (en) Program specification preparing system
JPS6290753A (en) Documentation device
US20060212802A1 (en) On demand data proxy
JP4146475B2 (en) Register data electronic device
Hofbauer et al. Large-Scale Collaborative Writing: Technical Challenges and Recommendations
Ackerman et al. The risks and rewards of online editing
Kostur Developing single source documentation
Erjavec et al. How to Approach the Digital Transformation
JPH08249397A (en) Data gathering, management, and recording device
Adawiyah et al. The role of the Microsoft office Visio in producing accounting information
Power Who needs a technical editor?
JPH0628377A (en) Business form output device
JPH0497248A (en) Device for forming printing block copy
Weber Who needs a technical editor?
JP2005107828A (en) Job flow production system and program
Ogata et al. Computer supported online correction for collaborative writing
JP2005352880A (en) Xml document creation system
Townend Muhr, T. 1997. ATLAS. ti 5: The Knowledge Workbench.
JPS58121450A (en) Automatic comment implementing device
JPH01261775A (en) Method for registering document for document editer
Brightwell et al. Standard generalized markup language: Ready for CANDA and beyond