LOG 语句

LOG 语句将记录写入事件或用户跟踪日志。

语法

CATALOG
CATALOG 是可选子句;如果省略它,则缺省为 WebSphere Message Broker 当前版本目录。要明确使用当前 WebSphere Message Broker 版本消息目录,请在所有操作系统上使用 BIPV600
EVENT
写入事件日志(如果启用了用户跟踪,还写入用户跟踪)的记录。
EXCEPTION
记录的当前异常(如果有的话)。
FULL
记录的整个嵌套异常报告(就象异常已到达输入节点一样)。如果未指定 FULL,则忽略所有嵌套的异常,只记录原始异常。这样,您就可以拥有完整的报告或者只拥有实际错误报告,而没有关于当时正进行什么操作的额外信息。请注意,当前异常只存在于处理程序块中(请参阅处理消息流中的错误)。
MESSAGE
要使用的消息数量。如果指定 MESSAGE 子句,它可以包含返回非 NULL 整数值的任何表达式。

如果省略 MESSAGE,它的值缺省为 WebSphere Business Integration Message Broker 目录中的 LOG 和 THROW 语句使用的消息块中的第一个消息号(2951)。如果输入消息号,您可以使用消息号 2951 到 2999。或者,您也可以生成自己的目录。

SEVERITY
消息的严重性。如果指定 SEVERITY 子句,它可以包含返回非 NULL 整数值的任何表达式。如果省略该子句,它的值缺省为 1。
USER TRACE
不管是否启用了用户跟踪,都将记录写入用户跟踪中。
VALUES
使用可选的 VALUES 子句可以为插入消息的数据提供值。您可以插入任意数量的消息片段,但提供的消息(2951 - 2999)仅要求插入 10 条消息。

请注意 LOG 语句与 THROW 语句的一般相似性。

  -- Write a message to the event log specifying the severity, catalogue 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.XML.Data.Result = r;
    END;
相关概念
ESQL 概述
相关任务
正在开发 ESQL
相关参考
语法图:可用类型
ESQL 语句
RETURN 语句
示例消息
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ak05075_