テスト ランナー構文オプション

Visual COBOL コマンド ラインまたはシェル プロンプトから以下の構文を使用して、テスト スイートを実行します。

プロンプトで、次のコマンドを入力します。

test-runner [options] [test-suite] 

各要素を次に示します。

テスト ランナー
テスト スイートを実行する実行ファイルの名前。テスト結果を生成します。次のいずれかを指定できます。
  • mfurun (Windows)
  • cobmfurun32[_t](UNIX)
  • cobmfurun64[_t] (UNIX)

optional _t は、マルチスレッド ランタイム システムでテスト スイートを実行します。

options

テスト実行に適用されるオプション。これらはオプションです。以下から 1 つまたは複数を適用できます。

-testcase:testcase-name
テスト スイートから指定されたテスト ケースだけを実行します。他のテスト ケースはすべてスキップされます。デフォルトで設定されていません。
-ignore-return-code:{true|false}
true に設定されると、テストの成功または失敗を示す戻りコードは無視され、テストは継続されます。デフォルト値は false です。
-verbose:{true|false}
詳細出力を画面に表示します。デフォルト値は true です。
-process:{single|separate}
テスト実行全体に単一プロセスを使用するか、複数の別個のプロセス (テスト ランナーに 1 つ、実行内の各テスト ケースに 1 つ) を使用します。別個のプロセスを使用している場合、親テスト ランナー プロセスはエラーを記録し、テスト ケース障害発生時でもテスト実行を継続できます。デフォルト値はseparateです。
-isolate:{true|false}
テスト ケース間で共有されたリソースが各テスト ケースの正しい初期状態から開始されるよう、各テスト ケースを隔離します。デフォルト値はtrueです。
-report{printfile|noprintfile|junit|nojunit|}...
テスト結果を .txt ファイル (printfile オプション) または .xml ファイル (junit オプション) に出力します。デフォルトでは、.txt ファイルを作成します。
-reportfile:filename
.txt レポート ファイルの名前を変更します。デフォルトでは、<test suite-name>-report.txt になります。
-junit-packname:package-name
package-name で JUnit フォーマット .xml ファイルをパッケージ化します。デフォルトで設定されていません。
-outdir:directory
レポートのディレクトリを指定します。指定されなかった場合、レポートはテストが実行されたディレクトリに作成されます。
-jenkins-ci
Jenkins CI サーバーで使用されるテスト結果作成のサポートを有効にします。
-jenkins-ci:junit-attachments
Jenkins CI サーバーで使用されるテスト結果作成のサポートに加え、JUnit フォーマット結果の Jenkins プラグインも有効にします。
-jit:{core|debug}
コア ダンプ ファイルを作成するか、テスト ケース エラー発生時にジャストインタイム デバッグを呼び出します。
注: このオプションは、テスト障害アサーション時には影響しません。
-generate-mfu filename
filename (.dll ファイルまたは .so ファイル) 内のテスト ケースから、スケルトン テスト フィクスチャ ファイル (.mfu ファイル) を作成します。
注: 同じ名前の .mfu ファイルが存在していない必要があります。存在している場合、新しい .mfu ファイルは作成されません。
test-suite
COBOL プログラムは、.dll(Windows) または .so(UNIX)、あるいは.mfu バッチ ファイルにコンパイルされます。