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.

cciLogW

cciLogW protokolliert einen Fehler, eine Warnung oder ein informelles Ereignis. Das Ereignis wird von der Brokerschnittstelle protokolliert und verwendet die angegebenen Argumente als Protokolldaten.

Syntax

void cciLogW(
  int*              Rückkehrcode,
  CCI_LOG_TYPE  type,
  const char*       file,
  int                 line,
  const char*       function,
  const CciChar*    messageSource,
  int                 messageNumber,
  const CciChar*    traceText,
                    ...
);

Parameter

returnCode
Der Rückkehrcode von der Funktion (Ausgabe).Wenn der Parameter 'messageSource' null ist, wird 'returnCode' auf CCI_INV_DATA_POINTER gesetzt.
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
Der vollständig qualifizierte Standort und Name der Windows-Nachrichtenquelle oder der Linux-, UNIX- oder z/OS-Nachrichtenkatalog.

Geben Sie auf allen Betriebssystemen BIPmsgs an, um den aktuellen Nachrichtenkatalog für den Broker zu verwenden. Als Alternative können Sie auch Ihren eigenen Nachrichtenkatalog erstellen.

messageNumber
Die Nachrichtennummer, die das Ereignis identifiziert (Eingabe). Wenn für messageNumber null angegeben wird, wird vorausgesetzt, dass keine Nachricht verfügbar ist. Ist für messageNumber ein Wert ungleich null angegeben, wird die betreffende Nachricht mit allen Einfügungen aus der Variablenargumentliste (siehe Beispiel) in das Brokerereignisprotokoll 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 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

void logSomethingWithBroker(CciChar* helpfulText, 
                            char*               file,
                            int                 line,  
                            char* func 
                            ){
  int          rc = CCI_SUCCESS;
  /* set up the message catalog name */
  const CciChar* catalog = CciString("BIPmsgs", BIP_DEF_COMP_CCSID);

  cciLogW(&rc,
          CCI_LOG_INFORMATION 
          file, line, func,
          catalog, BIP2111,
          helpfulText,
          helpfulText,
          (CciChar*)0 
          );     
  
  if(CCI_SUCCESS != rc){
    const CciChar* message = CciString("Failed to log message",
                                       BIP_DEF_COMP_CCSID);
    raiseExceptionWithBroker(message, 
                             __FILE__, 
                             __LINE__, 
                             "logSomethingWithBroker");
  }   
} 
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 | as24570_