Sentencia LOG

La sentencia LOG graba un registro en las anotaciones de rastreo de sucesos o de usuario.

SINTAXIS

CATALOG
CATALOG es una cláusula opcional; si la omite, toma por omisión el valor del catálogo de la versión actual de WebSphere Message Broker. Para utilizar explícitamente el catálogo de mensajes de la versión de WebSphere Message Broker actual, utilice BIPV600 en todos los sistemas operativos.
EVENT
Se graba un registro en el registro de sucesos (y también en el rastreo de usuarios, si está habilitado).
EXCEPTION
Se anota la excepción actual (si la hay).
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 ha especificado FULL, se ignoran las excepciones de derivación y sólo se anota la excepción original. De esta manera, puede tener un informe completo o sólo el informe de error sin la información adicional sobre lo que estaba sucediendo en ese momento. Tenga en cuenta que una excepción actual sólo existe dentro de 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, toma el valor por omisión del primer número de mensaje (2951) en un bloque de mensajes proporcionado para que lo utilicen las sentencias LOG y THROW en el catálogo de WebSphere Business Integration Message Broker. Si especifica un número de mensaje, puede utilizar los números de mensaje de 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 por omisión 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 suministrados (2951 - 2999) sólo se ocupan de diez inserciones.

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 número de mensaje. Se proporcionan cuatro inserciones
  LOG EVENT SEVERITY 1 CATALOG 'BIPv600' 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.XML.Data.Result = r;
  END;
Conceptos relacionados
Visión general de ESQL
Tareas relacionadas
Desarrollo de ESQL
Referencia relacionada
Diagramas de sintaxis: tipos disponibles
Sentencias ESQL
Sentencia RETURN
Mensaje de ejemplo
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ak05075_