ccilsTraceActive

Indica se la traccia è attiva e il relativo livello di attivazione.

Sintassi

CCI_TRACE_TYPE cciIsTraceActive(
  int*      returnCode,
  CciObject*     object);

Parametri

returnCode
Riceve il codice di ritorno dalla funzione (output). Un input del puntatore NULL indica che il nodo definito dall'utente non intende gestire gli errori. Eventuali eccezioni generate durante l'esecuzione di questa chiamata, verranno generate nuovamente nel nodo successivo a monte del flusso. Se l'input è diverso da NULL, l'output indicherà lo stato positivo della chiamata. Se durante l'esecuzione si verifica un'eccezione, *returnCode verrà impostato su CCI_EXCEPTION nell'output. Una chiamata a CciGetLastExceptionData fornirà informazioni dettagliate sull'eccezione.
object
L'indirizzo dell'oggetto che deve essere associato alla voce di traccia (input). Tale oggetto può essere CciNode* o CciParser*. Se è CciNode*, il nome di tale nodo viene scritto nella traccia. Se è CciParser*, nella traccia viene scritto il nome del nodo che ha creato il programma di analisi. Questo oggetto viene utilizzato inoltre per determinare se la voce deve essere scritta nella traccia. La voce viene scritta solo se la traccia è attiva per il nodo. Attualmente i nodi ereditano le relative impostazioni di traccia dal flusso di messaggi.
Se questo parametro è NULL, viene restituito il livello di traccia per il gruppo di esecuzione.

Valori di restituzione

Un valore CCI_TRACE_TYPE che indica il livello di traccia attualmente attivo. Il tipo CCI_TRACE_TYPE può assumere i seguenti valori:
  • CCI_USER_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE
  • CCI_ SERVICE_NORMAL_TRACE
  • CCI_SERVICE_DEBUG_TRACE
  • CCI_TRACE_NONE
Tali valori di restituzione sono valori a livello di bit. Sono possibili combinazioni di tali valori, ad esempio:
  • CCI_USER_NORMAL_TRACE + CCI_ SERVICE_NORMAL_TRACE
  • CCI_USER_NORMAL_TRACE + CCI_SERVICE_DEBUG_TRACE
  • CCI_USER_DEBUG_TRACE + CCI_ SERVICE_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE + CCI_SERVICE_DEBUG_TRACE
CCI_TRACE_NONE è un valore zero e tutti gli altri valori sono diversi da zero.
E' possibile utilizzare altri due valori come bitmask quando si eseguono query del livello di traccia attivo. Questi sono:
  • CCI_USER_TRACE
  • CCI_SERVICE_TRACE
Ad esempio, l'espressione (traceLevel & CCI_USER_TRACE) calcolerà un valore diverso da zero per traceLevel relativamente ai seguenti valori di restituzione:
  • CCI_USER_NORMAL_TRACE + CCI_ SERVICE_NORMAL_TRACE
  • CCI_USER_NORMAL_TRACE + CCI_SERVICE_DEBUG_TRACE
  • CCI_USER_DEBUG_TRACE + CCI_ SERVICE_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE + CCI_SERVICE_DEBUG_TRACE
  • CCI_USER_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE
L'espressione (traceLevel & CCI_USER_TRACE) calcolerà un valore zero per traceLevel relativamente ai seguenti valori di restituzione:
  • CCI_SERVICE_NORMAL_TRACE
  • CCI_SERVICE_DEBUG_TRACE
  • CCI_TRACE_NONE

Esempio

CciNode*         thisNode = ((NODE_CONTEXT_ST*)context)->nodeObject;

const CCI_TRACE_TYPE   traceActive = cciIsTraceActive(&rc, (CciObject*)thisNode);
checkRC(rc);
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as24540_