JPH1063492A - ソフトウェアの仕様書生成装置 - Google Patents

Abstract

(57)【要約】 【課題】ソースプログラムから高精度のソフトウェアの
仕様書を生成する。 【解決手段】先ず、仕様書を生成する対象であるソース
プログラム１０と外部入出力テーブル１１とに基づい
て、変数変換用テーブル生成処理１００が実行し、変数
変換用テーブル１４が生成する。変数変換用テーブル１
４には、ソースプログラム１０の各入出力変数が、適切
な日本語変数名及び同一データが代入される一又は二以
上の変数と対応して保存される。次に、日本語変換処理
２００を実行して、ソースプログラム１０を日本語プロ
グラム１７に変換する。そして、要約処理３００を実行
して、日本語プログラム１７を適宜圧縮し適切なボリュ
ームの日本語仕様書１９を生成する。

Description

【発明の詳細な説明】

【０００１】

【発明の属する技術分野】この発明は、計算機システム
におけるソフトウェアの保守や再構築作業のために必要
な日本語の仕様書を生成する装置に関し、特に、実際の
ソースプログラムから高精度のソフトウェアの仕様書を
生成できるようにしたものである。

【０００２】

【従来の技術】新規の計算機システムの構築時には、要
件仕様書，機能仕様書，プログラム仕様書等の膨大な上
位の設計ドキュメントを先ず作成し、その作成された仕
様書に基づいて計算機言語でソースプログラムを記述す
る、というのが通常の手順である。そして、ソースプロ
グラムが完成した後はシステム立ち上げ後に発生する機
能改善や不具合対応を保守作業として行うのであるが、
保守作業は新規システムの構築時に比べて少人数で行わ
なければならないため、仕様書の改訂作業までは行わ
ず、ソースプログラムの改訂のみが行われる場合が多
い。

【０００３】すると、実際に使用しているソースプログ
ラムと手元の仕様書の内容とが一致しなくなってしま
い、仕様書の信頼性が低くなってしまう。仕様書の信頼
性が低くなると、ソースプログラムを正確に読みこなせ
ない者は計算機システムの詳細な機能や処理内容を自力
では理解できなってしまう。

【０００４】そこで、例えば特開平６−２４２９３３号
公報（第１従来例）や特開平６−２８２４２４号公報
（第２従来例）に開示されるような、ソースプログラム
から仕様書を自動的に生成する装置が従来から存在す
る。

【０００５】

【発明が解決しようとする課題】しかしながら、上記第
１従来例に開示された装置は、仕様書の保守装置に関す
るものであるが、上位概念の抽出を人手により補足する
ようになっているため、作業者のレベルがそのまま仕様
書のレベルに反映してしまい、修正ミスも発生し易く、
得られる仕様書の質が悪い場合も多く、結果として仕様
書の信頼性が低いという問題点を有している。また、上
記第２従来例に開示された装置は、ソースプログラムの
注釈文を抽出し、それを各処理の内容とするようになっ
ているため、保守作業の度にコメント文を詳細に且つ正
確に修正しなければ十分に高精度の仕様書を得ることが
できないという問題点を有している。

【０００６】本発明は、このような従来の技術が有する
未解決の課題に着目してなされたものであって、実際の
ソースプログラムから高精度のソフトウェアの仕様書を
生成するのに役立つ仕様書生成装置を提供することを目
的としている。

【０００７】

【課題を解決するための手段】上記目的を達成するため
に、請求項１に係る発明は、ソースプログラムからソフ
トウェアの仕様書を生成するための装置であって、前記
ソースプログラムの対外部データ入出力処理部に記述さ
れた入出力変数に日本語変数名を付与する日本語変数名
付与手段と、前記入出力変数の前記ソースプログラム内
での代入関係に基づいて同一データが代入される一又は
二以上の変数を抽出しその抽出された変数を前記日本語
変数名と対応させて記憶する変数解析手段と、この変数
解析手段の解析結果及び所定の変換ルールに従って前記
ソースプログラムを日本語のプログラムに変換する変換
手段と、前記日本語のプログラムを所定の圧縮ルールに
従って圧縮する要約手段と、を備えた。

【０００８】上記目的を達成するために、請求項２に係
る発明は、ソースプログラムからソフトウェアの仕様書
を生成するための装置であって、前記ソースプログラム
の対外部データ入出力処理部に記述された入出力変数に
日本語変数名を付与する日本語変数名付与手段と、前記
入出力変数の前記ソースプログラム内での代入関係に基
づいて同一データが代入される一又は二以上の変数を抽
出しその抽出された変数を前記日本語変数名と対応させ
て記憶する変数解析手段と、前記ソースプログラムを所
定の圧縮ルールに従って圧縮する要約手段と、前記要約
手段によって要約されたソースプログラムを前記変数解
析手段の解析結果及び所定の変換ルールに従って日本語
のプログラムに変換する変換手段と、を備えた。

【０００９】また、請求項３に係る発明は、上記請求項
１又は２に係る発明であるソフトウェアの仕様書生成装
置において、前記日本語変数名付与手段は、前記ソース
プログラムの入出力変数に対して注釈文が添えられてい
る場合には、その注釈文に基づいて前記日本語変数名を
決定する一方、前記ソースプログラムの入出力変数に注
釈文が添えられていない場合には、作業者に日本語変数
名の入力を求めるようになっている。

