Nachrichtenkatalog erstellen

Die Nachrichtenfunktion stellt Befehle und Subroutinen zum Abrufen und Anzeigen von Programmnachrichten bereit, die sich in ausgelagerten Nachrichtenkatalogen befinden. Ein Programmierer erstellt eine Nachrichtenquellendatei, die Anwendungsnachrichten enthält, und konvertiert sie in einen Nachrichtenkatalog. Die Umsetzung von Nachrichtenquellendateien in andere Sprachen und die anschließende Konvertierung der Dateien in Nachrichtenkataloge erfordert keine Änderung oder erneute Kompilierung eines Programms.

Um einen Nachrichtenkatalog zu erstellen, verarbeiten Sie die vollständige Nachrichtenquellendatei mit dem Befehl Gencat der Nachrichtenfunktion. Dieser Befehl kann wie folgt verwendet werden:

• Mit dem Befehl Gencat können Sie eine Nachrichtenquellendatei verarbeiten, die Satznummern, Nachrichten-ID-Nummern und Nachrichtentext enthält. Nachrichtenquellendateien mit symbolischen IDs können nicht direkt vom Befehl Gencat verarbeitet werden. Im folgenden Beispiel werden die Informationen in der Nachrichtenquellendatei x.msg verwendet, um eine Katalogdatei zu generieren:

  gencat x.cat x.msg

• Verwenden Sie den Befehl Mkcatdefs , um eine Nachrichtenquellendatei mit symbolischen IDs vorzuverarbeiten. Die resultierende Datei wird dann über eine Pipe an den Befehl Gencat geleitet. Der Befehl mkcatdefs erzeugt eine Datei SymbolName_msg.h mit Definitionsanweisungen. Diese Anweisungen setzen symbolische IDs mit Satznummern und Nachrichten-ID-Nummern, die vom Mkcatdefs -Befehl zugeordnet werden, gleich. Die Datei SymbolName_msg.h sollte in Programme aufgenommen werden, die diese symbolischen Bezeichner verwenden. Der Befehl mkcatdefs ist spezifisch für AIX®. Das folgende Beispiel verwendet die Informationen in der Quelldatei x.msg, um die Header-Datei x_msg.h zu erzeugen:

  mkcatdefs x x.msg

• Verwenden Sie den Befehl Runcat , um eine Quellendatei mit symbolischen IDs automatisch zu verarbeiten. Der Befehl Runcat ruft den Befehl Mkcatdefs auf und leitet die Ausgabe an den Befehl Gencat weiter. Der Befehl runcat gilt speziell für AIX. Im folgenden Beispiel werden die Informationen in der Nachrichtenquellendatei x.msg zum Generieren der Headerdatei x_msg.h und der Katalogdatei X.cat verwendet:

  runcat x x.msg

mkcatdefs x x.msg | gencat x.cat

Wenn ein Nachrichtenkatalog mit dem mit dem Parameter CatalogFile angegebenen Namen vorhanden ist, ändert der Befehl gencat den Katalog entsprechend den Anweisungen in den Nachrichtenquellendateien. Wenn kein Nachrichtenkatalog vorhanden ist, erstellt der Befehl gencat eine Katalogdatei mit dem Namen, der im Parameter CatalogFile angegeben ist.

Sie können eine beliebige Anzahl von Quellendateien für Nachrichtentexte angeben. Mehrere Dateien werden in der angegebenen Reihenfolge verarbeitet. Jede weitere Quellendatei ändert den Katalog. Wenn Sie keine Quellendatei angeben, akzeptiert der Befehl Gencat Nachrichtenquellendaten aus der Standardeingabe.