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

cciServiceTrace

Grava uma mensagem no rastreio de serviço, se ele estiver ativo.

A mensagem gravada no rastreio de serviço possui o seguinte formato:
<stamp datetime> <Número_da_cadeia> +cciServiceTrace <Nome_do_nó> <Tipo_de_nó> <Texto_de_rastreio>, <Etiqueta_do_nó>

Sintaxe

void cciServiceTrace(
  int*           returnCode,
  CciObject*     object,
  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 significa que o nó definido pelo usuário não manipula erros. As exceções emitidas durante a execução dessa chamada são emitidas novamente para o próximo nó de envio de dados do fluxo. Se o parâmetro de entrada não for NULL, a saída especifica 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. Use CciGetLastExceptionData para obter detalhes da exceção.
object (entrada)
O endereço do objeto que deve ser associado à entrada de rastreio (entrada). Esse objeto pode ser o endereço de um CciNode ou um CciParser. Se você especificar um CciNode, o nome desse nó é gravado no rastreio. Se você especificar um CciParser, o nome do nó que criou o analisador é gravado no rastreio. Esse objeto também é usado para determinar se a entrada é gravada para rastreio. A entrada será gravada apenas se o rastreio estiver ativo para o nó. No momento, os nós herdam sua configuração de rastreio do fluxo de mensagens.
Se esse parâmetro for NULL, as ações a seguir serão tomadas:
  • <Nome_do_nó>, <Tipo_do_nó>, <Etiqueta_do_nó> e <Etiqueta_do_Fluxo_de_mensagem> são omitidos da entrada de rastreio.
  • A entrada é escrita com base na configuração de rastreio do grupo de execução.
traceText (entrada)
Uma cadeia de caracteres que termina com NULL (entrada). Essa cadeia é gravada no rastreio de serviço e você pode usá-la para correlacionar as entradas de rastreio com os caminhos por meio do código de origem. 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. Ou seja, a cadeia traceText é uma cadeia literal estática na origem e, portanto, a mesma cadeia está no arquivo do código-fonte e no arquivo de rastreio formatado.
Essa cadeia deve estar na página de códigos ISO-8859-1 (ibm-819) para as extensões definidas pelo usuário executadas nas plataformas distribuídas e devem estar no EBCDIC (1047) para extensões definidas pelo usuário executadas no z/OS.

Valores de Retorno

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

Exemplo

    CciNode* thisNode = ((NODE_CONTEXT_ST*)context)->nodeObject;

    cciServiceTrace(&rc,(CciObject*)thisNode,">>_Switch_evaluate()");
    checkRC(rc);
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 | as24520_