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 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.
O último argumento nesta lista deve ser (CciChar*)0.
Nenhum. Se ocorrer um erro, o parâmetro returnCode indica o motivo do erro.
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);