In diesem Abschnitt wird beschrieben, wie mit Hilfe des Befehlszeilenimportprogramms
mqsicreatemsgdefs eine C-Headerdatei, ein
COBOL-Copy-Book, eine XML-DTD oder ein XML-Schema importiert werden, um eine Nachrichtengruppe mit
Nachrichtendefinitionen auszufüllen.
Vor dem Start müssen Sie Folgendes beachten:
Bevor Sie diese Aktion ausführen, sollten Sie folgende Informationen lesen:
Das Befehlszeilenimportprogramm ermöglicht es Ihnen, eine neue Nachrichtengruppe zu erstellen, in der die Nachrichtendefinitionsdateien gespeichert werden. Wenn Sie eine neue neue Nachrichtengruppe von der Befehlszeile aus erstellen, werden nur die logischen Informationen standardmäßig gespeichert. Das Befehlszeilenimportprogramm ermöglicht es Ihnen, eine neue Nachrichtengruppe zu erstellen, die auf einer bestehenden Nachrichtengruppe basiert. Die physischen Formatierungsangaben der Basisnachrichtengruppe werden ebenfalls in der neuen Nachrichtengruppe 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 mit Hilfe der Workbench eine Nachrichtengruppe in
Ihrem Arbeitsbereich, die als Basisnachrichtengruppe verwendet werden soll.
- Fügen Sie zu dieser Basisnachrichtengruppe die physischen Formate hinzu, die in Ihrer neuen Nachrichtengruppe erstellt werden sollen.
Verwenden Sie die Befehlszeile, um C, COBOL-Copy-Books, XML-DTD oder XML-Schemas zu importieren:
- Schließen Sie die Workbench. Sie darf nicht aktiv sein, wenn Sie den Befehlszeilenimporter verwenden.
- Rufen Sie den Befehl mqsicreatemsgdefs von einer Befehlszeile aus auf. und geben Sie dabei den Projektnamen der Nachrichtengruppe, den Pfadnamen des Quellendateiordners sowie andere optionale Parameter an, die Sie benötigen.
Wenn Sie der neuen Nachrichtengruppe physische Formate hinzufügen möchten, die der Befehl mqsicreatemsgdefs erstellt, geben Sie die Basisnachrichtengruppe an, die diese physischen Formate als -base-Parameter in der Befehlszeile enthält.
- Ö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 Nachrichtengruppenebene.
- Die Namen der Dateien, die importiert wurden.
- Details des Importvorgangs (beispielsweise Warnungen, die generiert wurden, und Nachrichtenmodellobjekte, die erstellt wurden).
- Die Anzahl importierter Dateien.
- Starten Sie Workbench, und schalten Sie zu Ansicht 'Brokeranwendungsentwicklung' um. 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-, COBOL-Copy-Book-, XML-DTD- oder 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.