ccilsTraceActive

Meldet, ob der Trace aktiv ist und auf welcher Stufe er aktiv ist.

Syntax

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

Parameter

returnCode
Empfängt den Rückkehrcode von der Funktion (Ausgabe). Ein Nullzeiger zeigt an, dass der benutzerdefinierte Knoten nicht für Fehler zuständig sein möchte. Alle Ausnahmebedingungen, die bei der Ausführung dieses Aufrufs ausgegeben werden, werden beim nächsten vorgeschalteten Knoten im Nachrichtenfluss erneut ausgegeben. Wenn die Eingabe nicht NULL ist, gibt die Ausgabe den Erfolgsstatus des Aufrufs an. Wenn bei der Ausführung eine Ausnahmebedingung auftritt, wird als Wert für '*returnCode' bei der Ausgabe CCI_EXCEPTION festgelegt. Rufen Sie 'CciGetLastExceptionData' auf, um weitere Informationen zu der Ausnahmebedingung zu erhalten.
object
Die Adresse des Objekts, das dem Traceeintrag (Eingabe) zugeordnet werden soll. Bei dem Objekt kann es sich um die Adresse eines CciNode*- oder CciParser*-Objekts handeln. Wenn es sich um ein CciNode*-Objekt handelt, dann wird dessen Name in den Trace geschrieben. Wenn es sich um ein CciParser*-Objekt handelt, dann wird der Name desjenigen Knotens in den Trace geschrieben, der den Parser erstellt hat. Mit diesem Objekt wird auch bestimmt, ob der Eintrag in den Trace geschrieben werden soll. Der Eintrag wird nur hineingeschrieben, wenn der Trace für den Knoten aktiv ist. Derzeit übernehmen Knoten ihre Trace-Einstellungen vom Nachrichtenfluss.
Wenn dieser Parameter NULL lautet, wird die Tracestufe für die Ausführungsgruppe zurückgegeben.

Rückgabewerte

Der Wert für CCI_TRACE_TYPE gibt die Stufe des Trace an, der derzeit aktiv ist. CCI_TRACE_TYPE kann folgende Werte aufweisen:
  • CCI_USER_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE
  • CCI_ SERVICE_NORMAL_TRACE
  • CCI_SERVICE_DEBUG_TRACE
  • CCI_TRACE_NONE
Diese Rückgabewerte sind bitweise Werte. Kombinationen folgender Werte sind beispielsweise auch möglich:
  • 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 ist ein Nullwert, die anderen Werte aber nicht.
Beim Abfragen der aktiven Tracestufe können zwei weitere Werte als Bitmasken verwendet werden. Dabei handelt es sich um folgende Werte:
  • CCI_USER_TRACE
  • CCI_SERVICE_TRACE
Beispiel: Für folgende Rückgabewerte ergibt der Ausdruck (traceLevel & CCI_USER_TRACE) einen Wert ungleich null für traceLevel:
  • 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
Für folgende Rückgabewerte ergibt der Ausdruck (traceLevel & CCI_USER_TRACE) einen Nullwert für traceLevel:
  • CCI_SERVICE_NORMAL_TRACE
  • CCI_SERVICE_DEBUG_TRACE
  • CCI_TRACE_NONE

Beispiel

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

const CCI_TRACE_TYPE   traceActive = cciIsTraceActive(&rc, (CciObject*)thisNode);
checkRC(rc);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as24540_