【００１０】そして、請求項４に係る発明は、上記請求
項１乃至３に係る発明であるソフトウェアの仕様書生成
装置において、前記要約手段は、指定回数以上に深い入
れ子構造を削除するようになっている。

【００１１】さらに、請求項５に係る発明は、上記請求
項１乃至３に係る発明であるソフトウェアの仕様書生成
装置において、前記要約手段は、関数の呼出しに必要な
変数のセット命令を削除するようになっている。

【００１２】ここで、請求項１に係る発明にあっては、
日本語変数名付与手段によって、ソースプログラムの対
外部データ入出力処理部（対外部データ入力処理部，対
外部データ出力処理部）に記述された入出力変数に、日
本語変数名が付与される。つまり、ソースプログラムの
外部（例えば、上位計算機等）からデータを読み込むデ
ータ入力処理部には、このソースプログラムに外部から
データが入力される際に最初にデータが代入される入力
変数が記述されているし、また、ソースプログラムの外
部（例えば、下位計算機やプロセスコンピュータ等））
に対してデータを出力するデータ出力処理部には、この
ソースプログラムから外部にデータが出力される際に最
後にデータが代入される出力変数が記述されており、そ
れら入力変数や出力変数は、例えばソースプログラムと
は別に作成した外部入出力テーブルを参照することによ
り、或いは、ソースプログラム内におけるデータ入出力
や変数定義に関する命令語を確認することにより、容易
に抽出できる。

【００１３】入出力変数に日本語変数名が付与された
ら、変数解析手段によって、入出力変数のソースプログ
ラム内での代入関係に基づいて、同一データが代入され
る一又は二以上の変数が抽出され、その抽出された変数
が、代入関係を追跡する又は逆上る際の出発点であった
入出力変数の日本語変数名との対応を採られた上で記憶
される。つまり、入出力変数は、外部からデータを読み
込む際の最初の変数又は外部にデータを出力する際の最
後の変数と考えることができる。そして、入力変数にデ
ータが代入されると、それが次々と代入式を経て他の変
数に代入されていく場合があるから、代入関係を一つず
つ追跡することにより、同一のデータが代入される一又
は二以上の変数が抽出されるのである。出力変数の場合
にも、その出力変数に代入されたデータは、次々と代入
式を経て他の変数から受け渡されていることがあるか
ら、代入関係を一つずつ逆上ることにより、同一のデー
タが代入される一又は二以上の変数が抽出されるのであ
る。換言すれば、ソースプログラム内では異なった変数
名が記述されていたとしても、各変数間の代入関係を追
跡する或いは逆上ることにより、実質的に同一の変数で
あることが確認できるのである。

【００１４】変数解析手段による変数の解析が行われた
後には、変換手段によって、ソースプログラムが日本語
のプログラムに変換される。この場合、変換手段は、変
数解析手段の解析結果、つまり日本語変数名とこれに対
応して記憶された一又は二以上の変数名とに関する情報
に基づいて変換を行うため、ソースプログラム内では同
一データが代入される変数は、一つの日本語変数名に統
一して変換することができる。

【００１５】また、変換手段においては、変数解析手段
の解析結果に含まれていない変数や命令語等の他の用語
の変換は、所定の変換ルールに従って行われる。この場
合の変換ルールは、特に限定されるものではない。

【００１６】さらに、変換手段によって変換された日本
語のプログラムが、要約手段によって圧縮されるから、
仕様書としては不要な命令文等が削除されたり、或いは
一定の関係にある複数の命令文が統合されて包括的な記
述に変換されるから、仕様書としてより適切な日本語の
文章が得られる。

【００１７】一方、請求項２に係る発明にあっては、日
本語変数名付与手段及び変数解析手段に関する作用は上
記請求項１に係る発明と同様であるが、要約手段及び変
換手段の処理の順序が、上記請求項１に係る発明と逆に
なっている。即ち、要約手段は、ソースプログラムに対
して圧縮処理を実行し、変換手段は、要約手段によって
要約されたソースプログラムに対して変換処理を実行し
て日本語のプログラムを作成する。そして、実行順は入
れ代わっているが、これら各手段の処理を経れば、請求
項１に係る発明と同様に、仕様書としてより適切な日本
語の文章が得られる。

【００１８】請求項３に係る発明にあっては、日本語変
数名付与手段は、入出力変数に注釈文が添えられている
場合にはその注釈文に基づいて日本語変数名を決定する
が、変数名に付されている注釈文は、通常はその変数名
の内容を表すものであり、変数名の内容は、ソースプロ
グラムが改訂されてもソースプログラムの目的が大幅に
変更されない限り元のままであることが多いから、当初
の注釈文がそのまま残っていたとしても、適切な日本語
変数名を決定することができる。また、注釈文が付され
ていない場合には、このソフトウェアの仕様書生成装置
の作業者に日本語変数名の入力を求めるようになってい
るが、通常は英数字で記述される変数名は、アルファベ
ット等の無意味な羅列ではなく例えば元のデータ概念の
発音から母音や子音等を適宜間引いたものである場合が
多いから、変数名やそのソースプログラムの目的等か
ら、変数の元の概念を類推することは比較的容易であ
る。よって、作業者のレベルにそれほど左右されること
なく、適切な日本語変数名が付与されるのである。

