15.3.1　カバレージ情報の表示の方法（テキスト形式）

(1)　カバレージ情報の表示の手順

バッチモードでカバレージ情報を表示するときの作業の流れを説明します。

1. -CVInfコンパイラオプションを指定して，プログラムをコンパイルする。

   コンパイラオプションについては，「9.1.2　プログラムのコンパイル」を参照してください。

2. cblcl2kコマンドを指定して，実行する。

3. コマンドに指定したカバレージ情報リストファイルをテキストエディタで開き，内容を確認する。

(2)　cblcl2kコマンドの指定形式

形式

-List

すべてのプログラムのカバレージ情報一覧を表示します。

-Summary

カバレージ情報のまとめを表示します。

-Source

すべてのソース情報を表示します。

-Difference

差分ソース情報を表示します。

-Unexecuted

未実行ソース情報を表示します。

-UnexecutedDifference

差分未実行ソース情報を表示します。

-Activate

呼び出し文情報を表示します。

-All

すべての情報を表示します。次の引数をすべて指定したのと同じです。

-List，-Summary，-Source，-Difference，-Unexecuted，-UnexecutedDifference，-Activate

-Allが指定されたときは，ほかの引数は無視されます。

-Output

カバレージ情報リストファイルのパス名を指定します。省略時はカレントフォルダに，最初に指定したプログラム情報ファイル名に拡張子「.cll」を付けたファイル名で出力します。

-Input

プログラム情報ファイルのパス名を指定します。

-?

cblcl2kコマンドの構文を表示します。-?を指定すると，ほかの引数はすべて無視されます。

出力されるカバレージ情報リストの詳細については，「13.2.5　カバレージ情報の表示（テキスト形式）」を参照してください。

注意事項

• -List，-Summary，-Source，-Difference，-Unexecuted，-UnexecutedDifference，-Activateまたは-Allオプションを何も指定しなかった場合，-Allオプションを仮定します。

• cblcl2kコマンドのメッセージは標準エラー出力に出力します。

• コマンド名，引数は，英大文字，英小文字のどちらでも指定できます。引数の始まりは，ハイフン（-）の代わりにスラント（/）も使用できます。

• コマンド名だけを指定した場合は，コマンドの構文を表示します。

• 引数の区切り記号は空白文字とタブです。空白文字とタブを区切り記号としたくないときは，引数をダブルコーテーション（"）で囲みます。例えば，空白文字を含むファイル名はファイル名をダブルコーテーション（"）で囲んで指定します。

• 「@コマンドファイル名」の形でコマンドファイルが指定できます。コマンドファイルの内容は，実行時にコマンドラインに変換されます。コマンドファイルはコマンド名よりあとに指定します。

• 同じ引数を複数指定した場合は，あとに指定した引数のパラメタを有効とします。

• 引数にパスの付かないファイル名だけを指定した場合は，カレントフォルダのファイルとします。フォルダ名だけを指定した場合は，カレントフォルダ下にあるフォルダとします。相対パスで指定された場合は，カレントフォルダを基準に検索します。ただし，プログラム情報ファイルを指定した場合は，環境変数CBLPIDIRの指定が有効となります。

• コマンドが返すリターン値は，次のとおりです

  リターン値	内容
  0	正常終了
  1	エラー発生による終了

• -？引数が指定された場合のコマンドの構文は，標準出力に出力されます。それ以外のメッセージは，標準エラー出力に出力されます。

(3)　環境変数の指定

カバレージ表示に必要なファイルを環境変数に指定します。