コード・カバレッジを実行すると、IBM i アプリケーションをテスト・ケースがどの程度効率的に実行しているかを調べることができます。その際、テスト・ケースで実行されたコード内の行のパーセンテージ、および行ごとのカバレッジ詳細を示す結果が報告されます。
デバッグ可能な IBM i アプリケーションに対してはいずれも、コード・カバレッジを実行することができます。
手順
- ソース・デバッグ・オプションでプログラムをコンパイルします。
注: - オプション DBGVIEW(*ALL) または DBGVIEW(*SOURCE) のいずれかを使用する必要があります。
コード・カバレッジでは、オプション DBGVIEW(*LIST) でコンパイルされたプログラムはサポートされていません。
- アプリケーション内のいくつかの部分にデバッグ情報がない場合、デバッグ情報のあるアプリケーションの部分だけがコード・カバレッジ・レポートに含まれます。
- IBM i プログラムのコード・カバレッジはツールバー、「デバッグ」パースペクティブ、または「リモート・システム・エクスプローラー」パースペクティブから実行します。
- ツールバーまたは「デバッグ」パースペクティブから:
- ツールバーにある「コード・カバレッジ」プルダウン
で、「コンパイル済みコード・カバレッジの構成...」を選択します。 ヒント: 「デバッグ」
パースペクティブでは、を
選択します。
- 新しい構成を作成します。 「IBM i: コード・カバレッジ・バッチ・アプリケーション」を右クリックし、「新規」をクリックします。
- 「コンパイル済みコード・カバレッジの構成」ダイアログの「分析対象」タブで、RSE
接続を選択し、コード・カバレッジを実行する対象のプログラムおよびサービス・プログラムを追加します。
- 「開始方法」タブで、コード・カバレッジ・ジョブを開始するコマンドを変更することができます。
このタブでは、プログラム・パラメーターとジョブ制御パラメーターを設定できます。
注: パラメーター INQMSGRPY(*DFT) はデフォルトで、コード・カバレッジ実行に設定されています。
- オプション: コード・カバレッジ・パラメーターを設定します。 デフォルトで、コード・カバレッジ結果は実行ごとに収集されます。
ただし、同じプログラムにおけるコード・カバレッジ・データを異なるパラメーターを使用して、または異なるシナリオのもとで収集するようお勧めします。
例えば、異なるパラメーターを使用することにより、if または else ブロック内の行の実行が影響を受ける可能性があります。
このような場合、コード・カバレッジ結果を累積して収集するためのオプションが用意されています。これで、コード・カバレッジ・パフォーマンスが向上します。
このオプションを選択するには、次の手順に従ってください。
- 「コード・カバレッジ」タブを選択します。
- 「前の結果に追加」(前回の起動の結果を現在の起動のベースラインとして使用)、または「特定の結果に追加」(指定した起動ファイルによるコード・カバレッジ結果を現在の起動のベースラインとして使用) を選択します。
- コード・カバレッジ・レベルを指定します。
デフォルトで、コード・カバレッジは行レベルで実行されます。
ただし、パフォーマンスの理由から、コード・カバレッジはプロシージャー・レベルまたはプログラム・レベルで実行するようお勧めします。
オプション: プログラム・レベル・コード・カバレッジを実行する場合、予期されるプログラムのリストが入ったプログラム・ファイルを指定します。
- オプション: 「レポート・オプション (Report Options)」を指定します。
デフォルトで、ワークベンチ・レポートは常に作成されます。
コード・カバレッジ完了後に HTML レポートを生成するには、「HTML レポートの生成 (Generate HTML report)」を選択してください。
コード・カバレッジ完了後に PDF レポートを生成するには、「PDF レポートの生成 (Generate PDF report)」を選択してください。
- オプション: 「その他のオプション (Additional Options)」を選択します。
エラー条件に関係なく、コード・カバレッジにレポートの作成を強制するには、「エラーを無視 (Ignore errors)」を選択してください。
コード・カバレッジ実行に関連付けたい「タグ」を指定してください。
例えば、テスト・ケースの名前または番号で、コード・カバレッジ結果にタグを付けることができます。
- 「適用」をクリックします。
- 「カバレッジ (Coverage)」ボタンをクリックします。
- 「リモート・システム・エクスプローラー」パースペクティブから:
- IBM i プログラムを選択します。
- 右クリックしてまたはを選択します。 まず最初に、起動パラメーターのプロンプトが出されることなく、すぐにコード・カバレッジ・セッションが起動します。
次に、「コンパイル済みコード・カバレッジ」起動構成ダイアログ・ボックスが開き、ここで起動パラメーターを変更することができます。
タスクの結果
コード・カバレッジ収集が「デバッグ」パースペクティブで起動しますが、コード・カバレッジ・レポートは、データ収集の完了時に現行パースペクティブで自動的に開きます。これで、コード・カバレッジ結果を表示することができます。