Utilize a instrução LOG para gravar
um registro no log de eventos ou para o rastreio do usuário.
- CATALOG
- CATALOG é uma cláusula opcional; se você omiti-la, CATALOG será assumido como padrão para o catálogo da versão atual do WebSphere Message
Broker. Para utilizar o catálogo de mensagens da versão atual explicitamente, utilize BIPmsgs em todos os sistemas operacionais.
- EVENT
- É gravado um registro no log de eventos e também no rastreio do usuário, se o rastreio do usuário
estiver ativado.
- EXCEPTION
- A exceção atual, se houver, será registrada.
Para obter informações adicionais
sobre exceções, consulte Tratamento de Erros e Exceções.
- FULL
- O relatório completo de exceção aninhada é registrado, exatamente como se a exceção
tivesse atingido o nó de entrada. Se FULL não for especificado, quaisquer exceções de
agrupamento serão ignoradas e apenas a exceção original será registrada. Portanto, você pode
ter um relatório nulo ou apenas o relatório de erros real sem as informações extras
relacionadas ao que aconteceu no momento. Existe uma exceção atual dentro dos blocos
do manipulador (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 Message
Broker.
Se você especificar
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 um máximo de dez inserções de dados.
Observe a similaridade geral da instrução LOG com a
instrução THROW.
-- Grave uma mensagem no log de eventos especificando a gravidade, o catálogo e o número da
-- mensagem. Quatro inserções são fornecidas
LOG EVENT SEVERITY 1 CATALOG 'BIPmsgs' 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.XMLNS.Data.Result = r;
END;