cciLogW

Anota un error, un aviso o un suceso informativo. La interfaz de intermediario de mensajes anota el suceso utilizando 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
Serie de caracteres que identifica el origen de mensajes Windows o el catálogo de mensajes de Linux y UNIX.
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 más abajo).
traceText
Información de rastreo que se graba en las anotaciones 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.
Nota: 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("BIPv600", 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");
  }   
} 
Conceptos relacionados
Extensiones definidas por el usuario
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as24570_