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

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

test-runner [options] [test-suite] 

各要素を次に示します。

test-runner

テスト スイートを実行する実行ファイルの名前。テスト結果を生成します。次のいずれかを指定できます。

• mfurun (Windows) - 手続き型 COBOL で使用
• mfurunj (Windows) - JVM COBOL で使用
• cobmfurun32[_t](UNIX) - 手続き型 COBOL で使用
• cobmfurun64[_t] (UNIX) - 手続き型 COBOL で使用
• cobmfurunj (UNIX) - JVM COBOL で使用

オプションの「_t」は、マルチスレッド ランタイム システムでテスト スイートを実行し、タイムアウト値を使用するテストで必要となります。

オプション

テスト実行に適用されるオプション。これらはオプションです。以下のうち 1 つ以上を適用できます。

-testcase:testcase-name

指定したテスト ケースだけをテスト スイートから実行します。他のテスト ケースはすべてスキップします。デフォルトでは設定されていません。

または、次のいずれかの方法を使用して、複数のテスト ケースを指定することもできます。

• 区切り文字としてカンマを使用してテスト ケースをリストする。

  -testcase:testcase-name1,testcase-name2,... everything.dll

  または

• テスト ケースのリストを含むサイド ファイルを指定する。

  -testcase:@filelist.txt everything.dll

各要素を次に示します。

• everything.dll - コンパイルしたすべてのソース コード
• filelist.txt - 実行するすべてのテスト ケースのリストを含むファイル

-ignore-options-in-mfu:{true|false}

指定したテスト フィクスチャ ファイル内のオプションを無視し、コマンド ラインで指定したオプションでそれらをオーバーライドできます。

-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 ファイルを作成します。JUnit レポートは、TEST-<package-name>-<test-case-name>.xml という形式になります。-junit-packname:package-name オプションを使用して <package-name> を設定します。

-generate-flist:filename

失敗したテスト名のリストを filename に出力します。

ヒント: 生成したファイルを使い、-testcase:@filename test-suite 構文を使用して、失敗したテストを再実行できます。

-report:markdown

テスト結果を GitHub スタイルのマークダウン形式ファイル (.md) に出力します。

注: pandoc ユーティリティ (http://pandoc.org/ を参照) などのさまざまな外部ユーティリティを使用して、マークダウン ファイルを .html または .pdf ファイルに変換できます。pandoc を使用する場合に .md ファイルを変換するコマンド例は以下のとおりです。

pandoc -thtml5 -s -S --toc -c pandoc.css -fmarkdown_github mfumeta.md -o mfumeta.html

または

pandoc -s -S --toc -c pandoc.css -fmarkdown_github mfumeta.md -o mfumeta.pdf

-report:timings-csv

テスト実行のタイミングを含む .csv ファイルを生成します。

-reportfile:filename

.txt レポート ファイルの名前を変更します。デフォルトのファイル名は <test suite-name>-report.txt です。

-junit-packname:package-name

package-name で JUnit フォーマットの .xml ファイルをパッケージ化します。デフォルトでは設定されていません。

-outdir:directory

レポートのディレクトリを指定します。これを指定しない場合、レポートはテストが実行されたディレクトリに作成されます。

-trait:trait-name(s)

指定した特性名のテスト ケースのみを実行するように指定します (その他のテスト ケースはすべてスキップします)。必要に応じて、複数の特性をコンマで区切って指定できます。テスト ケースの特性を設定するには、ソース コードで MFU-MD-TRAITS 変数を使用するか、テキスト フィクスチャ ファイルで traits=trait-name を指定します。

ヒント: このオプションを -generate-mfu オプションと組み合わせて、特定の特性を持つテスト ケースのみを実行するように設計されたテスト フィクスチャ ファイルを作成できます。以下に例を示します。

Windows：

mfurun -generate-mfu -trait:smoke test-suite.dll

UNIX：

cobmfurun32|64[_t] -generate-mfu -trait:smoke test-suite.so

-jenkins-ci

Jenkins CI サーバーで使用されるテスト結果作成のサポートを有効にします。

-jenkins-ci:junit-attachments

Jenkins CI サーバーで使用されるテスト結果作成のサポートに加え、JUnit フォーマット結果の Jenkins プラグインも有効にします。

-silk-central

結果を Silk Central と互換性のある .xml ファイルに出力します。output.xml ファイルおよび必要なアセット (ログ ファイルおよびダンプ ファイル) は、SCTM_EXEC_RESULTSFOLDER 環境変数で指定された場所に配置され、Silk Central が検出して処理できます (ProcessExecuter テストの詳細については Silk Central のヘルプを参照してください)。Silk Central 環境が正しく構成されていない状態でこのオプションを指定すると、エラーが発生します。

-jit:{core|debug}

コア ダンプ ファイルを作成するか、テスト ケース エラー発生時にジャストインタイム デバッグを呼び出します。

注: このオプションは、テスト障害アサーション時には影響しません。

-debugbreak

デバッガーを直ちに起動します。

-debugstart:id

指定した id を使用して、デバッガーに開始または待機コマンドを発行します。

-generate-mfu filename

filename (.dll ファイルまたは .so ファイル) 内のテスト ケースから、スケルトン テスト フィクスチャ ファイル (.mfu ファイル) を作成します。

-high-res-timer:{true|false}

true に設定すると、ネイティブの高分解能パフォーマンス カウンターを使用して、テスト実行の期間を報告します。デフォルト値は false です。

注: 高分解能の時間計測は、junit または Silk Central の .xml 形式では表示できません。通常の時間計測が常に表示されます。

test-suite

COBOL プログラムは、.dll(Windows) または .so(UNIX)、あるいは.mfu テスト フィクスチャ ファイルにコンパイルされます。手続き型マネージ プログラムの場合は、代わりに .jar ファイルを指定します。