WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

cciLogW

cciLogW registra um evento de erro, aviso ou informativo. O evento é registrado pela interface do intermediário e utiliza os argumentos especificados como dados do log.

Sintaxe

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
O código de retorno da função (saída). Se o parâmetro messageSource for nulo, o returnCode será configurado como CCI_INV_DATA_POINTER.
type
O tipo de evento, conforme definido por CCI_LOG_TYPE (entrada). Os valores válidos são:
  • CCI_LOG_ERROR
  • CCI_LOG_WARNING
  • CCI_LOG_INFORMATION
file
O nome do arquivo de origem onde a função foi chamada (entrada). O valor é opcional, mas é útil para fins de depuração.
line
O número da linha no arquivo de origem onde a função foi chamada (entrada). O valor é opcional, mas é útil para fins de depuração.
function
O nome da função que chamou a função de registro (entrada). O valor é opcional, mas é útil para fins de depuração.
messageSource
O local e nome completos da origem da mensagem do Windows ou o catálogo de mensagens do Linux, UNIX ou z/OS.

Para utilizar o catálogo de mensagens do intermediário atual, especifique BIPmsgs em todos os sistemas operacionais. Alternativamente, você pode criar seu próprio catálogo de mensagens.

messageNumber
O número da mensagem identificando o evento (entrada). Se messageNumber for especificado como zero, supõe-se que a mensagem não está disponível. Se messageNumber for diferente de zero, a mensagem especificada será gravada no log de eventos do broker com quaisquer inserções fornecidas na lista de argumentos de variável (consulte o exemplo).
traceText
Informações de rastreio que são gravadas no registro de rastreio de serviço do intermediário (entrada). As informações são opcionais, mas são úteis para fins de depuração.
...
Uma lista de argumentos variáveis em C contendo quaisquer inserções de mensagem que acompanham a mensagem (entrada). Essas inserções são tratadas como cadeias de caracteres e os argumentos variáveis são considerados como sendo do tipo pointer to CciChar.

O último argumento nesta lista deve ser (CciChar*)0.

Valores de Retorno

Nenhum. Se ocorrer um erro, o parâmetro returnCode indica o motivo do erro.

Exemplo

void logSomethingWithBroker(CciChar* helpfulText, 
                            char* file,
                            int line,  
                            char* func 
                            ){
  int rc = CCI_SUCCESS;
  /* configurar o nome do catálogo de mensagens */
  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("Falha no registro de mensagens",
                                       BIP_DEF_COMP_CCSID);
    raiseExceptionWithBroker(message, 
                             __FILE__, 
                             __LINE__, 
                             "logSomethingWithBroker");
  }   
} 
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:28


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | as24570_