Usar la sentencia LOG para grabar un registro en
las anotaciones de sucesos o en el rastreo de usuario.
Sintaxis

>>-LOG--+-EVENT-------+--+---------------------+--+----------+--+-----------------------------+-><
'-USER--TRACE-' '-+------+--EXCEPTION-' '-Opciones-' | .-,---------. |
'-FULL-' | V | |
'-VALUES--(----Expresión-+--)-'
WHERE
|--Opciones =--+---------------------+--+--------------------+--+--------------------+--|
'-SEVERITY--Expresión-' '-CATALOG--Expresión-' '-MESSAGE--Expresión-'
- CATALOG
- CATALOG es una cláusula opcional; si la omite, CATALOG toma por omisión el valor
del catálogo de la versión actual de WebSphere Message Broker. Para utilizar el catálogo de mensajes de la versión actual explícitamente, utilice
BIPmsgs en todos los sistemas operativos.
- EVENT
- Se graba un registro en el registro de sucesos y también en el rastreo de usuario, si
el rastreo de usuario se ha habilitado.
- EXCEPTION
- La excepción actual, si existe, se anota.
Para obtener más información
sobre las excepciones, consulte Manejo de errores y excepciones.
- FULL
- Se anota el informe de excepción anidado completo, igual que si la excepción
hubiera alcanzado el nodo de entrada. Si no se especifica FULL, se ignoran las
excepciones de derivación y sólo se anota la excepción
original. Por consiguiente, puede tener un informe completo o simplemente el informe de
error real sin la información adicional relacionada con lo que estaba sucediendo
en ese momento. Sólo existe una excepción actual en los bloques de manejadores
(consulte Manejar errores en flujos de mensajes).
- MESSAGE
- El número del mensaje a utilizar. Si se especifica, la cláusula
MESSAGE puede contener cualquier
expresión que devuelve un valor entero que no es NULL.
Si
omite MESSAGE, el valor toma de forma predeterminada el primer número de mensaje
(2951) de un bloque de mensajes que se proporciona para que lo utilicen las sentencias
LOG y THROW en el catálogo de
WebSphere Message Broker.
Si especifica un número de mensaje, puede utilizar los números de mensaje
2951 a 2999. Alternativamente, puede generar su propio catálogo.
- SEVERITY
- La gravedad asociada al mensaje. Si se especifica, la cláusula
SEVERITY puede contener cualquier expresión que devuelve un valor entero
que no es NULL. Si omite la cláusula, toma el valor predeterminado 1.
- USER TRACE
- Se graba un registro en el rastreo de usuario, tanto si el rastreo de
usuario está habilitado como si no.
- VALUES
- Utilice la cláusula VALUES opcional para proporcionar valores para la
inserción de datos en su mensaje. Puede insertar cualquier número de fragmentos de información,
pero los mensajes proporcionados (2951 - 2999) permiten un máximo de diez
inserciones de datos.
Observe la similitud general de la sentencia
LOG con la sentencia THROW.
-- Grabar un mensaje en el registro de sucesos especificando la gravedad, el catálogo y el número
-- de mensaje. Se proporcionan cuatro inserciones
LOG EVENT SEVERITY 1 CATALOG 'BIPmsgs' MESSAGE 2951 VALUES(1,2,3,4);
-- Grabar en el registro de rastreo cuando se produzca una división por cero
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;