2.4.4　事象の発生を契機に処理を実行する（イベントジョブを使ったジョブネットの定義例）

(1)　JP1イベントの受信を契機に処理を実行する（JP1イベント受信監視ジョブ）

JP1イベントとは，JP1/Baseで管理される，JP1シリーズプログラムで事象が発生するたびに発行されるイベントをいいます。JP1イベントは，エラー，警告，通知などの重大度やメッセージなどの情報を持っているため，エラーや警告イベントの受信や，特定のメッセージの受信を契機に後続ジョブやジョブネットを実行させることができます。また，JP1/Baseのイベント変換機能を使って，JP1シリーズ以外のアプリケーションの終了を契機に後続ジョブやジョブネットを実行させることもできます。

JP1イベント受信監視ジョブを実行する際は，実行前にJP1/Baseイベントサービスを起動しておく必要があります。JP1/BaseイベントサービスのAPI設定は「keep-alive」にしておいてください。起動されていない場合，JP1イベント受信監視ジョブはサービスが起動されるまで「実行中」状態のままとなります。

「hostAからJP1イベントを受信したら，後続ジョブを実行する（ジョブネットを定義するホストをhostBとする）」というジョブネットを，JP1イベント受信監視ジョブを使って定義する例を，次の図に示します。

図2‒76　JP1イベント受信監視ジョブを使ったジョブネットの定義例

JP1イベント受信監視ジョブは，他ホストのジョブネットと連携できます。

hostAでジョブネットにJP1イベント送信ジョブ（イベントID：100）を定義します。hostAで発行したJP1イベントを監視対象とするために，JP1イベント受信監視ジョブの［イベント発行元ホスト名］に「hostA」を設定します。また，hostAからJP1イベントを受信した場合に後続ジョブを実行させるために，［イベントID］には「100」を設定します。

これによって，hostAでジョブネット中のJP1イベント送信ジョブが実行されると，JP1イベントの監視が終了して，後続ジョブが実行されます。

なお，JP1イベント受信監視ジョブを定義した場合，JP1イベント受信監視ジョブが実行されてから実際にJP1イベント受信監視ができる状態になるまでにタイムラグが発生し，この間に発生したJP1イベントは検知できません。この問題を解決するための機能として，実行前のイベント検索があります。

• 実行前のイベント検索

  JP1イベント受信監視ジョブが実際にJP1イベントの受信を監視できる状態になる時点より前に発生したイベントを検索し，該当したイベントがあった場合にそれをイベント発生と見なします。

  図2‒77　実行前のイベント検索

ページの先頭へ

(2)　ファイルの更新を契機に処理を実行する（ファイル監視ジョブ）

ファイル更新や新規ファイルの作成などを契機にジョブを実行するジョブネットの定義には，ファイル監視ジョブを使用します。

ファイル監視ジョブで指定できる監視条件を次に示します。

監視条件

監視対象のファイルがどのような状態になったときに条件成立とするのかを指定します。監視条件は，次の四つから設定できます。

• 指定したファイル名のファイルが作成されたとき

• 指定したファイル名のファイルが削除されたとき

• 指定したファイル名のファイルのサイズが変更されたとき

• 指定したファイル名のファイルの最終書き込み時刻が更新されたとき

補足事項

• ファイルの作成を監視条件とした場合に，ファイル監視ジョブが監視を開始した時点で指定した名称のファイルがすでにあったとき，ファイル監視ジョブの監視条件を成立させるかどうかを指定できます。

• 監視条件は複数指定できます。例えば，ファイルが削除または更新されたら後続ジョブを実行するように定義する場合は，ファイルの削除と最終書き込み時刻変更を指定できます。ただし，ファイルのサイズ変更と最終書き込み時刻変更は同時に指定できません。

• 監視条件が成立する場合および成立しない場合の詳細については，「7.6.2(1) ファイル監視ジョブで監視する事象」を参照してください。

• ファイルの作成，サイズ変更，および最終書き込み時刻変更の監視条件に合致した場合，監視対象のファイルにファイル監視ジョブ以外のプロセスがアクセスしていないかチェックします。これをクローズチェックといいます。

  監視条件に合致しても，ファイル監視ジョブ以外のプロセスが監視対象のファイルにアクセスしていた場合は条件成立となりません。その場合，次回の監視間隔に繰り越して監視し，そこでファイル監視ジョブ以外のプロセスのアクセスがなければ条件成立となります。

  このクローズチェックをすることで，ファイルコピー中など転送中の監視対象のファイルが条件成立となることを防ぐことができます。

• 監視対象は，ネットワークを介したファイルを指定できます。

「あるファイル（ファイル名：ファイル1）の書き込み時間を監視し，ファイルが更新されたときに後続ジョブを実行する」というジョブネットを，ファイル監視ジョブを使って定義する例を次の図に示します。

図2‒78　ファイル監視ジョブを使ったジョブネットの定義例

