Rational Developer for System z

ヘッドレス・モードでのコード・カバレッジの実行

ヘッドレス・モードは、UI を開かずに、コード・カバレッジを実行できます。UI ワークベンチがインストールされていない環境に、あるいはコマンド行から、またはスクリプトの一部としては、ヘッドレス・モードが理想的です。

このタスクについて

コマンド行から、またはスクリプトの一部として、デバッグ可能な任意のコンパイル済み言語アプリケーションに対してコード・カバレッジを実行できます。以下の 2 つのモードでヘッドレス・コード・カバレッジを実行することができます。

  1. 接続を listen しているデーモンとして実行 (指定されたポートを使用しているリモート・デバッグ・エンジンと共に使用) 。詳しくは、『デーモンを使用したヘッドレス・モードでのコード・カバレッジの実行』を参照してください。
  2. 引数として指定されるデバッグ情報と共にコンパイルされるプログラムに対する直接操作 (One Shot モード)。
    注: One Shot モードは AIX および Linux でのみ使用可能です。z Series では使用できません。
    $ codecov testProg
注: 結果は、ユーザーのホーム・ディレクトリーのルート (CC フォルダーの下) に日付別に保管されます。
codecov コマンドの構文図は、次のとおりです。
>>-codecov--+----------------------------------------------------------------------------------------------------------------+--><
            |                                                                                                                |
            + -stopdaemon=<PORT_NUMBER> -------------------------------------------------------------------------------------+
            |                                                                                                                |
            + <PROGRAM_NAME>  <PROGRAM_PARAMETERS>  -optionsfile=<PATH> --+                                                  |
            |                                                             |                                                  |
            |                                     .------------------.    |                                                  |
            |                                     v                  |    v                                                  |
            + -startdaemon  -optionsfile=<PATH> --+--------------------------+--------------------------------------------+--+
            |                                     |                  |       |                                            |  |
            |                                     + -singleconnect --+       + -output=<PATH> ----------------------------+  |
            |                                     |           	     |       |                                            |  |
            |                                     + -localonly ------+       + -cclevel=<"LINE" | "FUNCTION" | "LEVEL"> --+  |
            |                                                                |                                            |  |
            |                                                                + -prevresultpath=<"NONE" | "PREV" | PATH> --+  |
            |                                                                |                                            |  |
            |                                                                + -reportformat=<"HTML" | "NONE"> -----------+  |
            |                                                                |                                            |  |
            |                                                                + -savesource -------------------------------+  |
            |                                                                |                                            |  |
            |                                                                + -startupcommandlist=<PATH> ----------------+  |
            |                                                                |                                            |  |
            |                                                                + -zipresult --------------------------------+  |
            |                                                                |                                            |  |
            |                                                                + -port=<PORT_LIST> -------------------------+  |
            |                                                                                                                |  
            + -help ---------------------------------------------------------------------------------------------------------+  
                                           
オプション・リスト
形式: codecov [options] [program_name] [program_parameters]
program_name
コード・カバレッジを実行する対象となるプログラムの絶対パス。
注: One Shot モードは AIX および Linux でのみ使用可能です。Z Series では使用できません。
program_parameters
プログラム用のパラメーター。
注: One Shot モードは AIX および Linux でのみ使用可能です。Z Series では使用できません。
-startdaemon
デーモン・モードで開始し、接続を待機します。
-stopdaemon=port
ポートで listen しているデーモンを停止します。
-cclevel=cc_level
コード・カバレッジ・レベル ("LINE""FUNCTION" または "MODULE") を指定します。
-prevresultpath="NONE" | "PREV" | path
前の結果ファイルのパスを指定します。
-reportformat="HTML" | "NONE"
レポート形式が HTML である場合に HTML レポートを生成します。
-singleconnect
1 つのデーモン接続後に終了します (-startDaemon と共に使用する必要があります)。
-localonly
デーモンはローカル・ホストからの接続のみを受け入れます。
startupcommandlist=path
始動時にデバッガー・エンジンに送信されるコマンドを含むファイルを指定します。
-savesource
ソースを結果と共に保存します。
-optionsfile=path
指定されたオプション・ファイルからコマンド引数を読み取ります。
-tag="text"
コード・カバレッジ結果に関連付けられるタグ (例えば、テスト・ケース ID) を指定します。
-zipresult
結果ディレクトリーが、結果ディレクトリーと同じベース名の圧縮ファイルに圧縮されます。
-port=port_list
デバッグ・デーモンによって使用されるポート番号、ポート・リスト (port,port) またはポート範囲 (port-port)。
-help
ヘルプ画面を印刷します。

フィードバック