WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

cciUserDebugTraceW

Mit cciUserDebugTraceW können Sie eine Nachricht aus einem Nachrichtenkatalog (mit Einfügungen) in einen Benutzertrace schreiben, wenn dieser in der Debugstufe aktiv ist. Es wird auch eine Nachricht in einen Service-Trace geschrieben, falls dieser aktiv ist.

Ist der Benutzertrace nicht auf der Debugstufe aktiv, wird ein Eintrag in den Service-Trace geschrieben, wenn dieser auf einer beliebigen Stufe aktiv ist.

Syntax

void cciUserDebugTraceW(
  int*                        returnCode,
  CciObject*     		object,
  const CciChar* 		messageSource,
  int                 messageNumber,
  const CciChar* 		traceText,
  ...
);

Parameter

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 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, wird dessen Name in den Trace geschrieben. Wenn es sich um ein CciParser*-Objekt handelt, 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. Derzeit übernehmen Knoten ihre Trace-Einstellungen vom Nachrichtenfluss.
Wenn dieser Parameter NULL lautet, wird die Tracestufe für die Ausführungsgruppe zurückgegeben.
messageSource
Eine Zeichenfolge, die die Windows-Nachrichtenquelle oder den Linux- und UNIX-Nachrichtenkatalog (Eingabe) angibt. Beim Formatieren des Trace wird eine Nachricht aus der landessprachlichen Version dieses Katalogs geschrieben. Es gilt die länderspezifische Einstellung der Umgebung, in der der Trace formatiert wird. Es ist möglich, den Broker auf einem bestimmten Betriebssystem ausführen, das Protokoll auf diesem Betriebssystem zu lesen und es dann auf einem anderen Betriebssystem zu formatieren. Wenn der Broker beispielsweise unter Linux oder UNIX ausgeführt wird, dort aber keine CAT-Datei vorhanden ist, kann der Benutzer das Protokoll lesen und es dann auf ein Windows-System übertragen, wo es mithilfe der PROPERTIES-Datei formatiert werden kann.
Wenn dieser Parameter NULL lautet, tritt genau dasselbe ein wie beim Angeben einer leeren Zeichenfolge. D. h., alle anderen Informationen werden in das Protokoll geschrieben, und das Feld für den Katalog enthält als Wert eine leere Zeichenfolge. Deshalb kann das Formatierungsprogramm für Protokolle die Nachrichtenquelle nicht finden. Folglich schlägt die Formatierung dieses Eintrags fehl.
messageNumber
Die Nummer, die die Nachricht innerhalb des Parameters 'messageSource' kennzeichnet (Eingabe). Wenn der Parameter 'messageSource' keine Nachricht enthält, die dem Parameter 'messageNumber' entspricht, kann das Formatierungsprogramm für Protokolle diesen Eintrag nicht formatieren.
traceText
Eine Zeichenfolge die mit NULL endet (input). Diese Zeichenfolge wird in den Service-Trace geschrieben, und so können Traceeinträ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 mithilfe von 'traceText' unterschieden werden. D. h., die Zeichenfolge 'traceText' ist eine statische Literalzeichenfolge im Quellcode. Deshalb wird sich dieselbe Zeichenfolge sowohl in der Quellcodedatei als auch in der formatierten Tracedatei befinden.
...
Eine C-Variablenargumentenliste, die Nachrichteneinfügungen enthält, die der Nachricht beigefügt sind (Eingabe). Diese Einfügungen werden als Zeichenfolgen behandelt, und es wird vorausgesetzt, dass die Variablenargumente vom Typ pointer to CciChar sind.
Das letzte Argument in dieser Liste muss (CciChar*)0 sein.

Rückgabewerte

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

Beispiel

const CciChar*   myMessageSource=CciString("SwitchMSG",BIP_DEF_COMP_CCSID);
CciNode* thisNode = ((NODE_CONTEXT_ST*)context)->nodeObject;
const CciChar*   traceText = CciString("Found an element name and value",
                                       BIP_DEF_COMP_CCSID);

cciUserDebugTraceW(&rc,
                   (CciObject*)thisNode,
                   myMessageSource,
                   2,
                   traceText,
                   elementName,
                   elementValue,
                   (CciChar*)0);
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:22:07


ReferenzthemaReferenzthema | Version 8.0.0.5 | as24590_