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

cciUserTraceW

Utilize cciUserTraceW para gravar uma mensagem de um catálogo de mensagens (com inserções) para o rastreio do usuário. Uma mensagem também é gravada no rastreio de serviço, se ele estiver ativo.

A mensagem gravada no rastreio do usuário possui o seguinte formato:

<stamp date-time> <Número_da_cadeia> Rastreio_do_Usuário <Texto de mensagem com inserções> <Explicação da Mensagem>

Sintaxe

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

Parâmetros

returnCode
Recebe o código de retorno da função (saída). Uma entrada de ponteiro NULL significa que o nó definido pelo usuário não irá lidar com erros. Quaisquer exceções lançadas durante a execução desta chamada serão lançadas novamente para o próximo nó de envio de dados no fluxo. Se a entrada não for NULL, a saída indicará o status de êxito da chamada. Se uma exceção ocorrer durante a execuçã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 é utilizado para determinar se a entrada deve ser escrita no rastreio. A entrada será gravada apenas se o rastreio estiver ativo para o nó. Os nós herdam sua configuração 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, do UNIX ou do z/OS.

Para utilizar o catálogo de mensagens do intermediário atual, especifique BIPmsgs em todos os sistemas operacionais. Como alternativa, 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 pode 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, pode haver vários caminhos por meio do código que resultam na mesma mensagem (messageSource e messageNumber) sendo gravada no rastreio. Utilize traceText para distinguir entre estes 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.
...
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

const CciChar*   myMessageSource=CciString("SwitchMSG",BIP_DEF_COMP_CCSID);
const CciChar*   text = CciString("propagando para incluir terminal",
                                   BIP_DEF_COMP_CCSID);
const CciChar*   insert = CciString("add", BIP_DEF_COMP_CCSID);
CciNode* thisNode = ((NODE_CONTEXT_ST*)context)->nodeObject;
int              rc = CCI_SUCCESS;
 
cciUserTrace(&rc,
             (CciObject*)thisNode,
             myMessageSource,
             1,
             text,
             insert,
             (CciChar*)0);
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:28


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