cciServiceDebugTraceW

Diese Funktion ist sehr ähnlich wie cciServiceTraceW. Der einzige Unterschied ist, dass der Eintrag nur dann in den Service-Trace geschrieben wird, wenn der Service-Trace auf Debugstufe aktiv ist.

Syntax

void cciServiceDebugTraceW(
  int*                        returnCode,
  CciObject*     object,
  const CciChar* traceText
);

Parameters

returnCode
Empfängt den Rückkehrcode von der Funktion (Ausgabe). Die Eingabe eines Nullzeigers bedeutet, 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 Ausnahme auftritt, wird *returnCode bei der Ausgabe auf CCI_EXCEPTION gesetzt. Rufen Sie CciGetLastExceptionData für Details der Ausnahmebedingung auf.
object (input)
Die Adresse des Objekts, das mit dem Traceeintrag (input) verknüpft 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. Dieses Objekt wird auch dazu verwendet, zu bestimmen, ob der Eintrag in den Trace geschrieben werden soll. Der Eintrag wird nur hineingeschrieben, wenn der Trace für den Knoten aktiv ist. Zur Zeit ist es so, dass Knoten ihre Trace-Einstellung vom Nachrichtenfluss erben.
Wenn dieser Parameter NULL lautet, wird die Tracestufe für die Ausführungsgruppe zurückgegeben.
traceText (input)
Eine Zeichenfolge die mit NULL endet (input). Diese Zeichenfolge wird in den Service-Trace geschrieben, und so können Trace-Einträge leicht mit Pfaden durch den Quellcode in Verbindung gebracht werden. Beispielsweise könnte es mehrere Pfade durch den Code geben, die dieselbe Nachricht (messageSource und messageNumber) im Trace zur Folge haben. Zwischen diesen verschiedenen Pfaden kann mit Hilfe von traceText unterschieden werden. Das heißt, die ZeichenfolgetraceText ist eine statische Literalzeichenfolge im Quellcode, und deshalb erscheint dieselbe Zeichenfolge sowohl in der Quellcodedatei als auch im der formatierten Tracedatei.

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt der Parameter returnCode die Fehlerursache an.

Beispiel

CciNode* thisNode = ((NODE_CONTEXT_ST*)context)->nodeObject;
CciChar* traceText = CciString(">>_Switch_evaluate()",BIP_DEF_COMP_CCSID");
cciServiceTraceW(&rc,(CciObject*)thisNode,traceText);
checkRC(rc);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as24610_