【００１９】請求項４に係る発明にあっては、要約手段
は、指定回数以上に深い入れ子構造を削除することによ
り、圧縮を行うようになっている。指定回数は、予め設
定しておいてもよいし、作業者が入力するようにしても
よい。そして、階層の深い判定処理等は仕様書の理解に
は不要である場合が多いから、そのような入れ子構造を
削除すれば、仕様書の質を低下させることなく、量的に
仕様書として適切な日本語の文章を作成することに有益
である。

【００２０】請求項５に係る発明にあっては、要約手段
は、例えばタスク起動やアラーム出力に先駆けて変数を
セットする処理のように、関数の読み出しの際に行われ
る変数のセット命令を削除することにより、圧縮を行う
ようになっている。このような変数のセット命令は、仕
様書の理解には不要である場合が多いから、これを積極
的に削除すれば、仕様書の質を低下させることなく、量
的に仕様書として適切な日本語の文章を作成することに
有益である。

【００２１】

【発明の実施の形態】以下、この発明の実施の形態を図
面に基づいて説明する。図１乃至図４は本発明の一実施
の形態を示す図であって、図１は本発明に係るソフトウ
ェアの仕様書生成装置の全体的な処理の流れを示してい
る。なお、ソフトウェアの仕様書生成装置は、パーソナ
ルコンピュータやその周辺機器を備えたハード構成及び
後述する処理を実行するアプリケーションプログラムに
よって実現されるものであり、アプリケーションプログ
ラムは例えば周辺機器としてのハードディスク装置の記
憶媒体や、フレキシブルディスク等の可搬性の磁気記憶
媒体に記憶されている。

【００２２】即ち、このソフトウェアの仕様書生成装置
においては、先ず、仕様書を生成する対象であるソース
プログラム１０と外部入出力テーブル１１とに基づい
て、変数変換用テーブル生成処理１００が実行される。

【００２３】変数変換用テーブル生成処理１００は、具
体的には図２に示すような一連の処理を実行するように
なっていて、先ず、そのステップ１０１において、仕様
書を生成する対象であるソースプログラム１０を読み込
み、次いで、ステップ１０２に移行して、外部入出力テ
ーブル１１を読み込む。外部入出力テーブル１１は、例
えば既存のファイル／テーブルに関する仕様書１２や、
インクルードファイル１３に基づいて予め生成されるテ
ーブルであって、このソースプログラム１０を実行する
計算機と、外部の上位或いは下位計算機との間で行われ
るデータの入出力関係が整理されている。

【００２４】外部入出力テーブル１１の具体的な例を図
３に示す。この図３の横軸のそれぞの意味は、次のよう
なものである。 （１）ＩＤＮｏ：ファイル／テーブルの一意的な番号で
ある。

【００２５】（２）日本語名：電子化された上位・下位
伝送フォーマットやインクルードファイルから転記した
日本語名称である。 （３）変数名：システムで一意の英数字の変数名であ
る。後述する逆変換処理で使用される。

【００２６】（４）ＡＢＣ１００，ＸＹＺ２００等：プ
ログラム名の例である。 また、図３中の“Ｒｅａｄ”は各プログラムでデータの
読み込みに使用する入力変数を、“Ｗｒｉｔｅ”は各プ
ログラムでデータの書き込みに使用している出力変数を
示している。そして、図３の縦軸は外部入出力情報を示
している。このように、関連付けされた変数名を一覧表
に編集して外部入出力テーブル１１とすることにより入
出力情報と関係プログラム（上位プログラム・下位プロ
グラム）との関係が容易に把握できる。関連付けの例と
して、図３には、直接代入方式による読み込み例を
（ａ）に、サブルーチンを使用した連続方式による読み
込み例を（ｂ）に示す。また、各変数名のサブルーチン
間での重複を考慮して、各変数名にサブルーチン及びプ
ログラム名の属性を付与した例を（ｃ）に示す。

【００２７】ステップ１０１，１０２の処理を終えた
ら、ステップ１０３に移行し、外部入出力テーブル１１
又はソースプログラム１０に基づき、そのソースプログ
ラム１０の対外部入出力処理部に記述されている入出力
変数、つまりこのソースプログラム１０を実行した場合
に外部との間でデータの受け渡しが行われる入出力変数
を抽出し、次いでステップ１０４に移行し、抽出された
各入出力変数に、日本語変数名を付与する。付与する日
本語変数名は、その入出力変数の実態に則した変数名と
することが、後に生成される仕様書の質を高めるために
は望ましい。そこで、この実施の形態では、入出力変数
に注釈文が添えられている場合には、その注釈文の内容
に基づいて日本語変数名を決定することとし、添えられ
ていない場合には、作業者に日本語変数名の入力を求め
ることとしている。注釈文の内容は、ソースプログラム
１０内から抽出してもよいし、或いは、外部入出力テー
ブル１１内から抽出してもよい。

