ジョブを登録する方法、および注意事項について説明します。
なお、ジョブとして登録できるファイルや、実行属性による登録可能なジョブの違いについては、設計ガイドの“実行ファイルの検討”や“ジョブネットの実行属性と実行可能なジョブ”を参照してください。
操作手順
[登録－ジョブ]ウィンドウの表示
[ジョブネットの新規作成]ウィンドウから、アイコン選択域よりジョブネットに登録するジョブアイコンを選択し、ジョブフロー表示域にジョブをマウスを使って配置します。
→[登録－ジョブ]ウィンドウが表示されます。
[登録－ジョブ]ウィンドウの[基本情報]シート、[制御情報]シートおよび[詳細情報]シートを使って、ジョブの情報を設定し、ジョブを登録します。
リカバリジョブとして登録する場合、または先行ジョブの終了コードにより後続ジョブの起動を切り分ける場合は、[制御情報]シートで指定します。詳細は、“制御情報を登録する”を参照してください。
実行属性が[ジョブ実行制御]のジョブの場合
コマンドアシスタントを利用しない場合、以下のシートが表示されます。
コマンドアシスタントを利用する場合、アイコン種別が“コマンド実行”の場合のみ以下のシートが表示されます。その他のアイコン種別については、それぞれ個別の[基本情報]シートが表示されます。コマンドアシスタントを利用するかどうかは、[ジョブネットの/新規作成/変更/リカバリ変更/監視]ウィンドウの[表示]－[コマンドアシスタントを使う]メニューで指定できます。コマンドアシスタント利用時の詳細については、“Systemwalker Operation Manager オンラインヘルプ”を参照してください。
なお、コマンドアシスタントは、接続先のサーバがSystemwalker OperationMGR V10.0L21/V10.1以前のバージョンの場合、利用することはできません。
図4.7 [登録－ジョブ]ウィンドウ－[基本情報]シート
ジョブとして起動するバッチファイル/シェルスクリプト、コマンド、実行プログラム、Systemwalkerスクリプト、またはJCLを指定します。
[コマンド]で指定したコマンドの引数として渡す文字列を指定します。指定できるパラメタは29個までです。半角空白を含む文字列をパラメタとして指定する場合は、1つのパラメタとする文字列全体をダブルクォーテーション(")で囲む必要があります。
ジョブを実行する際のカレントディレクトリを指定します。
コメントを指定します。
ジョブ名を指定します。ここで指定したジョブ名がジョブ実行制御のジョブ名として扱われます。
UTF-8コードの環境(ネットワークジョブの場合、投入サーバまたは実行サーバのいずれかがUTF-8コードの環境)では日本語コードを使用しないでください。
本指定は省略できますが、省略時には[コマンド]に指定した文字列がジョブ実行制御のジョブ名として扱われます。このため、UTF-8コードの環境(ネットワークジョブの場合、投入サーバまたは実行サーバのいずれかがUTF-8コードの環境)で、[コマンド]文字列に日本語を含む場合は、本指定で日本語コードを含まない文字列を必ず指定してください。
ジョブをネットワークジョブとして投入するときに指定します。省略した場合、ローカルジョブとして実行されます。
ネットワークジョブを実行するサーバのホスト名を指定します。[ジョブをネットワークジョブとして投入する]チェックボックスにチェックしてある場合のみ指定できます。
ジョブの投入先キュー名を指定します。
ジョブが正常に終了したか、異常終了したか判断する値を指定します。
終了コードに関係なくジョブを正常終了する場合に指定します。ただし実行中断の場合、ジョブは異常終了となります。
ジョブの標準出力(stdout)/標準エラー出力(stderr)を保存しない場合に指定します。
図4.8 [登録－ジョブ]ウィンドウ－[詳細情報]シート
ジョブを実行するユーザ名を指定します。Operation Managerユーザを指定することはできません。
実行ユーザ名を指定した場合、以下も併せて実施が必要です。【Windows版】
[Systemwalker Operation Manager環境設定]ウィンドウから呼び出される[ジョブ所有者情報の定義]ウィンドウにて、ユーザーID・パスワードを定義
[コントロールパネル]の[管理ツール]－[ローカル セキュリティ ポリシー]などを使用し、ここで指定したユーザに“バッチジョブとしてログオン”の権限を付与
また、ドメインユーザの場合も、実際にジョブを投入するサーバおよび実行するサーバの両方で実施します。
利用するリソース名を64バイト以内で指定します。半角英数字、“_”(半角アンダーバー)、“-”(半角ハイフン)を利用することが可能です。
リソースの割当て方法を[共有]または[排他]から選択します。
ジョブの実行で生じる標準出力の出力先ファイル名を指定します。
ジョブの実行で生じる標準エラー出力の出力先ファイル名を指定します。
ジョブの実行で生じる標準エラー出力を標準出力ファイルへ出力します。指定すると、[標準エラー出力ファイル名]が指定できなくなります。
[基本情報]シートで[コマンド]に指定した実行ファイルを、 [依頼ホスト名]に指定したサーバに転送する場合に指定します。
ジョブの実行優先度を指定します。接続先サーバがWindowsの場合は0～4、UNIX版の場合は0～39の範囲で指定してください。値が大きいほど優先度が高くなります。
ジョブの実行予測時間を設定する場合に指定します。
ジョブの実行経過時間の制限値を指定します。指定できる値は、1～1666666(分)です。指定した時間でジョブの実行が打ち切られます。この場合、ジョブの終了コードは、0x40000322となります。
ジョブの出力情報に出力される“NAME=VALUE”形式の行を、ジョブネット変数に自動的に設定する場合に指定します。
ジョブネット変数名の重複を防ぐための文字列を指定します。
同一ジョブネット内に、同じ変数名で出力するジョブが複数ある場合に、[ジョブネット変数のプレフィックス]を変更することで、ジョブネット変数名の重複を防ぐことができます。
ジョブ実行時の環境変数一覧が表示されます。
環境変数を新規に作成する場合は、[追加]ボタンをクリックします。設定済の環境変数の内容を変更したい場合は、リストから環境変数を選択し、[変更]ボタンをクリックします。削除する場合は、リストから削除する環境変数を選択し、[削除]ボタンをクリックします。[追加]/[変更]ボタンをクリックした場合は、[環境変数の設定]ウィンドウが表示されます。[環境変数の設定]ウィンドウで、環境変数の入力および変更をしてください。
環境変数は、最大32個まで指定できます。
図4.9 [環境変数の設定]ウィンドウ
ジョブの環境変数名を指定します。OSの環境変数と同名の環境変数を設定しないようにしてください。
ジョブの環境変数値を指定します。省略はできません。
子ジョブネットの場合(実行属性は[ジョブ実行制御]のみ)
図4.10 [登録－ジョブ]ウィンドウ－[基本情報]シート
同一プロジェクト内に存在する、子ジョブネットとして登録可能なジョブネットの一覧が表示されます。一覧の中から子ジョブネットとして登録するジョブネットを選択します。
リンクジョブネットの場合(実行属性は[ジョブ実行制御]のみ)
図4.11 [登録－ジョブ]ウィンドウ－[基本情報]シート
マスタリンクジョブネットとして登録可能なジョブネットの、ジョブネット名とジョブネット名称が表示されます。
リンクジョブネット名を50バイト以内で指定します。
マスタリンクジョブネット候補一覧でジョブネットを選択すると、選択したジョブネットのジョブネット名＋「_」（アンダーバー）が自動的に挿入されます。アンダーバーを加えたときに50バイトを超える場合、アンダーバーは付加されません。
[マスタリンクジョブネット候補一覧]からマスタリンクジョブネットになっていないジョブネットを選択した場合、以下のメッセージが表示されます。確認をして、登録してよければ[OK]をクリックしてください。
参考
リンクジョブネットの子ジョブネット名について
マスタリンクジョブネットが階層化されている場合、その子ジョブネットは「マスタリンクジョブネットの子ジョブネット名+"_"+リンクジョブネット名」でプロジェクトに登録されます。
注意
リンクジョブネットの登録について
リンクジョブネットを登録する場合、リンクジョブネット名が他のジョブネットやリンクジョブネットのジョブネット名と重複しないようにしてください。マスタリンクジョブネットが階層化されている場合は、その子ジョブネットについてもジョブネット名が重複しないようにしてください。
実行属性が[ジョブ実行制御]のバッチフレームワークジョブの場合
Interstage Job Workload Serverのジョブを投入する場合に使用します。
図4.12 [登録－ジョブ(バッチフレームワークジョブ)]ウィンドウ－[基本情報]シート
バッチジョブ定義名を指定します。
ジョブ投入先のジョブキュー名を指定します。
リカバリ実行時、ジョブの再開位置となるジョブステップを指定する場合に指定します。
コメントを指定します。
ジョブ名を指定します。省略時は、[バッチジョブ定義名]をジョブ名として扱います。
ジョブログ情報を出力するファイル名をフルパスで指定します。
各ジョブステップが出力した標準出力／標準エラー出力情報が不要な場合に指定します。
キュー内のジョブ実行優先順位を指定します。
ジョブの実行予測時間を設定する場合に指定します。
ジョブの実行経過時間の制限値を指定します。指定できる値は、1～1666666(分)です。指定した時間でジョブの実行が打ち切られます。この場合、ジョブの終了コードは、0x40000322となります。
ジョブが正常に終了したか、異常終了したか判断する値を指定します。
ジョブの終了コードとして、最後に実行されたジョブステップの終了コードとする場合に指定します。
終了コードに関係なくジョブを正常終了する場合に指定します。ただし実行中断の場合、ジョブは異常終了となります。
バッチ定義内の置換えパラメタ一覧が表示されます。置換えパラメタは“パラメタ名=パラメタ値”の形式で表示されます。
置換えパラメタを新規に作成する場合は、[追加]ボタンをクリックします。設定済の置換えパラメタの内容を変更したい場合は、リストから置換えパラメタを選択し、[変更]ボタンをクリックします。削除する場合は、リストから削除する置換えパラメタを選択し、[削除]ボタンをクリックします。[追加]/[変更]ボタンをクリックした場合は、[パラメタの設定]ウィンドウが表示されます。[パラメタの設定]ウィンドウで、置換えパラメタの入力および変更をしてください。
バッチ定義内の置換えパラメタは、最大32個まで指定できます。
バッチ定義内の置換えパラメタ名を指定します。
バッチ定義内の置換えパラメタ値を指定します。
実行属性が[Interstage]の場合
Interstageのワークユニットを投入する場合に使用します。
図4.13 [登録－ジョブ]ウィンドウ－[基本情報]シート
Interstageに依頼するジョブ名(ワークユニット名)を指定します。
ワークユニットのシステム名を指定します。
コメントを指定します。
ジョブをネットワークジョブとして投入するときにチェックします。省略した場合、ローカルジョブとして実行されます。
ネットワークジョブを実行するサーバのホスト名を指定します。[ジョブをネットワークジョブとして投入する]チェックボックスがチェックされている場合にのみ指定できます。
ジョブの投入先を、オンライン業務専用キュー名で指定します。
利用するリソース名を64バイト以内で指定します。半角英数字、“_”(半角アンダーバー)、“-”(半角ハイフン)を利用することが可能です。
リソースの割り当て方法を[共有]または[排他]から選択します。
ジョブが正常に終了したか、異常終了したか判断する値を指定します。
終了コードに関係なくジョブを正常終了する場合に指定します。ただし実行中断の場合、ジョブは異常終了となります。
注意
Interstage属性のジョブの登録について
Interstage属性のジョブネットには、Interstageアイコンのジョブのみ登録できます。他のアイコンのジョブは登録できません。
Interstage属性のジョブネットには、ジョブを1つしか登録できません。
Interstage属性以外のジョブネットには、Interstageアイコンのジョブを登録することはできません。
実行属性が[旧バージョン互換(旧・標準)]の場合【UNIX版】
図4.14 [登録－ジョブ]ウィンドウ－[基本情報]シート
ジョブとして起動するシェルスクリプト、コマンド、実行プログラムを指定します。
ジョブを実行する際のカレントディレクトリを指定します。
コメントを指定します。
ジョブが正常に終了したか、異常終了したか判断する値を指定します。
終了コードに関係なくジョブを正常終了する場合に指定します。ただし実行中断の場合、ジョブは異常終了となります。
ジョブの標準出力(stdout)/標準エラー出力(stderr)を保存しない場合に指定します。
注意
[登録－ジョブ]ウィンドウについて
コマンド欄の指定方法
ジョブスケジューラに登録した“ジョブ実行制御”属性のジョブは、qsubコマンドの形式でジョブ実行制御へ投入されます。したがって、[登録－ジョブ]ウィンドウで登録するジョブの実行ファイル名には、実行するジョブの実行ファイル名をジョブ実行制御のqsubコマンドのオプションを含めて指定します。なお、ジョブスケジューラはqsubオプション“-x”、“-nr”、“-j”、“-cu”、“-rh”、“-jft”、“-q”、“-R”、“-e”、“-o”、“-eo”、“-lt”、“-dp”を自動的に設定するため、[コマンド]欄には指定しないでください。
[qsubコマンドのオプション] 実行ファイル名 |
ジョブの検索条件について
実行ファイルの格納先は、以下の順番で検索されます。
[コマンド]欄＞[ディレクトリ]欄＞ジョブフォルダ
[コマンド]欄にフルパスで実行ファイル名が指定されている場合は、[ディレクトリ]欄に格納先ディレクトリが指定されていても検索対象となりません。
終了コードについて
ジョブの終了コードは、実行ファイルの復帰値(例えば、C言語で作成されている場合は、exit関数で指定された値)になります。Windows版の場合でバッチファイルの場合は、バッチファイル内の最終コマンドの復帰値になります(バッチファイル内にsetecodeコマンドを記述して、復帰値を制御することができます。setecodeコマンドの詳細は、“B.6.2 ジョブとしてバッチファイルを使う場合【Windows版】”を参照してください)。ジョブスケジューラで扱える終了コードの値は、256までです。ただし201～256までの終了コードはジョブスケジューラで使用しているため、ジョブの終了コードは、200以下になるようにしてください。実行ファイルの復帰値として201～256が使用された場合、終了コードが実行ファイルで設定された値か、ジョブスケジューラが設定した値かの区別がつきにくくなります。なお、実行ファイルの復帰値が255以上の場合は255として扱われます。
標準出力ファイル/標準エラー出力ファイルについて
複数のジョブに同名の標準出力ファイル/標準エラー出力ファイルを指定しないでください。前回履歴が正しく表示されない場合があります。
コマンド欄へ登録するコマンドについて【Windows版】
システムおよびジョブスケジューラを停止させる処理を登録し、実行した場合、ジョブおよびジョブネットが次回のジョブスケジューラ起動時に[実行中断](終了コード“239”)となる場合があります。
システムのシャットダウンは、終了処理ジョブネットを利用し、シャットダウン出口から実施してください。終了処理ジョブネットの詳細は、“B.6.1 任意の時刻にシステムをシャットダウンする【Windows版】”を参照してください。
ジョブ実行制御のqsubコマンドについて
ジョブ実行制御のqsubコマンドやジョブ実行制御のqsubコマンドを呼び出しているバッチファイル/シェルスクリプトを[コマンド]欄に指定しないでください。
UTF-8コードの環境を利用する場合について
UTF-8コードの環境(ネットワークジョブの場合、投入サーバまたは実行サーバのいずれかがUTF-8コードの環境)では日本語コードを使用しないでください。
制御情報を登録する
リカバリジョブを登録する場合、または先行ジョブの終了コードにより、後続ジョブの起動を切り分ける場合は、[制御情報]シートで指定します。
図4.15 [登録－ジョブ]ウィンドウ－[制御情報]シート
ジョブネットの再起動時に、このジョブから実行する場合に指定します。
次回のジョブネットの再起動時に、無効扱いすることを指定します。
先行ジョブが異常時に起動される、リカバリジョブであることを指定します。先行ジョブがジョブネットである場合にも設定できます。
リカバリジョブが正常終了した後に、元の異常終了したジョブを1回だけ再起動できます。
先行ジョブが正常または疑似正常終了した場合に、その終了コードによってジョブを起動するかどうかを切り分ける場合に指定します。先行ジョブの数が1つだけの場合に設定できます。
[起動条件]を指定した場合、[先行ジョブの終了コードによる起動条件]で、[比較条件]か[範囲条件]かをコンボボックスから選択します。
起動する条件として、判定用演算子をコンボボックスから選択します。比較する値を入力して指定します。
起動する条件として、判定用演算子をコンボボックスより選択します。比較する値を入力して、実行条件となる先行ジョブの終了コードの範囲を指定します。
複数の先行ジョブをOR条件で待ち合わせる場合に指定します。先行ジョブが、以下のいずれかの待ち合わせジョブの場合に指定できます。
ファイル待ち合わせ
メッセージ事象待ち合わせ
時刻待ち合わせ
指定時間待ち合わせ
なお、本項目を指定した場合、上記、待ち合わせジョブから複数の後続ジョブに接続線を引くことはできません。
子ジョブネット、およびリンクジョブネットに起動日を設定したいとき、設定した起動日を有効とし、運用日ごとにジョブネットの構成を変更する場合に指定します。ジョブネットアイコン、およびリンクジョブネットのジョブに対してのみ表示されます。
[再起動ポイント]、[リカバリ]、[起動条件]のいずれかと、[起動日のみ有効]は同時に指定できません。
[起動日のみ有効]を指定した場合、後続ジョブの[起動条件]は指定できません。[起動条件]を指定した場合、先行ジョブの[起動日のみ有効]は指定できません。
子ジョブネット、またはリンクジョブネットが先行ジョブとなっている状態で、[起動条件]を指定した場合は、子ジョブネット、またはリンクジョブネットの終了コードが先行ジョブの終了コードとして判定されます。
