LOG ステートメント

LOG ステートメントは、レコードをイベント・ログまたはユーザー・トレースに書き込むために使用します。

構文

CATALOG
CATALOG はオプションの文節であり、省略すると、CATALOG は WebSphere® Message Broker の現在のバージョン・カタログをデフォルトとします。 現行バージョンのメッセージ・カタログを明示的に使用するには、すべてのオペレーティング・システムで BIPv600 を使用します。

製品のバージョン 5 のメッセージ・カタログを使用するには、すべてのオペレーティング・システムで BIPv500 を使用します。

EVENT
レコードがイベント・ログに書き込まれ、ユーザー・トレースが使用可能な場合はユーザー・トレースにも書き込まれます。
EXCEPTION
現行の例外 (ある場合) がログに記録されます。

例外について詳しくは、エラーおよび例外処理を参照してください。

FULL
完全にネストされた例外レポートが (例外が入力ノードに達したかのように) ログに記録されます。FULL を指定しないと、包含する例外は無視され、元の例外のみログに記録されます。したがって、完全なレポートか、またはその時点で起きたことに関する追加情報のない単なる実際のエラー・レポートのいずれかを記録できます。現行の例外は、ハンドラー・ブロック中のみに存在します (メッセージ・フローのエラー処理を参照)。
MESSAGE
使用されるメッセージの番号。指定する場合、MESSAGE 文節には、ヌル以外の整数値を戻す式を含めることができます。

MESSAGE を省略する場合、その値はデフォルトにより、WebSphere Message Brokerカタログ中の、LOG および THROW ステートメントにより使用するよう指定されたメッセージ・ブロック中の最初のメッセージ番号 (2951) になります。メッセージ番号を指定する場合、メッセージ番号 2951 から 2999 が使用できます。 あるいは、独自のカタログを生成することもできます。

SEVERITY
メッセージに関連付けられる重大度。指定する場合、SEVERITY 文節には、ヌル以外の整数値を戻す式を含めることができます。文節を省略する場合には、値はデフォルトで 1 に解釈されます。
USER TRACE
ユーザー・トレースが使用可能かどうかにかかわらず、レコードはユーザー・トレースに書き込まれます。
VALUES
メッセージへのデータ挿入の値を提供するには、オプションの VALUES 文節を使用します。任意の数の情報を挿入できますが、提供されているメッセージ (2951 から 2999 まで) の場合は最大 10 個のデータ挿入のみ可能です。

一般的に LOG ステートメントは THROW ステートメントに似ていることに注意してください。

  -- Write a message to the event log specifying the severity, catalog and message
  -- number. Four inserts are provided
  LOG EVENT SEVERITY 1 CATALOG 'BIPv600' MESSAGE 2951 VALUES(1,2,3,4);

  -- Write to the trace log whenever a divide by zero occurs
  BEGIN
    DECLARE a INT 42;
    DECLARE b INT 0;
    DECLARE r INT;

    BEGIN
      DECLARE EXIT HANDLER FOR SQLSTATE LIKE 'S22012' BEGIN
        LOG USER TRACE EXCEPTION VALUES(SQLSTATE, 'DivideByZero');

        SET r = 0x7FFFFFFFFFFFFFFFF;
      END;  
      SET r = a / b;
    END;  
    SET OutputRoot.XMLNS.Data.Result = r;
  END;
関連概念
ESQL の概要
関連タスク
ESQL の開発
メッセージ・カタログの作成
関連資料
構文図: 使用可能なタイプ
ESQL のステートメント
RETURN ステートメント
THROW ステートメント
サンプル・メッセージ
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:44:02

ak05075_