Mit cciUserTraceW kann eine Nachricht aus einem Nachrichtenkatalog (mit Einfügungen) in einen Benutzertrace geschrieben werden. 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 cciUserTraceW( int* returnCode, CciObject* object, const CciChar* messageSource, int messageNumber, const CciChar* traceText, ... );
Geben Sie zur Verwendung des aktuellen Broker-Nachrichtenkataloges in allen Betriebssystemen BIPv600 an. Sie haben auch die Möglichkeit, einen eigenen Nachrichtenkatalog zu 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. Es ist möglich, den Broker auf einer Plattform auszuführen, das Protokoll auf dieser Plattform zu lesen und es dann auf einer anderen Plattform zu formatieren. Wird der Broker beispielsweise unter Linux, UNIX oder z/OS ausgeführt und ist keine Datei mit der Erweiterung .cat verfügbar, kann das Protokoll gelesen und anschließend auf Windows übertragen werden. Dort kann das Protokoll unter Verwendung der Datei .properties formatiert werden.
Wenn dieser Parameter NULL lautet, tritt genau dasselbe ein wie beim Angeben einer leeren Zeichenfolge. D. h., alle anderen Informationen werden in das Protokoll geschrieben, und das Feld für den Katalog enthält als Wert eine leere Zeichenfolge. Folglich kann das Formatierungsprogramm für Protokolle die Nachrichtenquelle nicht finden, und die Formatierung dieses Eintrags schlägt fehl.
Das letzte Argument in dieser Liste muss (CciChar*)0 lauten.
const CciChar* myMessageSource=CciString("SwitchMSG",BIP_DEF_COMP_CCSID); const CciChar* text = CciString("propagating to add 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);