【００２８】付与された日本語変数名は、入出力変数と
ともに、変数変換用テーブル１４に書き込まれる。する
と、変数変換用テーブル１４には、ソースプログラム１
０の各入出力変数が、付与された日本語変数名と共に保
存されることになる。

【００２９】ステップ１０４からステップ１０５に移行
し、ソースプログラム１０内での入出力変数の代入関係
を追跡又は逆上ることにより、同一データが代入される
変数を一つずつ抽出する。そして、ステップ１０６に移
行して、ステップ１０５で抽出された各変数を、元の入
出力変数及び日本語変数名と対応させて、変数変換用テ
ーブル１４に書き込み、次いでステップ１０７に移行
し、同一データが代入される変数の抽出が終了したか否
かを判定し、終了していない場合にはステップ１０５に
戻って上記処理を繰り返し実行し、終了している場合に
はこの変数変換用テーブル生成処理１００を終了する。
ステップ１０７の判断は、例えば変数の代入関係の追跡
又は逆上りが行き詰まった時点で終了と判断できる。

【００３０】この変数変換用テーブル生成処理１００が
終了すれば、変数変換用テーブル１４には、ソースプロ
グラム１０の各入出力変数が、適切な日本語変数名及び
同一データが代入される一又は二以上の変数と対応して
保存されるようになる。

【００３１】ここで、以下に示すプログラム例（Ｃ言
語）を伴って、変数変換用テーブル生成処理１００にお
ける作用をより具体的に説明する。なお、以下のプログ
ラム例は、鉄鋼の圧延ライン用のプロセスコンピュータ
で実行されるプログラムの一部を抜粋したものであり、
便宜的にプログラム名を“sample.c”とする。

【００３２】 上記プログラム例の場合、入力変数として、「coilno，
atu ，haba，nagasa，sokudo，akka，dmy[4]」が確認さ
れ、それら各入力変数のそれぞれには注釈文が添えられ
ている。そこで、例えばステップ１０３の処理では、入
力変数として、“coilno”が抽出され、ステップ１０４
の処理ではその入力変数“coilno”に、日本語変数名と
して“コイルNo”或いは“コイルナンバー”が付与され
る。

【００３３】また、上記プログラム例の場合、入力変数
“coilno”は、命令情報という上位概念を構成する一部
でもあり、命令情報は“PC＿ORDER ”となっている。そ
こで、“PC＿ORDER.coilno”という入力変数に対して、
“命令情報\\コイルNo”という実質的に二つの日本語変
数名を付与することが好ましい。

【００３４】次に、ステップ１０５における処理で、上
記プログラム例のファイルリードの読み込みエリアか
ら、変数名が検出される。この場合は、構造体の“pcda
ta”から配列の“idata ”が検出され、“pcdata.coiln
o ”と“idata[0]”とが同一データであることが検出さ
れる。さらに、上記プログラム例内の代入関係を追跡す
ることにより、“icoil ”，“ldata[0]”，“lcoil ”
が次々と検出される。

【００３５】つまり、ステップ１０５の処理によって、
“pcdata.coilno ”，“idata[0]”，“icoil ”，“ld
ata[0]”，“lcoi”は、入力変数“coilno”が次々と代
入されていく変数であることが抽出されるのである。こ
の結果、変数変換用テーブル１４には、例えば、 命令情報\\コイルNo::PC＿ORDER.coilno::sample.c\\id
ata[0]\\ldata[0]\\lcoil というような情報が構築されることになる。“atu ”等
のその他の変数についても、同様の情報が構築される。
なお、変数変換用テーブル１４に構築されない変数もあ
るが、それら構築されない変数は、ソースプログラム１
０内でのみ使用される変数，定数である。

【００３６】このように、変数変換用テーブル生成処理
１００によって変数変換用テーブル１４が生成された
ら、次に、日本語変換処理２００が実行される。日本語
変換処理２００は、具体的には図４に示すような一連の
処理を実行するようになっていて、先ず、そのステップ
２０１において、仕様書を生成する対象であるソースプ
ログラム１０を読み込み、次いで、ステップ２０２に移
行して、変数変換用テーブル１４を読み込む。次いで、
ステップ２０３に移行して、システム辞書１５，メーカ
辞書１６を読み込む。システム辞書１５とは、いわゆる
ローマ字入力式のワードプロセッサに用いられる変換辞
書に相当するものであって、ローマ字とそれを日本語に
変換した場合の単語との対応関係を表している。また、
メーカ辞書１６とは、ソースプログラム１０の言語に対
応して予め作成されている辞書であって、命令語やサブ
ルーチンとその内容を表す適切な日本語との対応関係を
表している。

【００３７】そして、ステップ２０４に移行し、変数変
換用テーブル１４に構築されている情報に基づき、ソー
スプログラム１０内の各変数を日本語に変換する。例え
ば、ソースプログラム１０内の変数“lcoil ”は、上述
した例から“コイルNo”という日本語に変換される。