ファイル監視ジョブに監視対象ファイル名と監視条件を設定します。［監視対象ファイル名］にはファイル1のパスを，［監視条件］には［最終書き込み時刻変更］を指定します。

これによって，監視対象のファイルがクローズ（アクセスしているアプリケーションがなくなった）し，最終書き込み時刻が更新された時点でファイル監視ジョブが終了となり，条件成立となります。

ネットワークを介したファイルを監視する場合は，環境設定パラメーターNetworkFilewatchに「Y」を設定します。ネットワークを介したファイルを監視するための設定については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　6.3.19 ネットワークを介したファイルをファイル監視ジョブで監視するための設定」（Windowsの場合）またはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　15.3.18 ネットワークを介したファイルをファイル監視ジョブで監視するための設定」（UNIXの場合）を参照してください。

また，監視対象に指定するネットワークを介したファイルに，次のとおりアクセス権限を設定してください。

Windowsの場合

監視対象のファイルの変更権限を持つユーザーアカウントを，JP1/AJS3サービスを起動するユーザーアカウントに設定してください。JP1/AJS3サービスを起動するユーザーアカウントを変更する場合の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　4.2.3 JP1/AJS3のサービスの設定を変更する必要がある場合（Windows限定）」を参照してください。

UNIXの場合

監視対象に指定したネットワークファイルに対して，クライアント側から参照権限でアクセスできるように設定してください。

なお，WindowsでNFSサーバ上のファイルを監視する場合，またはUNIXでネットワークを介したファイルを監視する場合は，ファイル更新が終わった時点で処理の完了を示す別ファイルを作成し，その別ファイルを監視対象とする運用を推奨します。更新するファイルを，直接ファイル監視ジョブで監視しないでください。WindowsでNFSサーバ上のファイルを監視する場合，またはUNIXでネットワークを介したファイルを監視する場合の注意事項については，「7.6.2 ファイル監視ジョブの注意事項」を参照してください。

ページの先頭へ

(3)　ログファイルの更新を契機に処理を実行する（ログファイル監視ジョブ）

ログファイル監視ジョブは，JP1/Baseのログファイルトラップ機能を使って実行されます。JP1/Baseのログファイルトラップ機能とは，アプリケーションプログラムが出力するログファイルのレコードをJP1イベントに変換して，イベントDBに登録するものです。ログファイル監視ジョブを定義することで，ログファイルの更新を契機にジョブやジョブネットを実行させることができます。JP1/Baseのログファイルトラップ機能については，マニュアル「JP1/Base 運用ガイド」を参照してください。また，ログファイル監視ジョブの注意事項については，「7.6.4 ログファイル監視ジョブの注意事項」を参照してください。

ログファイル監視ジョブの動作の概要を次の図に示します。

図2‒79　ログファイル監視ジョブの動作の概要

ログファイル監視ジョブは，監視対象に指定されたホストにあるログファイルに特定のデータが出力されたかを監視します。ログファイル監視ジョブには，監視するログファイル名と監視する文字列を指定します。文字列の指定には正規表現を使うこともできます。正規表現については，マニュアル「JP1/Base 運用ガイド」（Windowsの場合）またはUNIXのドキュメント（UNIXの場合）を参照してください。

監視間隔を1〜86,400（単位：秒）で指定できます。監視対象として指定できるログファイルは，テキスト形式のものになります。また，複数のログファイル（最大8件）を監視することもできます。

ログファイル監視ジョブを使った条件の例を次に示します。

「ログファイル（ファイル名：ファイル1）に特定の文字列が含まれたログデータが書き込まれたら，後続ジョブを実行する。」というジョブネットを，ログファイル監視ジョブを使って定義する例を次の図に示します。

図2‒80　ログファイル監視ジョブを使ったジョブネットの定義例

ログファイル監視ジョブにログファイル名と監視する文字列を設定します。［ログファイル名］にはファイル1のパスを，［トラップするデータ］にはこの図のように特定の文字列を指定します。

これによって，ファイル1の文字列に，「"abc"と"def"」，「"ghi"」，「"jkl"」の三つのうちどれか一つでも書き込まれたら，ログファイルからログデータを取り出した時点でログファイル監視ジョブは終了となり，条件成立となって後続ジョブが実行されます。

また，複数のログファイルを監視し，そのうちのどれか一つに特定の文字列が含まれたログデータが書き込まれたら，後続ジョブを実行させることもできます。

ページの先頭へ

(4)　Windowsイベントログの受信を契機に処理を実行する（Windowsイベントログ監視ジョブ）

Windowsイベントログ監視ジョブは，JP1/Baseのイベントログトラップ機能を使って実行されます。JP1/Baseのイベントログトラップ機能とは，WindowsイベントログのレコードをJP1イベントに変換してイベントDBに登録するものです。Windowsイベントログ監視ジョブを定義することで，Windowsイベントログの受信を契機にジョブやジョブネットを実行できます。

