cciLog

Diese Funktion protokolliert einen Fehler, eine Warnung oder ein informatives Ereignis. Das Ereignis wird von der Schnittstelle des Nachrichtenbrokers mit den angegebenen Argumenten als Protokolldaten protokolliert.

Syntax

void cciLog(
int*          returnCode,
CCI_LOG_TYPE  type,
char*         file,
int           line,
char*         function,
CciChar*      messageSource,
int           messageNumber,
char*         traceText,
...);

Parameter

returnCode
Der Rückkehrcode aus der Funktion (Ausgabe). Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_INV_DATA_POINTER
  • CCI_INV_LOG_TYPE
type
Der Ereignistyp, der durch CCI_LOG_TYPE definiert wird (Eingabe). Gültige Werte sind:
  • CCI_LOG_ERROR
  • CCI_LOG_WARNING
  • CCI_LOG_INFORMATION
file
Der Name der Quellendatei, von der aus die Funktion aufgerufen wurde (Eingabe). Der Wert ist optional, er ist jedoch für die Fehlerbehebung hilfreich.
line
Die Zeilennummer der Quellendatei, von der aus die Funktion aufgerufen wurde (Eingabe). Der Wert ist optional, er ist jedoch für die Fehlerbehebung hilfreich.
function
Der Name der Funktion, die die Protokollfunktion aufgerufen hat (Eingabe). Der Wert ist optional, er ist jedoch für die Fehlerbehebung hilfreich.
messageSource
Eine Zeichenfolge, die die Windows-Nachrichtenquelle oder den Linux- und UNIX-Nachrichtenkatalog angibt.
messageNumber
Die Nachrichtennummer, die das Ereignis identifiziert (Eingabe). Wenn für messageNumber null angegeben wird, wird vorausgesetzt, dass keine Nachricht verfügbar ist. Wenn messageNumber ungleich null ist, wird die angegebene Nachricht mit Einfügungen, die in der Variablenargumentenliste (siehe unten) angegeben sind, in das Ereignisprotokoll des Brokers geschrieben.
traceText
Trace-Informationen, die in das Traceprotokoll des Broker-Services geschrieben werden (Eingabe). Die Informationen sind optional, sie sind jedoch für die Fehlerbehebung hilfreich.
...
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 der Typ der Variablenargumente pointer to char ist.
Anmerkung: Zeichen vom Typ char* müssen Zeichenfolgen im ASCII-Format (lateinischer Zeichensatz) oder EBCDIC-Format (1047) sein.
Anmerkung: Das letzte Argument in dieser Liste muss (char*)0 sein.

Rückgabewerte

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

Zugehörige Konzepte
Benutzerdefinierte Erweiterungen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
as08552_