Essa função é muito semelhante à cciServiceTrace sendo que
a única diferença é que a entrada é escrita apenas no rastreio de serviço, apenas
quando esse rastreio está ativo no nível de depuração.
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 um CciNode* ou um CciParser*. Se for um CciNode*,
o nome desse nó será gravado no rastreio. Se for 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 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 este parâmetro for NULL, o nível de rastreio para o grupo de execução será
retornado.
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.