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

cciUserDebugTrace

Utilize cciUserDebugTrace para gravar uma mensagem de um catálogo de mensagens (com inserções) no rastreio do usuário quando ele estiver ativo no nível de depuração.

Se o rastreio do usuário não estiver ativo no nível de depuração, uma entrada será gravada no rastreio de serviço quando o rastreio de serviço estiver ativo.

Sintaxe

void cciUserDebugTrace(
  int*           returnCode,
  CciObject*     object,
  const CciChar* messageSource,
  int            messageNumber,
  const char*    traceText,
  ...
);

Parâmetros

returnCode
Recebe o código de retorno da função (saída). Um parâmetro de entrada do ponteiro NULL indica que o nó definido pelo usuário não manipula erros. Todas as exceções que são emitidas durante a execução dessa chamada são emitidas novamente para o próximo nó de envio de dados no fluxo. Se o parâmetro de entrada não for NULL, a saída significa o status de sucesso da chamada. Se ocorrer uma exceção durante a execução, o *returnCode será definido como CCI_EXCEPTION na saída. Chame CciGetLastExceptionData para obter detalhes da exceção.
object
O endereço do objeto que deve ser associado à entrada de rastreio (entrada). Esse objeto pode ser um CciNode* ou um CciParser*. Se você especificar um CciNode*, o nome desse nó será gravado no rastreio. Se você especificar um CciParser*, o nome do nó que criou o analisador será gravado no rastreio. Esse objeto também é usado para determinar se a entrada é gravada para rastreio. A entrada é gravada apenas se o rastreio estiver ativo para o nó. Os nós herdam suas configurações de rastreio do fluxo de mensagens.
Se este parâmetro for NULL, o nível de rastreio para o grupo de execução será retornado.
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.

Quando o rastreio é formatado, uma mensagem da versão NLS desse catálogo é escrita.

O código do idioma utilizado é esse do ambiente, no qual o rastreio é formatado. É possível executar o broker em um sistema operacional, ler o log nesse sistema operacional, em seguida, formatar o log em um sistema operacional diferente. Por exemplo, se o broker estiver em execução no Linux, UNIX ou z/OS mas nenhum arquivo .cat estiver disponível, será possível ler o log, em seguida, transferi-lo para Windows onde o log pode ser formatado usando o arquivo .properties.

Se este parâmetro for NULL, o resultado será o mesmo que a especificação de uma cadeia vazia. Isto é, todas as outras informações serão gravadas no registro e o campo catalogue terá um valor de cadeia vazio. Portanto, o formatador de log não poderá localizar a origem da mensagem e falhará ao formatar esta entrada.

messageNumber
O número que identifica a mensagem dentro do messageSource especificado (entrada). Se o messageSource não contiver uma mensagem que corresponde a esse messageNumber, o formatador de registro falhará ao formatar essa entrada.
traceText
Uma cadeia de caracteres que termina com NULL (entrada). Essa cadeia será gravada no rastreio de serviço e fornece uma maneira fácil de correlacionar as entradas de rastreio com os caminhos através do código-fonte. Por exemplo, é possível ter vários caminhos através do código que resultam na gravação da mesma mensagem (messageSource e messageNumber) no rastreio. traceText pode ser utilizado para distinguir entre esses caminhos diferentes. Isto é, a cadeia traceText é uma cadeia literal estática na origem e, portanto, a mesma cadeia está no arquivo de código-fonte e no arquivo de rastreio formatado.
...
Uma lista de argumentos da variável C que contém outras inserções de mensagens 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 char. O último argumento nesta lista precisa ser (char*)0.
  • Para extensões definidas pelo usuário que estão em execução em plataformas distribuídas, os argumentos char* devem estar na página de códigos ISO-8859-1 (ibm-918).
  • Para extensões definidas pelo usuário que está em execução em plataformas z/OS, os argumentos char* devem estar em EBCIDIC (1047).
Esses requisitos se aplicam a todos os argumentos char* no traceText e a lista de inserções de argumentos da variável (...).

Valores de Retorno

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

Exemplo

const CciChar*   myMessageSource=CciString("SwitchMSG",BIP_DEF_COMP_CCSID);
CciNode* thisNode = ((NODE_CONTEXT_ST*)context)->nodeObject;

const char* mbElementName  = mbString((CciChar*)&elementName,BIP_DEF_COMP_CCSID);
const char* mbElementValue = mbString((CciChar*)&elementValue,BIP_DEF_COMP_CCSID);
const char* traceTextFormat = "Switch Element: name=%s, value=%s";
char* traceText = (char*)malloc(strlen(traceTextFormat) + 
                                strlen(mbElementName) + 
                                strlen(mbElementValue));
sprintf(traceText,traceTextFormat,mbElementName,mbElementValue);
    
cciUserDebugTrace(&rc,
                 (CciObject*)thisNode,
                 myMessageSource,
                 2,
                 traceText,
                 mbElementName,
                 mbElementValue,
                 (char*)0);
free((void*)mbElementName);
free((void*)mbElementValue);
free((void*)traceText);
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:27


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