ジョブ・ステータス変更情報の受渡し

ジョブ・ステータス変更属性（新規ステータス、ジョブ名、ジョブ・タイプ、通知ルール、ルール所有者など）をPL/SQLプロシージャまたはOSコマンドやスクリプトに渡すことで、ステータス変更に対して自動化されたレスポンスをカスタマイズできます。たとえば、クリティカルなジョブの実行が失敗したときに、社内のサポート用トラブル・チケット・システムに関するトラブル・チケットを開くためにOSスクリプトをコールする場合があります。この場合、スクリプトに「問題」または「中断」などのステータスを渡してトラブル・チケットを開き、問題を重大化させる必要があります。

PL/SQLプロシージャへの情報の受渡し

通知システムは、MGMT_NOTIFY_JOBオブジェクトを介してジョブ・ステータス変更情報をPL/SQLプロシージャに渡します。このオブジェクトのインスタンスは、ステータス変更ごとに作成されます。ジョブがステータスを変更すると、通知システムは通知ルールに関連付けられているPL/SQLプロシージャをコールして、移入されたオブジェクトを渡します。これにより、プロシージャは渡されたMGMT_NOTIFY_JOBオブジェクトのフィールドにアクセスできます。

次の表に、受渡しできるすべてのジョブ・ステータスの変更属性を示します。

ジョブに対するジョブ・ステータス変更が発生すると、通知システムはMGMT_NOTIFY_JOBオブジェクトのインスタンスを作成し、ステータス変更の値を移入します。次のステータス・コードがMGMT_JOBSパッケージに制約として定義されています。これらのコードを使用すると、MGMT_NOTIFY_JOBオブジェクトのjob_statusフィールドのステータスのタイプを判別できます。

ジョブ・ステータス・コード

例: ステータス・コードを使用するPL/SQLプロシージャ

CREATE TABLE job_log (jobid RAW(16),
occured DATE);

PL/SQLプロシージャ

CREATE OR REPLACE PROCEDURE LOG_PROBLEM_JOBS(status_change IN MGMT_NOTIFY_JOB)
IS
BEGIN
-- すべての失敗したジョブをログ出力
IF status_change.job_status = MGMT_JOBS.FAILED_STATUS
THEN
BEGIN
INSERT INTO job_log (jobid, occured)
VALUES (status_change.job_guid, SYSDATE);
EXCEPTION
WHEN OTHERS
THEN
-- 問題が発生時に再試行の通知を取得する場合
RAISE_APPLICATION_ERROR(-20000, 'Please retry');
END;
COMMIT;
END IF;
END LOG_PROBLEM_JOBS;

PL/SQLプロシージャの使用方法

1. 次のプロシージャ指定を使用して、リポジトリ・データベースにPL/SQLプロシージャを作成します。

   PROCEDURE p(status_change IN MGMT_NOTIFY_JOB)

   プロシージャの実行時にエラーが発生した場合、エラー・コード-20000を使用するユーザー定義例外を返すことによって、通知システムでプロシージャへの通知の送信を再試行できます。前述の例を参照してください。この再試行処理は最初1分後に行われ、2分後、3分後などのように続き、通知がパージされるポイントである1日後までそれが続きます。

2. このPL/SQLプロシージャを、通知ルールでコールできる通知メソッドとして追加します。「PL/SQLプロシージャの追加」を参照してください。

   スキーマ所有者、パッケージ名およびプロシージャ名を含む完全修飾名を必ず使用してください。プロシージャはリポジトリ所有者によって実行されるため、リポジトリ所有者にプロシージャの実行権限があります。

3. PL/SQLプロシージャを通知ルールに関連付けます。

OSスクリプトまたは実行可能ファイルへの情報の受渡し

通知システムは、システム環境変数を介してOSスクリプトまたは実行可能ファイルに重大度情報を渡します。環境変数へのアクセスに使用される表記規則は、オペレーティング・システムに応じて異なります。

• UNIX: $ENV_VARIABLE

• MS Windows: %ENV_VARIABLE%

通知システムは、スクリプトをコールする前に次の環境変数を設定します。

スクリプトでは、これらの変数の一部またはすべてを参照できます。

OSスクリプトまたは実行可能ファイルの使用方法

• リポジトリ・ホスト・マシンでOSコマンドを作成します。

  管理リポジトリに接続する各管理サービス・マシンでOSコマンドを作成します。OSコマンドは絶対パス名であり、各管理サービス・ホスト・マシン上のパスとまったく同じパスにします（例: /u1/bin/logSeverity.sh）。コマンドは管理サービスを起動したユーザーとして実行されます。OSコマンドの実行時にエラーが発生した場合、終了コード100を返すことによって、通知システムでOSコマンドへの通知の送信を再試行できます。この再試行処理は最初1分後に行われ、2分後、3分後などのように続き、通知がパージされるポイントである1日後までそれが続きます。

  次のemoms.propertiesのパラメータは、管理サービスにより中断されることなくOSコマンドが実行される期間を制御します。これによって、OSコマンドが過度に長い時間実行されるため他の通知の転送を妨げることが回避できます。デフォルトでは、コマンドは中断されるまで30秒間実行できます。次を参照してください（これらすべてのパラメータを説明するその他のdocにポインタを追加）。

  # The amount of time in seconds after which an OS Command started by the

  # Notification System will be killed if it has not exited

  # em.notification.os_cmd_timeout=30

• このOSコマンドを、通知ルールでコールできる通知メソッドとして追加します。「OSコマンドの追加」を参照してください。

• 通知ルールを定義（通知対象となるターゲットと通知を受け取る条件を選択）し、そのルールにOSコマンドを関連付けます。「通知ルールの定義」を参照してください。

関連トピック

Enterprise Managerの情報ロードマップ

Copyright (C) 1996, 2007, Oracle. All rights reserved.