Instrução LOG

A instrução LOG grava um registro nos registros de eventos ou de rastreio do usuário.

SINTAXE

CATALOG
CATALOG é uma cláusula opcional; se você omiti-la, será assumido como padrão o catálogo da versão atual do WebSphere Message Broker. Para utilizar o catálogo de mensagens da versão atual do WebSphere Message Broker explicitamente, utilize BIPV600 em todos os sistemas operacionais.
EVENT
Um registro é gravado no registro de eventos (e também no rastreio do usuário, se estiver ativado).
EXCEPTION
A exceção atual (se houver) é registrada.
FULL
O relatório completo de exceção aninhada é registrado (exatamente como se a exceção tivesse atingido o nó input). Se FULL não for especificado, quaisquer exceções de agrupamento serão ignoradas e apenas a exceção original será registrada. Portanto, é possível ter um relatório completo ou simplesmente o relatório real do erro, sem as informações extras relativas ao que aconteceu no momento. Observe que uma exceção atual existe apenas nos blocos de rotina de tratamento (consulte Tratando Erros em Fluxos de Mensagens).
MESSAGE
O número da mensagem a ser utilizada. Se especificada, a cláusula MESSAGE pode conter qualquer expressão que retorne um valor inteiro não-NULL.

Se você omitir MESSAGE, seu valor assumirá como padrão o primeiro número de mensagem (2951) em um bloco de mensagens fornecido para ser utilizado pelas instruções LOG e THROW no catálogo do WebSphere Business Integration Message Broker. Se você digitar um número de mensagem, poderá utilizar os números de mensagem de 2951 a 2999. Como alternativa, você pode gerar seu próprio catálogo.

SEVERITY
A gravidade associada à mensagem. Se especificada, a cláusula SEVERITY pode conter qualquer expressão que retorne um valor inteiro não-NULL. Se você omitir a cláusula, seu valor assumirá o padrão 1.
USER TRACE
Um registro é gravado no rastreio do usuário, quer ele esteja ou não ativado.
VALUES
Utilize a cláusula VALUES opcional para fornecer valores para as inserções de dados em sua mensagem. Você pode inserir qualquer número de partes de informações, mas as mensagens fornecidas (2951 - 2999) suprem apenas dez inserções.

Observe a similaridade geral da instrução LOG com a instrução THROW.

  -- Gravar uma mensagem no registro de eventos especificando o número de gravidade, catálogo e
  -- mensagem. Quatro inserções são fornecidas
  LOG EVENT SEVERITY 1 CATALOG 'BIPv600' MESSAGE 2951 VALUES(1,2,3,4);

  -- Gravar no registro de rastreio sempre que ocorrer uma divisão por zero
    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;
Conceitos relacionados
Visão Geral do ESQL
Tarefas relacionadas
Desenvolvendo ESQL
Referências relacionadas
Diagramas de Sintaxe: Tipos Disponíveis
instruções ESQL
Instrução RETURN
Mensagem de Exemplo
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ak05075_