WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

cciLogW

cciLogW anota un error, un aviso o un suceso informativo. El suceso lo registra la interfaz del intermediario y utiliza los argumentos especificados como datos de anotaciones.

Sintaxis

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

Parámetros

returnCode
Código de retorno de la función (salida). Si el parámetro messageSource es un nulo, returnCode se establece en CCI_INV_DATA_POINTER.
type
Tipo de suceso, como lo define CCI_LOG_TYPE (entrada). Los valores válidos son:
  • CCI_LOG_ERROR
  • CCI_LOG_WARNING
  • CCI_LOG_INFORMATION
file
Nombre de archivo de origen donde se ha invocado la función (entrada). El valor es opcional, pero es útil al realizar depuraciones.
line
Número de línea del archivo de origen donde se ha invocado la función (entrada). El valor es opcional, pero es útil al realizar depuraciones.
function
Nombre de función que ha invocado la función de anotación (entrada). El valor es opcional, pero es útil al realizar depuraciones.
messageSource
La ubicación totalmente calificada y el nombre del origen de mensajes de Windows o el catálogo de mensajes de Linux, UNIX o z/OS.

Para utilizar el catálogo de mensajes del intermediario actual, especifique BIPmsgs en todos los sistemas operativos. De forma alternativa, puede crear su propio catálogo de mensajes.

messageNumber
Número de mensaje que identifica el suceso (entrada). Si messageNumber se especifica como cero, se supone que un mensaje no está disponible. Si messageNumber es distinto de cero, el mensaje especificado se graba en el registro de sucesos de intermediario con las inserciones proporcionadas en la lista de argumentos variables (consulte el ejemplo).
traceText
Información de rastreo que se graba en el registro de rastreo de servicio de intermediario (entrada). La información es opcional, pero es útil para realizar depuraciones.
...
Lista de argumentos variables C que contiene las inserciones de mensaje que acompañan al mensaje (entrada). Estas inserciones se tratan como series de caracteres y se supone que los argumentos variables son de tipo puntero a CciChar.

El último argumento de esta lista debe ser (CciChar*)0.

Valores de retorno

Ninguno. Si se produce un error, el parámetro returnCode indica la razón del mismo.

Ejemplo

void logSomethingWithBroker(CciChar* helpfulText, 
                            char* file,
                            int line,  
                            char* func 
                            ){
  int rc = CCI_SUCCESS;
  /* definir el nombre de catálogo de mensajes */
  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("Error al anotar mensaje",
                                       BIP_DEF_COMP_CCSID);
    raiseExceptionWithBroker(message, 
                             __FILE__, 
                             __LINE__, 
                             "logSomethingWithBroker");
  }   
} 
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

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

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:29


Tema de referenciaTema de referencia | Versión 8.0.0.5 | as24570_