Istruzione LOG

L'istruzione LOG scrive un record nella registrazione di traccia utente o nella registrazione eventi.

SINTASSI

CATALOG
CATALOG è una clausola facoltativa; se viene omessa, viene utilizzato come valore predefinito il catalogo della versione corrente di WebSphere Message Broker. Per utilizzare in modo esplicito il catalogo messaggi della versione corrente di WebSphere Message Broker, utilizzare BIPV600 su tutti i sistemi operativi.
EVENT
Viene scritto un record nella registrazione eventi (e anche nella traccia utente se questa funzione è abilitata).
EXCEPTION
L'eccezione corrente (se esiste) viene registrata.
COMPLETA
Viene registrato il prospetto dell'eccezione nidificata completo (come se l'eccezione avesse raggiunto il nodo di input). Se non viene specificato FULL, tutte le eccezioni wrap vengono ignorate e viene registrata solo l'eccezione originale. Per questo motivo, è possibile avere un prospetto completo o solo il prospetto relativo all'errore reale senza le informazioni supplementari relative all'operazione in corso al momento dell'errore. Notare che un'eccezione corrente esiste solo all'interno dei blocchi del programma di gestione (consultare Gestione degli errori nei flussi di messaggi).
MESSAGE
Il numero del messaggio da utilizzare. Se specificata, la clausola MESSAGE può contenere qualsiasi espressione che restituisce un valore integer non NULL.

Se MESSAGE non viene specificata, viene utilizzato come valore predefinito il primo numero di messaggio (2951) un un blocco di messaggi fornito dalle istruzioni LOG e THROW nel catalogo WebSphere Business Integration Message Broker. Se si immette un numero di messaggio, è possibile utilizzare i numeri compresi tra 2951 e 2999. In alternativa, è possibile generare il proprio catalogo.

SEVERITY
La severità associata al messaggio. Se specificata, la clausola SEVERITY può contenere qualsiasi espressione che restituisce un valore integer non NULL. Se la clausola non viene immessa, il valore predefinito utilizzato è 1.
USER TRACE
Viene scritto un record nella traccia utente, indipendentemente dal fatto che la traccia utente sia abilitata oppure no.
VALUES
Utilizzare la clausola facoltativa VALUES per fornire i valori per gli inserimenti di dati nel proprio messaggio. E' possibile inserire qualsiasi numero di blocchi di informazioni, ma i messaggi forniti (2951 - 2999) forniscono solo dieci inserimenti.

Notare la similitudine generale dell'istruzione LOG e con l'istruzione 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;
Concetti correlati
Panoramica di ESQL
Attività correlate
Sviluppo di ESQL
Riferimenti correlati
Diagrammi di sintassi: tipi disponibili
Istruzioni ESQL
Istruzione RETURN
Messaggio di esempio
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
ak05075_