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.
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, 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 der Basisnachrichtengruppe 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 Basisnachrichtengruppe verwendet werden soll.
- Fügen Sie zu dieser Basisnachrichtengruppe 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 die Basisnachrichtengruppe, die
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 des Importvorgangs (beispielsweise Warnungen, die generiert wurden, und Nachrichtenmodellobjekte, die erstellt wurden).
- Die Anzahl importierter Dateien.
- Starten Sie WebSphere Message
Broker Toolkit, 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-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.