【００３８】次に、ステップ２０５に移行し、メーカ辞
書１６を参照しつつ、ソースプログラム１０内の命令語
やサブルーチンを日本語に変換する。以上のステップ２
０４及び２０５の処理によって、通常はソースプログラ
ム１０の大部分が日本語に変換されるが、当然に変換さ
れない部分もあり、その変換されない部分はプログラム
内定数であるから、ステップ２０６〜２０９の処理によ
って適宜日本語に変換する。

【００３９】即ち、ステップ２０６では、ソースプログ
ラム１０内のデータセット項目を抽出し、そのデータセ
ット項目を日本語に変換する。例えば、ソースプログラ
ム１０内に、 『 int ia = 10 』 という実行文があった場合には、これを、 『 ia → 「固定値１０」 』 或いは、 『 iaを固定値１０にセットする。』 等の日本語に変換する。

【００４０】次に、ステップ２０７に移行し、ソースプ
ログラム１０内の繰り返し変数項目を抽出し、その繰り
返し変数項目を日本語に変換する。例えば、ソースプロ
グラム１０内に、 『 ｝while (c>12) 』 という実行文があった場合には、これを、 『 ｃ → 「ループ数１２」 』 或いは、 『 ｃのループ数は１２とする。』 等の日本語に変換する。

【００４１】次に、ステップ２０８に移行し、システム
辞書１５を利用して、ソースプログラム１０内のパター
ンマッチング項目を日本語に変換する。具体的にには、
このステップ２０８では、上記ステップ２０４〜２０７
の処理では日本語に変換されなかった実行文に含まれる
アルファベット等で記述される単語から、所定の意味が
読み取れる部分を抽出し、その意味が読み取れる部分の
みを対応する日本語に変換するのである。例えば、 『 icoila 』 という語があった場合、その内の“coil”は“コイル”
を意味するものと容易に推測できるから、これを、 『 iコイルa 』 に変換する。

【００４２】次に、ステップ２０９に移行し、システム
辞書１５を利用して、ソースプログラム１０内のローマ
字変換項目を日本語に変換する。具体的には、このステ
ップ２０９では、上記ステップ２０４〜２０８の処理で
は日本語に変換されなかった実行文に含まれる単語が、
ワードプロセッサにおけるローマ字変換によって日本語
に変換できる場合には、積極的に日本語に変換するので
ある。例えば、 『 kekka 』 という語があった場合には、システム辞書１５を利用し
て、これを、 『 結果 』 に変換する。

【００４３】ステップ２０９までの処理を終えたら、ス
テップ２１０においてソースプログラム１０の全ての実
行文について日本語への変換が完了したか否かを判断
し、完了していない場合には、ステップ２０４に戻って
上述した処理を再び実行する。完了している場合には、
この日本語変換処理２００を終了する。

【００４４】このような日本語変換処理２００が終了す
れば、各実行文が日本語で記述された日本語プログラム
１７が生成される。そして、この日本語プログラム１７
をそのまま日本語仕様書としてもよいのであるが、ソー
スプログラム１０の内容をそのまま日本語に変換しただ
けなので、仕様書としては不要な文も多く含まれてい
る。

【００４５】そこで、次に、要約処理３００を実行する
ことにより、内容がより鮮明な仕様書を生成することと
している。つまり、ソースプログラムの処理内容を理解
するために必要な行や文は残すが、それ以外の行や文は
削除或いは統合することにより、日本語プログラム１７
のボリュームを低減して使い勝手のよい仕様書を生成す
るのである。

【００４６】この要約処理３００は、具体的には図５に
示すような一連の処理を実行するようになっていて、先
ず、そのステップ３０１において、日本語プログラム１
７を読み込み、次いでステップ３０２において、予め取
り決めておいた圧縮ルール１８を読み込む。圧縮ルール
１８の内容は、生成される仕様書の質及び量を大きく左
右するため、仕様書に要求される質的及び量的な目標に
基づいて適宜設定することが望ましい。ここでは、以下
のステップ３０３〜３０８の処理を具体的に説明するこ
とにより、圧縮ルール１８の一例を示す。

【００４７】即ち、ステップ３０３では、多くのソース
プログラムにおいて定常的に使用される共通サブルーチ
ンを削除するというルールに従って、日本語プログラム
１７を圧縮する。例えば、ソースプログラム１０の起動
時に必ず実行される起動要因取り込み処理やこのソース
プログラム１０実行中にはアクセスしないファイルをソ
フト的に切り離すファイル排他処理等は、仕様書の理解
には不要であるため、積極的に削除する。

【００４８】次に、ステップ３０４では、初期セット命
令を削除するというルールに従って日本語プログラム１
７を圧縮する。即ち、ソースプログラム１０内における
各処理の最初に実行される変数の０クリアや、サブルー
チンのリターンコードの０クリア等の初期セットは、仕
様書の理解には不要であるため、積極的に削除する。例
えば、ソースプログラム１０に、 『 cnt=0; /* リトライ数０クリア */ i = 1; do ｛ cnt = cnt + 1; /* リトライ数ＵＰ */ mread( &rcnol, &ml, &rtn ); /* パリティD/I データ格納 */ 』 という部分があった場合、“cnt=0 ”は仕様書の理解に
は不要であるため、日本語プログラム１７内でそれに相
当する日本語実行文、例えば「リトライ数を０クリアす
る。」という文を削除する。