JP1/Baseのイベントログトラップ機能，およびイベントログトラップ機能の動作定義については，マニュアル「JP1/Base 運用ガイド」を参照してください。また，Windowsイベントログ監視ジョブの注意事項については，「7.6.5 Windowsイベントログ監視ジョブの注意事項」を参照してください。

Windowsイベントログ監視ジョブの動作の概要を次の図に示します。

図2‒81　Windowsイベントログ監視ジョブの動作の概要

Windowsイベントログ監視ジョブで監視できる内容について，次に示します。

ログ種別

指定できるログの種別を次に示します。

• アプリケーション

• セキュリティ

• システム

• DNS Server

• Directory Service

• ファイル複製サービス

• 任意のログ種別^※

注※

任意のログ種別として指定できるログ種別の確認方法は，マニュアル「JP1/Base 運用ガイド」を参照してください。

イベントの種別

指定できるイベントの種別を次に示します。

• 詳細

• 情報

• 警告

• エラー

• 重大

• 成功の監査

• 失敗の監査

Windowsイベントログ監視ジョブを使ったジョブネットの定義例を次に示します。

「セキュリティシステムでの認証が成功したことを通知するWindowsイベントがWindowsのイベントログに出力されたら，後続ジョブを実行する」というジョブネットを，Windowsイベントログ監視ジョブを使って定義する例を次の図に示します。

図2‒82　Windowsイベントログ監視ジョブを使ったジョブネットの定義例

まず，Windowsイベントログ監視ジョブの実行前に，JP1/Baseの動作定義ファイルにイベントログトラップ機能の動作を設定します。この例の場合，ログ種別は「Security」，属性名（typeの場合）は「Audit_success」です。

Windowsイベントログ監視ジョブには，監視するログ種別とイベントの種類を指定します。［ログ種別］には［セキュリティ］，［イベントの種別］には［成功の監査］を設定します。

これによって，指定したWindowsイベントが出力されてWindowsのイベントログのデータを取り出した時点でWindowsイベントログ監視ジョブは終了となり，条件成立となって後続ジョブが実行されます。

ページの先頭へ

(5)　時間の経過を監視して処理を実行する（実行間隔制御ジョブ）

何分間待ってからジョブを実行する，などのようなジョブネットの定義には，実行間隔制御ジョブを使用します。

「先行ジョブが異常終了したら，10分後にリカバリージョブを実行する」というジョブネットを，実行間隔制御ジョブを使って定義する例を次の図に示します。

図2‒83　実行間隔制御ジョブを使ったジョブネットの定義例

まず，先行ジョブが異常終了してから10分後に次の処理を実行させるため，時間の経過を監視する実行間隔制御ジョブを使用します。実行間隔制御ジョブには，［待ち時間］を「10分」と定義します。また，先行ジョブが異常終了したときに実行させるため，［種別］を［リカバリ］にします。実行間隔制御ジョブの後続ジョブである標準ジョブCも同様に［種別］を［リカバリ］にします。

これによって，標準ジョブAが異常終了した場合，リカバリージョブである実行間隔制御ジョブが10分間の時間経過を監視し，10分経過するとその後続ジョブである標準ジョブCが実行されます。標準ジョブAが正常終了した場合は，標準ジョブBが実行されます。

なお，実行間隔制御ジョブで指定する［待ち時間］は，ジョブが実行される所要時間ではなく，実行間隔制御プロセスでの待ち時間を意味します。通信の状態などによって，指定した待ち時間と誤差が生じる場合があります。

ページの先頭へ

(6)　イベントジョブの受信情報の引き継ぎ

イベントジョブで受信したイベント情報を変数（マクロ変数）として定義しておき，後続ユニットに引き継ぐことができます。後続ユニットに引き継ぐ情報を引き継ぎ情報といいます。

後続ユニットでイベント情報を引き継ぐには，イベントジョブ側に情報を引き継ぐためのマクロ変数を定義しておき，後続ユニット側でマクロ変数名を指定します。

イベントジョブ側に定義しておくマクロ変数は，次のように設定します。

マクロ変数の定義

「マクロ変数名:引き継ぎ情報名」

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。また，「引き継ぎ情報名」に設定できる情報は，イベントジョブで引き継ぐ情報として用意されています。詳細については，「付録B イベントジョブで引き継ぐ情報」を参照してください。

マクロ変数はイベントジョブの後続ユニットの実行先のエージェントホスト上で，コマンドラインに引き継いだ情報を展開した形で実行されます。受信情報を引き継ぐ場合には，その内容を意識して，実行時にコマンドの引数として扱える形の情報を引き継ぐ場合だけ定義してください。

マクロ変数の詳細については，「2.2.6 マクロ変数の使用を検討する」を参照してください。

ここでは，イベントジョブで受信した情報を後続ユニットにどのように引き継ぐかを，後続ユニットとして定義したジョブの種類ごとに説明します。

なお，イベントジョブの受信情報をジョブネット全体で参照する場合には，起動条件を使用してください。起動条件については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　3.4 起動条件の定義」を参照してください。

ページの先頭へ