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 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ó acima no fluxo. Se a entrada não for NULL, a saída significará o status de êxito da chamada. Se uma exceção ocorrer durante a execução, *returnCode será configurado como CCI_EXCEPTION na saída. Uma chamada para CciGetLastExceptionData fornecerá 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 for um CciNode, o nome desse nó será escrito no rastreio. Se for um CciParser, o nome do nó que criou o analisador será escrito no rastreio. Esse objeto também é utilizado para determinar se a entrada deve ser escrita no rastreio. A entrada apenas será escrita, se o rastreio estiver ativo para o nó. Atualmente, os nós herdam a configuração do rastreio a partir do fluxo de mensagens.
Se esse parâmetro for NULL, ocorrerá o seguinte:
  • <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 será gravada no rastreio de serviço e fornecerá 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. traceText pode ser utilizado para distinguir entre esses caminhos diferentes. Isto é, a cadeia traceText será uma cadeia literal estática na origem e, portanto, a mesma cadeia será no arquivo de 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 extensões definidas pelo usuário em execução em plataformas distribuídas e devem estar em EBCDIC (1047) para extensões definidas pelo usuário em execução no Z/OS. Consulte a seção NLS.

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
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as24520_