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>
void cciUserTraceW( int* returnCode, CciObject* object, const CciChar* messageSource, int messageNumber, const CciChar* traceText, ... );
Para utilizar
o catálogo de mensagens do intermediário atual, especifique BIPv600
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. Você pode executar o intermediário em uma plataforma, ler o log nessa plataforma e, em seguida, formatar o log em uma plataforma diferente. Por exemplo, se o intermediário estiver em execução no Linux, UNIX ou z/OS mas nenhum arquivo .cat estiver disponível, você poderá ler o log e, em seguida, transferi-lo para o Windows onde o log pode ser formatado utilizando 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.
O último argumento nesta lista deve ser (CciChar*)0.
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);