ジョブ定義は、ジョブ全体の動作を設定します。ジョブ定義の構造を以下に示します。
ジョブ定義の基本情報
ジョブ全体に関する情報を設定します。
ジョブ定義の環境変数定義
バッチアプリケーションで使用する環境変数を設定します。環境変数はジョブ全体で有効です。
ジョブの終了条件定義
各ステップの実行結果に応じてジョブを終了する条件を設定します。
ステップ定義
ジョブステップ定義とプロシジャ呼出しステップ定義の総称です。
ジョブステップ定義、プロシジャ呼出しステップ定義を1つ以上設定します。
ジョブステップ定義とプロシジャ呼出しステップ定義は混在して設定できます。
ジョブステップの情報を設定します。
プロシジャ呼出しステップの情報を設定します。
ジョブの基本情報として以下を設定します。
ジョブ定義名
ジョブを識別する名前です。
ジョブ定義名は、バッチジョブ定義データベースのジョブ定義内で一意な値を設定します。
“ジョブ定義名+ジョブステップ名(プロシジャ呼出しステップ名を含む)”の長さが、“255-(インストールディレクトリ名の長さ+ホスト名の長さ+60)”以下になるように設定してください。
ジョブの実行結果の通知
ジョブの実行結果に、ジョブに関する情報を通知するか設定します。
バッチジョブ定義の情報の出力有無を設定します。出力する場合は、出力範囲を以下から選択します。
ジョブ定義の内容
ジョブ定義とジョブステップ定義の内容
ジョブ定義、ジョブステップ定義、およびプロシジャ定義の内容
以下の情報を出力するか指定します。
ジョブが使用する資源の獲得情報および解放情報
以下の情報は、指定にかかわらずジョブの実行結果としてジョブログに出力します。
バッチアプリケーションの標準出力／標準エラー出力
バッチジョブ定義の文法エラー
資源の割り当て時のエラー
ジョブログについては、“Interstage Job Workload Server 運用ガイド”の“ジョブログ”を参照してください。
バッチジョブ定義情報の出力内容については、“Interstage Job Workload Server 運用ガイド”の“バッチジョブ定義情報”を参照してください。
ジョブが使用する資源の獲得情報および解放情報の出力内容については、“Interstage Job Workload Server 運用ガイド”の“バッチ実行サービスが出力したジョブメッセージ”、および“バッチアプリケーションの出力情報”を参照してください。
資源の獲得に失敗した場合の動作
バッチ実行基盤では、ジョブの実行時にジョブが使用する資源（ファイル）の排他を獲得します。この際に、獲得できなかった場合の動作を、以下から選択します。
すべての資源の排他を獲得できるまで、ジョブの実行を待ち合わせる
排他の獲得に失敗した場合、ジョブを異常終了させる
以下の場合、ジョブは指定した世代とは異なる世代を参照してしまう可能性があります。
ジョブの排他待ちが発生した場合（資源の獲得に失敗した場合の動作に[すべての資源の排他を獲得できるまで、ジョブの実行を待ち合わせる]を指定している場合）、かつ
排他獲得中の他のジョブによって、世代が作成（世代番号が更新）された場合、かつ
排他待ち終了後のジョブが同じ世代ファイルを相対世代番号で参照する場合
コメント
ジョブ定義に関するコメントを記述します。
コメントを、ジョブ情報として、ジョブログに出力できます。
ジョブ情報については、“Interstage Job Workload Server 運用ガイド”の“ジョブ情報の出力形式”を参照してください。
バッチアプリケーションで使用する環境変数を設定します。環境変数はジョブ全体で有効です。
環境変数の優先度は、以下のとおりです。
資源定義の資源名 > バッチアプリケーション定義の環境変数定義 > ジョブ定義の環境変数定義 > バッチワークユニットの環境変数 |
ジョブ定義に設定した環境変数定義が、資源定義の資源名、バッチアプリケーション定義の環境変数定義または、バッチワークユニットの環境変数に存在しない場合は、新規の環境変数として追加します。
ジョブ定義に設定した環境変数定義が、バッチワークユニットの環境変数に存在する場合は、ジョブ定義に設定した環境変数定義が有効になります。
ジョブ定義に設定した環境変数定義が、バッチアプリケーション定義の環境変数定義、または資源定義の資源名に存在する場合は、バッチアプリケーション定義の環境変数定義、または資源定義の資源名が有効になります。
環境変数値の入力域の“$”は、文字として環境変数値に設定します。
したがって、[環境変数値]の入力域に“$PATH”と設定してもシェルの変数置換を行わず、環境変数値に“$PATH”と設定されます。
環境変数値の入力域の“%”は、文字として環境変数値に設定します。
したがって、[環境変数値]の入力域に“%PATH%”と設定しても変数置換を行わず、環境変数値に“%PATH%”と設定されます。
バッチアプリケーション定義の環境変数定義については、“バッチアプリケーションに渡す環境変数”を参照してください。
資源定義の資源名については、“2.2.2.4 資源定義”を参照してください。
バッチワークユニットの環境変数については、“Interstage Job Workload Server セットアップガイド”の“環境変数の設定指針”を参照してください。
ジョブの終了条件を設定します。
ジョブの終了条件について、ジョブステップの流れに沿って説明します。
実行したジョブステップが、正常終了し、ジョブステップの終了コードが終了条件に一致した場合は、ジョブを終了します。
以下に例を示します。
先行ジョブステップが以下の場合、終了条件にかかわらずジョブは異常終了したとして取り扱います。
バッチアプリケーションでシグナルが発生した場合
アプリケーション異常終了の復帰コードの設定を有効にしている場合、かつバッチアプリケーションがその条件に一致する復帰コードを設定した場合
以下にバッチアプリケーションでシグナルが発生した場合の例を示します。
終了条件にかかわらずジョブが異常終了したとして扱われることの詳細は、“2.2.2.2 ジョブステップ定義の実行条件定義”を参照してください。
アプリケーション異常終了の復帰コードの設定については、“Interstage Job Workload Server セットアップガイド”の“アプリケーション異常終了の復帰コードの設定”を参照してください。