【００４９】次に、ステップ３０５では、階層の深いネ
スト処理（入れ子処理）を削除するというルールに従っ
て日本語プログラム１７を圧縮する。削除する階層の回
数は固定ではなく、ソースプログラム１０毎に指定する
か、或いは作業者が任意に指定できるようにする。例え
ば、ソースプログラム１０に、 『 IF( SDCNT+1 .GE. 1000 ) THEN /* １０００回チェック CALL KCDATS( MOD, TIME ) /* リセット時刻読み込み RHEND = HENDT /* 偏差セット RSETD = SETDT /* 設定値セット IF( SDAVE .LE. KAGEN ) THEN /* 下限異常？ IF( SDAVE .GT. 2147483647 ) THE SDAVE = 32767 /* ＋タイプ変換 ELSE ENDIF IF( SDAVE .LT. -2147483647 ) THEN SDAVE = -32767 /* −タイプ変換 CALL KCEDMV( VARDT2, BUFF, 4) /* アラーム出力要求処理 CALL PCALMS( IAPCLL, 1, ALMDT, VARDT2, RETC ) ELSE ENDIF 』 というような処理部分があった場合、これを （１）指定回数を３とし、３以上のIF〜ENDIF を削除対
象とする。

【００５０】（２）但し、削除するのはIF〜ENDIF 内の
命令が代入文のみの場合とする。 （３）IF〜ENDIF 内に代入文以外の命令文がある場合に
は、その命令文は削除対象から外す。 という具体的なルールに従って圧縮すると、 『 CALL KCEDMV( VARDT2, BUFF, 4) /* アラーム出力要求処理 CALL PCALMS( IAPCLL, 1, ALMDT, VARDT2, RETC ) 』 というように要約される。実際には、本実施の形態では
日本語プログラム１７に対して要約処理３００を行うた
め、上記例がそのまま当てはまるものではないが本質的
には同じである。なお、このステップ３０５における処
理は、日本語プログラム１７の圧縮にとって特に効果的
であった。

【００５１】次に、ステップ３０６では、一定のパター
ンに該当する処理を削除するというルールに従って日本
語プログラム１７を圧縮する。ここでの一定のパターン
としては、例えばタスク起動やアラーム出力に先立って
実行される変数のセット処理は、それらタスク起動やア
ラーム出力（つまり、関数の呼出し）を行う際に必ず実
行されるパターン処理であり、これらは仕様書の理解に
は不要であるため、積極的に削除する。例えば、ソース
プログラム１０に、 『 ITSKNO = 109 IDATA(1) = ICOIL CALL KFORK( ITSKNO, IDATA ) 』 というタスク起動命令があった場合、この例の３行目の
文から１行目及び２行目のセットはタスク起動のための
変数セットであることが判るから、それら１行目及び２
行目の代入文は削除する。

【００５２】次に、ステップ３０７では、サブルーチン
の不要な引数を削除し、タスクやアラーム番号から具体
的な項目名に変換するというルールに従って日本語プロ
グラム１７を圧縮する。例えば、上記例の場合、３行目
のタスク起動命令は、そのままでは理解しにくいから、
これを日本語仕様書１９の段階では、 『 ＡＥＫ１００を起動する。』 という文にすることにより、ボリュームを減らしつつ、
日本語仕様書１９の質をさらに向上できるのである。な
お、これらステップ３０６，１０７における処理も、日
本語プログラム１７の圧縮にとって特に効果的であっ
た。

【００５３】次に、ステップ３０８では、連続して変数
のセットが行われる領域を削除するとともに、それら領
域全体を上位概念の名称を付して例えば“○○○ファイ
ルの編集”や“×××テーブルの編集”という具合に集
約するというルールに従って日本語プログラム１７を圧
縮する。例えば、ソースプログラム１０に、 『 IIDATA(1) = IATU IIDATA(2) = IHABA IIDATA(3) = ITEPA 』 という連続して変数をセットする部分があった場合、こ
れら１〜３行それぞれの属性が、 幅計設定情報\\厚::WPRI＿INF.atu … 幅計設定情報\\幅::WPRI＿INF.haba… 幅計設定情報\\テーパ::WPRI＿INF.tepa… となっていれば、上位概念として“幅計設定情報”が確
認できるから、この連続セット命令を削除するととも
に、これを集約して、 『 幅計設定情報編集 』 とする。

【００５４】そして、ステップ３０９に移行し、日本語
プログラム１７について要約処理が完了したか否かを判
断し、完了していない場合には、ステップ３０３に戻っ
て上述した処理を再び実行する。完了している場合に
は、この要約処理３００を終了する。

【００５５】このような要約処理３００が終了すれば、
適当な量に圧縮された日本語仕様書１９が生成される。
さらに、この実施の形態では、日本語プログラム１７及
び日本語仕様書１９の少なくとも一方をソースプログラ
ム１０に戻す逆変換処理４００も実行するようになって
いて、その逆変換処理４００の結果とソースプログラム
１０とを比較することにより、日本語仕様書１９の質を
チェックできるようにしている。逆変換処理４００は、
外部入出力テーブル１１，変数変換用テーブル１４，シ
ステム辞書１５，メーカ辞書１６を参照しつつ、日本語
変換処理２００とは逆の手順によって逆変換を行うよう
になっている。なお、この逆変換処理４００は、日本語
仕様書１９の質的チェックのための処理であるから、省
略してもよい。

【００５６】そして、本実施の形態では、変数変換用テ
ーブル生成処理１００を実行することにより上述したよ
うな変数変換用テーブル１４を生成し、その変数変換用
テーブル１４を用いて日本語変換処理２００を実行する
ようになっているから、見た目は異なるが同一のデータ
が代入される複数の変数を、統一した日本語変数名に変
換することができるという利点がある。しかも、変数変
換用テーブル生成処理１００を実行する際に外部入出力
テーブル１１を参照するようにしているから、上位・下
位計算機を含めた全システムの仕様書で日本語変数名を
統一できるという利点もある。

【００５７】ここで、本実施の形態では、変数変換用テ
ーブル生成処理１００におけるステップ１０３，１０４
の処理によって日本語変数名付与手段が構成され、変数
変換用テーブル生成処理１００におけるステップ１０５
〜１０７の処理によって変数解析手段が構成され、日本
語変換処理２００が変換手段に対応し、要約処理３００
が要約手段に対応する。

【００５８】なお、日本語変換処理２００と要約処理３
００との実行順は、上記実施の形態とは逆であってもよ
いし、実質的に同時に行ってもよい。つまり、ソースプ
ログラム１０を要約処理３００で予め処理して圧縮され
たソースプログラム１０を生成し、それを日本語変換処
理２００によって変換して日本語仕様書１９を生成する
ようにしてもよいし、或いは、ソースプログラム１０の
各行或いは所定のブロック単位で要約処理３００を実行
し、要約処理３００で削除されなかった或いは統合され
た実行文毎に逐次日本語変換処理を実行して、日本語仕
様書１９を生成してもよい。

【００５９】

【実施例】以下のプログラムをソースプログラム１０と
して日本語プログラム１７及び日本語仕様書１９を生成
した実施例を示す。なお、これらソースプログラム１
０，日本語プログラム１７及び日本語仕様書１９は、全
体ではなくその一部のみを示している。また、ソースプ
ログラム１０の言語はＦＯＲＴＲＡＮである。

【００６０】 ソースプログラム１０； 『 CALL XRCVMS(LMODE,LQTYPE,IBUFF,LBUFSZ) CALL XCILCL(ICOIL1,ISLAB,LCILNO,LERR) LHTIME = 0 IJISSI = 0 CALL MMCGET(LADR1,LSIZE1,IMCDAT) CALL XICDRD(ICDNO,ICOIL1,LADR2(1),LSIZE2(1),ICD05, ^*9999) CALL XTIME(LTIME) LTIME = LTIME/100 IF(LFTIME.NE.LRTIME)THEN LGOSA = LTIME-(LFTIME+LHOSEI) LGTIME= (LGOSA ^*IKAGEN)/100 CALL AEADAY(LGTIME) IF(LGTIME.GT.IMAX)THEN LGTIME = IMAX ELSEIF(LGTIME.LT.IMIN)THEN LGTIME = IMIN ELSE ENDIF 』 日本語プログラム１７； 『 起動情報取り込み（リクエストモード，メッセージ制御情報，メッセージ出 力バッファ，メッセージ出力バッファサイズ） コイルＮｏ．取り込み（コイル種別（当該材），スラブ種別，コイルＮｏ． エラーコード） 補正時間＝０ 抽出停止実施フラグ＝０ ＭＭＩテーブル取り込み（ＩＭＣＴＢＬ取り込み開始アドレス，ＩＭＣＴＢ Ｌ取り込みサイズ，ＭＭＩテーブルデータ） ＩＣＤテーブル取り込み（ＩＣＤＮＯ，コイル種別（当該材），ＩＣＤ０５ アドレス（１），ＩＣＤ０５サイズ（１），自動 抽出設定） 現在時刻取り込み（Ｆ１ｏｎ実績時刻） Ｆ１ｏｎ実績時刻＝Ｆ１ｏｎ実績時刻／１００ もし（Ｆ１ｏｎ予定時刻以外Ｒ１ｏｎ予定時刻）ならば ＩＣＤ０５格納用誤差時間＝ Ｆ１ｏｎ実績時刻−（Ｆ１ｏｎ予定時刻＋実績補正量（当該材）） 誤差時間＝（ＩＣＤ０５格納用誤差時間＊補正率）／１００ 日替わりチェック処理（誤差時間） もし（誤差時間＞実績補正量上限値）ならば 誤差時間＝実績補正量上限値 上記以外でもし（誤差時間＜実績補正量下限値）ならば 誤差時間＝実績補正量下限値 上記以外 』 日本語仕様書１９； 『 システム名称 ： 自動抽出システム 機能名称 ： 自動運転機能 プログラム名 ： 実績補正処理 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− プログラム略称 ： ＡＥＡ５００ 計算機 ： ＡＢＣ 属性 ： 非常駐 ＰＩＢ ： ０３２９ −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− １．概要 （１）以下の情報の取り込みを行う。

【００６１】 （１−１）起動情報取り込みを行う。 （１−２）コイルＮｏ．取り込みを行う。 （１−３）ＭＭＩテーブル取り込みを行う。

【００６２】 （１−４）ＩＣＤテーブル読み込みを行う。 （１−５）現在時刻取り込み。 （２）もし（Ｆ１ｏｎ予定時刻以外Ｒ１ｏｎ予定時刻）ならば以下の処 理を行う。

【００６３】 ＩＣＤ０５格納用誤差時間＝Ｆ１ｏｎ実績時刻− （Ｆ１ｏｎ予定時刻＋実績補正量（当該材）） 誤差時間＝（ＩＣＤ０５格納用誤差時間＊補正率）／１００ 日替わりチェック処理（誤差時間） もし（誤差時間＞実績補正量上限値）ならば 誤差時間＝実績補正量上限値 上記以外でもし（誤差時間＜実績補正量下限値）ならば 誤差時間＝実績補正量下限値 （３）Ｆ１ｏｎ実績時刻（現在時刻）、発生実績補正量（補正時間）、 誤差時間を自動抽出設定データテーブル（ＩＣＤ０５）に格納す る。

【００６４】 （４）ＡＥＫ１００を起動する。 』

【００６５】

【発明の効果】以上説明したように、本発明によれば、
日本語変数名付与手段及び変数解析手段を有しているた
め、見た目は異なるが同一のデータが代入される複数の
変数を統一した日本語変数名に変換することができる
し、上位・下位計算機を含めた全システムの仕様書で日
本語変数名を統一できるという利点がある。また、要約
手段を有しているから、実用的な仕様書を生成すること
ができる。

【図面の簡単な説明】

【図１】本発明の一実施の形態の全体の流れを示す図で
ある。

【図２】変数変換用テーブル生成処理の概要を示すフロ
ーチャートである。

【図３】外部入出力テーブルの例を示す図である。

【図４】日本語変換処理の概要を示すフローチャートで
ある。

【図５】要約処理の概要を示すフローチャートである。

【符号の説明】

１０ ソースプログラム １１ 外部入出力テーブル １４ 変数変換用テーブル １７ 日本語プログラム １８ 圧縮ルール １９ 日本語仕様書 １００ 変数変換用テーブル生成処理 ２００ 日本語変換処理 ３００ 要約処理 ４００ 逆変換処理

Claims (5)

【特許請求の範囲】
1. 【請求項１】 ソースプログラムからソフトウェアの仕
   様書を生成するための装置であって、前記ソースプログ
   ラムの対外部データ入出力処理部に記述された入出力変
   数に日本語変数名を付与する日本語変数名付与手段と、
   前記入出力変数の前記ソースプログラム内での代入関係
   に基づいて同一データが代入される一又は二以上の変数
   を抽出しその抽出された変数を前記日本語変数名と対応
   させて記憶する変数解析手段と、この変数解析手段の解
   析結果及び所定の変換ルールに従って前記ソースプログ
   ラムを日本語のプログラムに変換する変換手段と、前記
   日本語のプログラムを所定の圧縮ルールに従って圧縮す
   る要約手段と、を備えたことを特徴とするソフトウェア
   の仕様書生成装置。
2. 【請求項２】 ソースプログラムからソフトウェアの仕
   様書を生成するための装置であって、前記ソースプログ
   ラムの対外部データ入出力処理部に記述された入出力変
   数に日本語変数名を付与する日本語変数名付与手段と、
   前記入出力変数の前記ソースプログラム内での代入関係
   に基づいて同一データが代入される一又は二以上の変数
   を抽出しその抽出された変数を前記日本語変数名と対応
   させて記憶する変数解析手段と、前記ソースプログラム
   を所定の圧縮ルールに従って圧縮する要約手段と、前記
   要約手段によって要約されたソースプログラムを前記変
   数解析手段の解析結果及び所定の変換ルールに従って日
   本語のプログラムに変換する変換手段と、を備えたこと
   を特徴とするソフトウェアの仕様書生成装置。
3. 【請求項３】 前記日本語変数名付与手段は、前記ソー
   スプログラムの入出力変数に対して注釈文が添えられて
   いる場合には、その注釈文に基づいて前記日本語変数名
   を決定する一方、前記ソースプログラムの入出力変数に
   注釈文が添えられていない場合には、作業者に日本語変
   数名の入力を求めるようになっている請求項１又は請求
   項２記載のソフトウェアの仕様書生成装置。
4. 【請求項４】 前記要約手段は、指定回数以上に深い入
   れ子構造を削除するようになっている請求項１乃至請求
   項３のいずれかに記載のソフトウェアの仕様書生成装
   置。
5. 【請求項５】 前記要約手段は、関数の呼出しに必要な
   変数のセット命令を削除するようになっている請求項１
   乃至請求項３のいずれかに記載のソフトウェアの仕様書
   生成装置。