In diesem Abschnitt wird beschrieben, wie mithilfe des
Befehlszeilenimportprogramms
mqsicreatemsgdefs eine C-Datei, ein
COBOL-Copybook, eine XML-DTD oder ein XML-Schema importiert werden, um einen Nachrichtensatz mit
Nachrichtendefinitionen auszufüllen.
Tipp: Der Begriff Nachrichtensatz bezeichnet den von WebSphere Message
Broker verwendeten ursprünglichen Container für Nachrichtenmodelle. In WebSphere Message
Broker Version 8.0 und höher erfolgt die Nachrichtenmodellierung bei den meisten Datenformaten bevorzugt über Dateien des Nachrichtenmodellschemas, die in Anwendungen und Bibliotheken enthalten sind. Nachrichtensätze werden weiterhin unterstützt und sind bei Verwendung der MRM- oder IDOC-Domänen sogar erforderlich. Wenn Sie Datenformate zur Verwendung in den MRM- oder IDOC-Domänen modellieren müssen, müssen Sie zunächst die Nachrichtensatzentwicklung im WebSphere Message
Broker Toolkit aktivieren. Weitere Informationen hierzu finden Sie unter Nachrichtensatzentwicklung in WebSphere Message Broker Version 8.0 aktivieren.
Vorbereitungen:
Bevor Sie diese Aktion ausführen, sollten Sie folgende Informationen lesen:
Das Befehlszeilenimportprogramm ermöglicht es Ihnen, einen neuen Nachrichtensatz zu erstellen, in dem die Nachrichtendefinitionsdateien gespeichert werden. Wenn Sie einen neuen Nachrichtensatz von der Befehlszeile aus erstellen, werden nur die logischen Informationen standardmäßig gespeichert. Das Befehlszeilenimportprogramm ermöglicht es Ihnen, einen neuen Nachrichtensatz zu erstellen, der auf einem bestehenden Nachrichtensatz basiert. Die physischen Formatierungsangaben des Basisnachrichtensatzes werden ebenfalls im neuen Nachrichtensatz erstellt. Wenn Sie möchten, dass auch Informationen zum physischen Format erstellt werden, müssen Sie wie folgt vorgehen, bevor Sie den Befehl mqsicreatemsgdefs aufrufen:
- Erstellen Sie mithilfe der WebSphere Message
Broker Toolkit einen Nachrichtensatz in
Ihrem Arbeitsbereich, die als Basisnachrichtensatz verwendet werden soll.
- Fügen Sie zu diesem Basisnachrichtensatz die physischen Formate hinzu, die in Ihrem neuen Nachrichtensatz erstellt werden sollen.
So importieren Sie eine C-Datei, COBOL-Copybooks, eine XML-DTD
oder ein XML-Schema über die Befehlszeile:
- Schließen Sie die WebSphere Message
Broker Toolkit. Sie darf nicht aktiv sein, wenn Sie das Befehlszeilenimportprogramm verwenden.
- Rufen Sie den Befehl mqsicreatemsgdefs von einer Befehlszeile aus auf. und geben Sie dabei den Projektnamen des Nachrichtensatzes, den Pfadnamen des Quellendateiordners sowie andere optionale Parameter an, die Sie benötigen. Wenn Sie zum neuen Nachrichtensatz, der mit
dem Befehl mqsicreatemsgdefs
erstellt wird, physische Formate hinzufügen möchten, geben Sie den Basisnachrichtensatz, der
diese physischen Formate enthält, als -base-Parameter in der
Befehlszeile für den Import an.
- Öffnen Sie die Datei mqsicreatemsgdefs.report.txt, wenn der Befehl beendet wurde. Diese Nachricht wird erstellt, wenn Sie den Befehl mqsicreatemsgdefs aufrufen, und er wird standardmäßig in das Verzeichnis geschrieben, von dem aus Sie den Befehl aufgerufen haben. Der Bericht stellt folgende Informationen bereit:
- Details der Parameter, die beim Aufruf des Befehls mqsicreatemsgdefs verwendet wurden.
- Die Aktion der Nachrichtensatzebene.
- Die Namen der Dateien, die importiert wurden.
- Details zum Importvorgang (beispielsweise Warnungen, die generiert wurden, und
Nachrichtenmodellobjekte, die erstellt wurden).
- Die Anzahl importierter Dateien.
- Starten Sie die WebSphere Message
Broker Toolkit und wechseln Sie zur
Ansicht 'Brokeranwendungsentwicklung'. Die Nachrichtendefinitionsdatei,
die beim Aufruf von mqsicreatemsgdefs
erstellt wurde, wird in dem von Ihnen angegebenen Projekt angezeigt.
Überprüfen Sie alle Fehler sorgfältig, die das Importprogramm
auflistet, wenn während des Imports einer C-Datei, eines COBOL-Copybooks, einer XML-DTD oder einer
XML-Schemadatei ein Fehler auftritt. Standardmäßig werden alle Fehler angezeigt und in der oben
beschriebenen Protokolldatei gespeichert. Geben Sie den Befehlszeilenparameter
-v (verbose, ausführlich) an, um zusätzliche Informationen
zum Import zu sammeln. Dieser Parameter zeigt mit fortschreitendem Import detailliertere Informationen an.