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, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:05:02


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