4.4.3 バッチジョブ定義の記述方法
バッチジョブ定義情報の形式,および必須パラメータについて,UNIXジョブのUNIT定義ファイルを基に説明する。
- 〈この項の構成〉
(1) 形式
[te="コマンドテキスト";]
[sc="スクリプトファイル名";]
[prm="パラメータ";]
[wkp="作業用パス名";]
[ev="環境変数ファイル名";]
[env="環境変数";]...
[si="標準入力ファイル名";]
[so="標準出力ファイル名";]
[se="標準エラー出力ファイル名";]
[soa={new|add};]
[sea={new|add};]
[etm=n;]
[pr="ジョブの実行優先順位";]
[ex="実行ホスト名";]
[un="実行ユーザ名";]
[jd={nm|ab|cod|mdf|exf};]
[wth=n;]
[tho=n;]
[jdf="終了判定ファイル名";]
[ts1="転送元ファイル名1";]
[td1="転送先ファイル名1";]
[top1={sav|del};]
[ts2="転送元ファイル名2";]
[td2="転送先ファイル名2";]
[top2={sav|del};]
[ts3="転送元ファイル名3";]
[td3="転送先ファイル名3";]
[top3={sav|del};]
[ts4="転送元ファイル名4";]
[td4="転送先ファイル名4";]
[top4={sav|del};]
[ha={y|n};]
[eu={ent|def};]
[jty={q|n};]
(2) 必須パラメータ
必須となるパラメータを次に示す。これ以外のパラメータの設定は任意である。
-
sc="スクリプトファイル名"
スクリプトファイル名としてbjexecを定義する。バッチジョブ実行システムのバッチジョブ起動コマンドを指定する。
指定例
sc="/opt/hitachi/bjex/bin/bjexec"
-
prm="パラメータ"
パラメータとして実行するジョブ定義XMLファイルを指定する。
指定例
prm="/home/bjex/batch/xml/sample.xml"
-
env="環境変数"
環境変数を「環境変数名=値」の形式で指定する。AJS_BJEX_STOP=TERMを必ず指定すること。指定できる文字数は1〜20,479(単位:バイト)である。
指定例
env="AJS_BJEX_STOP=TERM"
-
se="標準エラー出力ファイル名"
標準エラー出力ファイル名を指定する。ジョブコントローラでは,ジョブの終了時にエージェントホストからマネージャーホストに対して標準エラー出力ファイルとしてジョブログを転送している。ジョブログが数MBを超えるような大量データを出力するジョブを実行すると,ファイルのデータ解析処理,またはファイルのデータ転送で負荷が掛かり,CPU使用率の増加や,メモリ使用量の増加などジョブの実行が遅延するだけでなく,システム全体の処理に影響を与えるおそれがある。
ジョブログを参照する場合は,指定しないこと。ジョブログを出力しない場合は/dev/nullを指定する。
また,追加書きオプションを設定すると,ジョブ実行のたびに出力データが蓄積され,転送するファイルのサイズが増加する。この場合も,ファイルのデータ解析処理,またはファイルのデータ転送で負荷が掛かり,ジョブが異常終了したり,JP1/AJSのエージェントホストからマネージャーホストに対するデータ転送が遅延することがある。ジョブが正常に動作しない場合は,次に示す注意事項を確認し,対処方法を実施すること。
注意事項
-
標準エラー出力データが大量に出力される。
"/dev/null"を記述すること。
"/dev/null"を指定した場合,標準エラー出力への出力内容はJP1/AJS - Viewなどから参照できなくなるので,ジョブ定義の「標準エラー出力ファイル名」にファイル名を明示的に指定しているときは,バッチファイルやシェルスクリプト内で,標準エラー出力をリダイレクトすること。
設定方法の詳細については,JP1のマニュアルを参照のこと。
-
-
pr=ジョブの実行優先順位
ジョブの実行優先順位を指定する。指定できる実行優先順位は「なし」および「1」〜「5」である。ジョブの実行優先順位の指定がない場合は「なし」が仮定値となる(「なし」の場合は「1」を仮定する)。JP1/AJSを介さないでサービスからプロセスを直接起動した場合,またはコンソールからプロセスを起動した場合には,nice値は「20」で実行される。JP1/AJSから実行するジョブをこれらのプロセスと同等の実行優先順位で実行するには,ジョブの実行優先順位に「3」を設定すること。