CommandRunner ユーティリティーのジョブ・ステップ

<job-step name={step_name}>
<classname>com.ibm.websphere.batch.utility.CommandRunner</classname>
{job_step_properties}
</job-step>

<job-step name="RunJava">
<classname>com.ibm.websphere.batch.utility.CommandRunner</classname>
<props>
<prop name="com.ibm.websphere.batch.cmdLine" 
      value="java.exe com.ibm.websphere.batch.samples.TestCase" />
<prop name="CLASSPATH" value="${user.dir}\testcases;${user.dir}\bin" />
<prop name="Path" value="${java.home}\bin;${env:Path}" />
</props>		
</job-step>

com.ibm.websphere.batch.cmdLine

コマンド行の呼び出し (引数を含む) を指定します。

例えば、java.exe ファイルをコマンド行として実行します。

<prop name="com.ibm.websphere.batch.cmdLine" 
          value="java.exe com.ibm.websphere.batch.samples.TestCase" />

com.ibm.websphere.batch.workingDir

指定したコマンド行を実行する際の作業ディレクトリーを指定します。

例えば、 Linux®で作業ディレクトリーとして /tmp を有効にします。

<prop name="com.ibm.websphere.batch.workingDir" value="/tmp" />

デフォルトは未定義です。

com.ibm.websphere.batch.debug

true または false を指定して、コマンド行をデバッグ・モードで実行するかどうかを指示します。 デバッグ・モードでは、デバッグ・メッセージを表示して、変数置換の問題や、コマンド行の正しい実行の障害となるその他の問題の解決を支援します。

例えば、次のようにしてデバッグ・モードを有効にします。

<prop name="com.ibm.websphere.batch.debug" value="true" />

デフォルトは falseです。

com.ibm.websphere.batch.expansion

true または false を指定して、ジョブ・ステップのプロパティー展開 (プロパティー置換とも呼ばれます) を有効または無効にします。 このフィーチャーを無効にすると、プロパティー展開に依存しない、大きなプロパティー・マップを持つステップのステップ・パフォーマンスが向上します。

例えば、次のようにしてプロパティー展開を無効にします。

<prop name="com.ibm.websphere.batch.expansion" value="false" />

デフォルトは trueです。

com.ibm.websphere.batch.shell.executor

シェル実行プログラムのコマンドを指定します。 このプロパティーを使用して、コマンド行実行プログラムとしてカスタム・シェルを指定します。

例えば、カスタム・シェルを fastshell に指定します。

<prop name="com.ibm.websphere.batch.shell.executor" value="fasthell" />

デフォルトは、com.ibm.websphere.batch.command.runner.shell.executor システム・プロパティーの値です。

com.ibm.websphere.batch.shell.failure.rc

シェル実行失敗の戻りコードを指定します。 この戻りコードは、シェル実行プログラムが、指定されたコマンド行を実行できないことを示すために戻します。 シェル実行プログラムの戻りコードが、シェル失敗の戻りコード値に一致した場合、 CommandRunner ユーティリティー・ジョブは、ジョブ・ステップの戻りコードを com.ibm.websphere.batch.step.failure.rc プロパティーの値に設定します。

例えば、次のようにすると、指定されたコマンド行の実行が失敗したときに、シェルは -1 を戻します。

<prop name="com.ibm.websphere.batch.shell.failure.rc" value="-1" />

デフォルトは、com.ibm.websphere.batch.command.runner.shell.failure_rc システム・プロパティーの値です。

com.ibm.websphere.batch.step.failure.rc

コマンド行の実行が失敗した場合のジョブ・ステップの戻りコードを指定します。 シェル実行プログラムの戻りコードが com.ibm.websphere.batch.shell.failure.rc の値に一致したときに、このジョブ・ステップの戻りコードが戻されます。

例えば、次のようにすると、シェルの実行が失敗したときに、ジョブ・ステップは -1 を戻します。

<prop name="com.ibm.websphere.batch.step.failure.rc" value="-1" />