15.2.1 コマンドによる方法
コマンドプロンプトからコマンドを入力して,カバレージ情報を蓄積します。
カバレージ情報の詳細については,「13.2.1 カバレージ情報」を参照してください。
(1) カバレージ情報の蓄積の手順
バッチモードでカバレージ情報を蓄積するときの作業の流れを説明します。
-
-CVInfコンパイラオプションを指定して,プログラムをコンパイルする。
コンパイラオプションについては,「9.1.2 プログラムのコンパイル」を参照してください。
-
カバレージ情報の蓄積または,カバレージ情報の蓄積対象プログラムの実行に必要な環境変数を設定する。
プログラムの実行に必要な環境変数とカバレージに必要な環境変数を設定します。カバレージに必要な環境変数については,「15.2.1 コマンドによる方法」の「(3) 環境変数の指定」を参照してください。プログラムの実行に必要な環境変数については,マニュアル「COBOL2002 ユーザーズガイド」を参照してください。
-
cblcv2kコマンドを指定して,実行する。
-
実行結果をコマンドプロンプトに出力されるメッセージから確認する。カバレージ情報の蓄積結果は,カバレージ表示機能を使用して確認する。
カバレージ表示機能については,「13.2 カバレージ情報の表示と操作」を参照してください。
(2) cblcv2kコマンドの指定形式
- 形式
-
- -Library
-
カバレージ情報の蓄積をするDLLファイル名(.dll)を指定します。
- -Execute
-
カバレージ情報の蓄積をする実行可能ファイル名(.exe)を指定します。
- プログラムへ渡すパラメタ
-
カバレージ情報の蓄積をするプログラムへ渡す引数を指定します。
- -?
-
cblcv2kコマンドの構文を表示します。-?を指定すると,ほかの引数はすべて無視されます。
- 注意事項
-
-
-Libraryオプションは,複数のファイル名を指定できます。
-
-Executeオプションは,必ず,最後に指定してください。-Executeオプション以外のオプションの指定は任意です。
-
実行可能ファイル名のあとに指定されたものすべてをカバレージ情報の蓄積対象プログラムへ渡すパラメタとみなします。
-
起動後のカレントフォルダは,cblcv2kコマンドを実行したフォルダです。
-
cblcv2kコマンドのメッセージは,標準エラー出力へ出力します。
-
コマンド名,引数は,英大文字,英小文字のどちらでも指定できます。引数の始まりは,ハイフン(-)の代わりにスラント(/)も使用できます。
-
コマンド名だけを指定した場合は,コマンドの構文を表示します。
-
引数の区切り記号は空白文字とタブです。空白文字とタブを区切り記号としたくないときは,引数をダブルコーテーション(")で囲みます。例えば,空白文字を含むファイル名はファイル名をダブルコーテーション(")で囲んで指定します。
-
「@コマンドファイル名」の形でコマンドファイルが指定できます。コマンドファイルの内容は,実行時にコマンドラインに変換されます。コマンドファイルはコマンド名よりあとに指定します。
-
同じ引数を複数指定した場合は,あとに指定した引数のパラメタを有効とします。
-
引数にパスの付かないファイル名だけを指定した場合は,カレントフォルダのファイルとします。フォルダ名だけを指定した場合は,カレントフォルダ下にあるフォルダとします。相対パスで指定された場合は,カレントフォルダを基準に検索します。ただし,プログラム情報ファイルを指定した場合は,環境変数CBLPIDIRの指定が有効となります。
-
コマンドが返すリターン値は,次のとおりです
リターン値
内容
0
正常終了
1
エラー発生による終了
-
-?引数が指定された場合のコマンドの構文は,標準出力に出力されます。それ以外のメッセージは,標準エラー出力に出力されます。
-
(3) 環境変数の指定
カバレージ情報の蓄積に必要な環境変数を指定します。システム,またはバッチモードを実行するコマンドプロンプトに設定します。
(a) CBLPIDIR
作成または更新したプログラム情報ファイルのあるフォルダを指定します。
カバレージ情報の蓄積対象であるプログラムの実行に関するその他の環境変数については,マニュアル「COBOL2002 ユーザーズガイド」を参照してください。
- 注意事項
-
-
プログラム情報ファイルを次の順序で検索します。検索した結果,プログラム情報ファイルが見つからないときは,プログラム情報ファイルに該当するプログラムはカバレージ情報の蓄積の対象となりません。
1. 環境変数CBLPIDIRで指定したフォルダ
2. 実行可能ファイルに含まれるプログラムは,実行可能ファイルのあるフォルダ
DLLファイルに含まれるプログラムは,DLLファイルのあるフォルダ
3. カレントフォルダ
-
プログラムが-CVInfコンパイラオプションを指定してコンパイルされていない場合は,カバレージ情報の蓄積の対象となりません。
-
カバレージ情報の蓄積の対象となるプログラム情報ファイルが一つもない場合は,カバレージ情報の蓄積は行いません(カバレージ情報の蓄積対象プログラムの実行も行いません)。
-