テスト・カバレッジ構成ファイル

テスト・カバレッジ構成ファイルの例は、%ProgramFiles%\Micro Focus\Visual COBOL\etc\default.tcf にあります。このファイルを編集したり、そのまま使用したりすることができます。

構成は、次のフォーマットのテキスト・ファイルになります。

[TESTCOVER]
; comment
RESULT filename.tcz [ACCUMULATE]
ECHOLOG [YES|NO]
LOGNAME [filename]
オプションの詳細は次のとおりです。
[TESTCOVER]
構成ファイルにはこのタグが含まれていなければなりません。ファイルをテスト・カバレッジ構成ファイルとして識別します。
; comment
セミコロン (;) はコメント行を示します。セミコロンは、ファイルの最初の列に配置してください。コメントはファイルのどの場所にも表示できます。任意。
RESULT filename.tcz [ACCUMULATE]
作成する結果 (.tcz) ファイルを指定します。構成ファイルにはキーワード RESULT が必要です。
ACCUMULATE
任意。指定した場合、テスト・カバレッジは、連続実行の結果を 1 つの結果ファイル filename.tcz に蓄積します。

ACCUMULATE を省略した場合、変数バージョンの filename.tcz (下記を参照) を使用しないかぎり、テスト・カバレッジは実行のたびに filename.tcz を上書きします。

filename.tcz
テスト・カバレッジの結果を保持するファイルの名前。ファイルが存在しない場合、新しいファイルが作成されます。

filename.tcz には次の内容を含めることができます。

  • 絶対または相対パス名。パス名に存在しないフォルダの名前が含まれる場合、次のようなフォルダが作成されます。
    RESULT tcresult.tcz

    結果ファイル tcresult.tcz を現在のフォルダに作成します。また、次のような場合もあります。

    RESULT ./results/tcresult.tcz

    この場合は、結果ファイル tcresult.tcz をフォルダ results に作成します。このフォルダは、現在のフォルダの下に作成されます。

  • 名前に疑問符 (?) のワイルドカードを使用した変数ファイル名。

    この場合、ファイル名は str????.tcz の形式で指定します。str は適切な文字列になります。テスト・カバレッジは、ワイルドカード文字列 str????.tcz に一致するファイルを検索します。ワイルドカード文字の位置にある最大数値を取得してその値を増分し、結果を書き込むファイル名に増分した値を使用します。

    例えば、ファイル名を x????.tcz と指定し、ファイル x0001.tczx0002.tcz が既に存在する場合、テスト・カバレッジは自動的に x0003.tcz を作成します。

    生成された数字の桁数は、ワイルドカードの数と同じになります。例えば、 x??.ccz は、x01.cczx02.ccz などを生成します。

    変数ファイル名を使用すると、実行ごとに構成ファイルを変更せずにテスト・カバレッジの複数の実行に対して個別の結果ファイルを作成できます。

  • トークン <pid> は、現在のプロセス ID で置き換えられます。次に例を示します。
    RESULT myres_<pid>.tcz

    プロセス ID を 2749 と想定し、結果ファイル myres_2749.tcz を作成します。

ECHOLOG [YES|NO]
テスト・カバレッジのサマリを画面に反映させるかどうかを指定します。任意。

オプションを指定しない場合やキーワードが省略された場合のデフォルトは YES です。

例えば、デバッグ時に画面へのアクセスに関する問題がアプリケーションで発生した場合は、ECHOLOG NO を使用します。

LOGNAME [filename]
各実行の最後に、テスト・カバレッジのサマリが filename に付加されます。filename を指定しない場合、projectdir\testcover\TESTCOVR.LOG という名前のデフォルト・ファイルが使用されます。projectdir は、プロジェクトが配置されているフォルダです。任意。

LOGNAME キーワードに指定されたトークン <pid> を含めることができます。このトークンの詳細は、 RESULT キーワードの説明を参照してください。

構成ファイルには少なくとも次の内容を含めることをお奨めします。

[TESTCOVER]
ECHOLOG NO
RESULT filename.tcz ACCUMULATE
注:
  • RESULT、ECHOLOG、LOGNAME の各キーワードが使用できるのは 1 度だけです。複数のインスタンスで各キーワードを使用できます (キーワードの前にコメント文字のセミコロン (;) が付いた非アクティブ状態の場合)。

RESULT キーワードの例

Windows の場合:
RESULT .\results\tcresult.tcz ACCUMULATE
UNIX の場合:
RESULT /usr/mydir/results/tcresult.tcz ACCUMULATE

テスト・カバレッジは、現在のフォルダに相対的な results フォルダにある tcresult.tcz にすべての結果を蓄積します。

Windows の場合:
RESULT c:\myres\tcresult.tcz
UNIX の場合:
RESULT /usr/mydir/tcresult.tcz

ACCUMLATE 動詞が省略されているため、テスト・カバレッジは、その結果をファイル tcresult.tcz に保存します。このファイルは、実行ごとに上書きされます。

RESULT run????.tcz

実行ごとに個別の結果ファイルが使用されます。この例では、最初の実行ではテスト・カバレッジによって結果ファイル run0001.tcz が作成されます。2 回目の実行では、結果ファイル run0002.tcz が作成されます。この数字は実行が追加されるたびに増分します。

構成ファイルの例

[TESTCOVER]
RESULT run????.tcz
ECHO NO
LOGNAME testcover.log

この例は、完全な構成ファイルを示しています。実行ごとに個別の結果ファイルが使用されます。結果は画面に反映されません。結果のサマリが testcover.log に付加されます。