Erstellen Sie Ihre eigenen Nachrichtenkataloge, und schreiben Sie auf diese Weise angepasste Einträge in das lokale Fehlerprotokoll.
Bei manchen Fehlern und anderen Situationen ist es ratsam, Informationen in das Fehlerprotokoll zu schreiben, um nachvollziehen zu können, was in einem Nachrichtenfluss passiert. Über die integrierten Throw- und Trace-Knoten können Sie Einträge in dem Protokoll generieren. Sie haben aber auch die Möglichkeit, eigene Knoten und Benutzerausgänge zu erstellen und von den benutzerdefinierten Erweiterungen aus Einträge in das Protokoll zu schreiben.
Folgende Nachrichtensätze können geschrieben werden:
Bei Verwendung dieser Nachrichten können Sie zusätzlichen Text angeben, der dann im Nachrichtentext angezeigt wird.
Die Anweisungen in diesem Abschnitt beschreiben, wie Nachrichtenkataloge für C-Programme erstellt werden. Informationen zur Erstellung eines Java-Ressourcenpakets finden Sie in der Dokumentation zu Java 2 Platform Standard Edition.
Lesen Sie den entsprechenden Abschnitt für die Betriebsumgebung Ihres Brokers:
Unter Windows muss der zusätzliche Nachrichtenkatalog in Form einer DLL-Datei erstellt werden. Die DLL-Datei enthält Definitionen Ihrer Ereignisnachrichten, damit die Ereignisanzeige ein lesbares Format anzeigen kann, basierend auf der von Ihrer Anwendung geschriebenen Ereignisnachricht. Wenn Sie einen Nachrichtenkatalog kompilieren, wird eine Headerdatei erstellt, die für jede Ereignisnachrichtennummer, die Sie erstellt haben, symbolische Werte definiert. Sie müssen die Headerdatei in Ihre Anwendung aufnehmen.
So erstellen Sie eine Ereignisquelle für den Windows-Ereignisprotokolldienst:
Auf Linux-, UNIX- und z/OS-Systemen werden die Nachrichten in die Funktion SYSLOG geschrieben. Wenn Sie Ihren eigenen Nachrichtenkatalog verwenden möchten, müssen Sie einen XPG/4-Nachrichtenkatalog erstellen.
Der Prozess zur Erstellung eines Nachrichtenkatalogs (CAT-Datei) ist von dem Prozess abhängig, auf dem der Katalog erstellt wird. Sie verwenden normalerweise die Befehle gencat (Erstellen oder Ändern eines Nachrichtenkatalogs) und dspcat (Anzeige aller Nachrichtenkataloge oder eines Teils davon). Durch den Befehl gencat werden Textdateien mit Ihrer Textnachricht zusammengefügt, um einen formatierten Katalog zu erstellen oder zu ändern. Die Textdateien haben normalerweise die Dateierweiterung .msg.
export NLSPATH=${NLSPATH}:${MY_INST_PATH}/messages/%L/%N:${MY_INST_PATH}/messages/En_US/%NIn diesem Beispiel wird die englische Version später im Suchpfad fest codiert, um sicherzustellen, dass Nachrichten auch in Ländereinstellungen ohne CAT-Datei angezeigt werden.
1234 "MSG1234E: \ Syntaxfehler. \n Der Wert '{0}' ist für Eigenschaft '{1}' nicht gültig.\n Korrigieren Sie den Wert, und geben Sie den Befehl erneut aus.\n"
Wenn Sie einen Nachrichtenkatalog auf einem Betriebssystem erstellen, kann er nicht auf ein anderes Betriebssystem übertragen werden, da die Kataloge binär codiert sind. Sie können aber die gleichen MSG-Dateien als Eingabe für den Befehl gencat auf einem anderen System verwenden.
Die relevanten Informationen dazu finden Sie in der Dokumentation Ihres Betriebssystems. Beispiel:
Sie müssen auch die Informationen zu zusätzlich unterstützten Ländereinstellungen prüfen, wenn Sie Nachrichten in anderen Ländereinstellungen als amerikanischem Englisch verwenden möchten.