Use cciUserTrace to write a message from a message catalog (with inserts) to user trace. A message is also written to service trace, if service trace is active.
The message written to user trace has the following format:
<date-time stamp> <threadNumber> UserTrace <Message text with inserts> <Message Explanation>
void cciUserTrace(
int* returnCode,
CciObject* object,
const CciChar* messageSource,
int messageNumber,
const char* traceText,
...
);
To use the current broker message catalog, specify BIPmsgs on all operating systems. Alternatively, you can create your own message catalog.
When trace is formatted, a message from the NLS version of this catalog is written. The locale used is that of the environment where the trace is formatted.
You can run the broker on one operating system, read the log on that operating system, then format it on a different operating system. For example, if the broker is running on Linux, but no .cat file is available, you could read the log, then transfer it to Windows, where the log can be formatted by using the .properties file.
None. If an error occurs, the returnCode parameter indicates the reason for the error.
const CciChar* myMessageSource=CciString("SwitchMSG",BIP_DEF_COMP_CCSID);
CciNode* thisNode = ((NODE_CONTEXT_ST*)context)->nodeObject;
cciUserTrace(&rc,
(CciObject*)thisNode,
myMessageSource,
1,
"propagating to add terminal",
"add",
(char*)0);
checkRC(rc);