Mit cciUserTrace können Sie eine Nachricht aus einem Nachrichtenkatalog (mit Einfügungen) in einen Benutzertrace schreiben. Es wird auch eine Nachricht in einen Service-Trace geschrieben, falls dieser aktiv ist.
Der Text der Nachricht, der in den Benutzertrace geschrieben wird, hat folgendes Format:
<Datum-Zeitmarke> <Threadnummer> UserTrace <Nachrichtentext mit Einfügungen> <Nachrichtenerläuterung>
void cciUserTrace(
int* Rückkehrcode,
CciObject* object,
const CciChar* messageSource,
int messageNumber,
const char* traceText,
...
);
Geben Sie zur Verwendung des aktuellen Broker-Nachrichtenkataloges in allen Betriebssystemen BIPmsgs an. Als Alternative können Sie auch Ihren eigenen Nachrichtenkatalog erstellen.
Beim Formatieren des Trace wird eine Nachricht aus der landessprachlichen Version dieses Katalogs geschrieben. Es gilt die länderspezifische Einstellung der Umgebung, in der der Trace formatiert wird.
Sie können den Broker auf einem Betriebssystem ausführen, das Protokoll auf diesem Betriebssystem lesen und es dann auf einem anderen Betriebssystem formatieren. Wenn der Broker beispielsweise unter Linux ausgeführt wird, dort aber keine CAT-Datei vorhanden ist, können Sie das Protokoll lesen und es dann auf ein Windows-System übertragen, wo es mithilfe der PROPERTIES-Datei formatiert werden kann.
Keine. Wenn ein Fehler auftritt, gibt der Parameter returnCode die Fehlerursache an.
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);