Sie können eine Nachrichtengruppe mit Nachrichtendefinitionen auffüllen, indem Sie COBOL-Copy Book-Dateien mit Hilfe des Assistenten für neue Nachrichtendefinitionsdateien oder dem Befehlszeilendienstprogramm mqsicreatemsgdefs importieren.
Mit jedem importierten COBOL-Copy Book wird eine neue Nachrichtendefinitionsdatei erstellt. Der Stammname der Nachrichtendefinitionsdatei entspricht standardmäßig dem Namen der COBOL-Copy Book-Datei. Sie können jedoch mit dem Assistenten für eine neue Nachrichtendefinitionsdatei einen anderen Stammdateinamen auswählen.
Wenn die Nachrichtendefinitionsdatei bereits existiert, müssen Sie ein Überschreiben zugelassen haben, damit der Import fortgesetzt werden kann. In diesem Fall wird der vorhandene Inhalt gelöscht und erneut erstellt.
Standardmäßig gehören alle Nachrichtendefinitionsdateien, die als Folge des Imports der COBOL-Copy Book-Datei erstellt wurden, dem XML-Namespace noTarget an und befinden sich daher im (Standard-) Speicherort in Ihrem Arbeitsbereich. Dieser standardmäßige Namespace kann durch die Angabe eines Ziel-Namespace überschrieben werden. Gründe für diese Vorgehensweise finden Sie unter Namespaces bei Nachrichten, die nicht im XML-Format sind.
In Ihrer COBOL-Copy Book-Datei sind für gewöhnlich eine oder mehrere Level 01-Strukturen enthalten. Sie können bestimmen, welche dieser Strukturen importiert werden sollen. Diese Strukturen sowie weitere, die unter Umständen erforderlich sind, werden dann importiert. Alle importierten Strukturen werden in die entsprechenden Elemente, Gruppen und Typen in der Nachrichtendefinitionsdatei konvertiert.
Desweiteren können Sie angeben, welche der ausgewählten Level 01-Strukturen Nachrichten in der Nachrichtendefinitionsdatei sein sollen. Beim Import werden für jede Struktur, die Sie angeben, eine Nachricht und das entsprechende globale Element in einer Nachrichtendefinitionsdatei erstellt. Wenn Sie nicht angeben, dass Nachrichten erstellt werden sollen, müssen Sie sie nach Beendigung des Imports mit Hilfe des Nachrichtendefinitions-Editors manuell erstellen.
Wenn Sie beim Import den Assistenten für eine Neue Nachrichtendefinitionsdatei verwenden, können Sie pro Importvorgang nur eine COBOL-Copy Book-Datei importieren. Wenn Sie beim Import das Befehlszeilendienstprogramm verwenden, können Sie mit jedem Importvorgang mehrere COBOL-Copy Book-Dateien importieren.
Wenn Ihre COBOL-Copy Book-Datei zur erfolgreichen Kompilierung weitere Copy Books benötigt, müssen Sie diese im selben Verzeichnis zur Verfügung stellen, da die Kompilierung Ihres Copy Books als Teil des Imports ausgeführt wird.
Während des Imports wird eine Berichtsdatei erstellt. Sie befindet sich standardmäßig im Ordner log (Protokoll) der Nachrichtengruppe. Standardmäßig übernimmt sie den Namen der Nachrichtendefinitionsdatei mit der Erweiterung .report.txt.
Neben logischen Informationen kann der Import auch physische Informationen erstellen. Wenn die Nachrichtengruppe CWF-Formate enthält, werden die physischen Formateigenschaften für alle CWF-Formatschichten aufgefüllt. Enthält die Nachrichtengruppe keine CWF-Formate, werden nur logische Informationen erstellt. Wenn Sie aus der Befehlszeile importieren, werden standardmäßig ebenfalls nur logische Informationen in der neuen Nachrichtengruppe erstellt. Ausführliche Informationen zum zusätzlichen Erstellen von physischen Informationen finden Sie unter Import von einer Befehlszeile aus .
Die Eigenschaften der physischen XML und TDS-Formate werden nicht aufgefüllt und übernehmen daher Standardwerte.
Bei einer oder mehreren TDS-Schichten kann der Import zu Einträgen in der Taskliste führen, die Sie warnen, dass bestimmte TDS-Eigenschaften eingerichtet sein müssen, wenn die COBOL-Strukturen, die Sie importiert haben, in einer TDS-Nachricht angezeigt werden sollten.
Wenn das physische TDS-Format nicht auf Ihre COBOL-Strukturen anwendbar ist, können Sie diese Einträge in die Taskliste ignorieren, da es sich lediglich um Warnungen handelt. Sie verhindern nicht, dass Ihr Modell in einem anderen Format, beispielswiese als Nachrichten-Dictionary, generiert wird.
Da physische Informationen erstellt werden, ist die Anwendungszielumgebung (Plattform und Compiler) wichtig, da sie beispielsweise regelt, wie Ganzzahlen in der Nachricht dargestellt werden. Sie können umgebungsspezifische Informationen als Teil des Importvorgangs angeben. Die erforderlichen Eigenschaften werden daraufhin entsprechend eingerichtet. Es werden mehrere Umgebungen unterstützt. Sollte Ihre Umgebung nicht darunter sein, sollten Sie die Umgebung auswählen, die Ihrer am nächsten kommt, und nach Beendigung des Imports die erstellten physischen Informationen mit dem Nachrichtendefinitions-Editor prüfen.
Das Befehlszeilendienstprogramm mqsicreatemsgdefs ermöglicht Ihnen, mehrere COBOL-Dateien mit einem einzigen Vorgang zu importieren. Alle COBOL-Copy Book-Dateien müssen sich in einem Verzeichnis befinden, und die Verzeichnisposition muss als Parameter an das Dienstprogramm üb ergeben worden sein.
Sie geben die erforderlichen umgebungsspezifischen Information mit Hilfe einer XML-Datei an. Diese muss ein XML-Element namens <COBOL> enthalten. In diesem Element befindet sich eine Reihe von umgebungsspezifischen Informationen, die für alle COBOL-Copy Book-Dateien gelten, die beim Aufruf des Dienstprogramms importiert wurden. Eine XML-Standarddatei namens mqsicreatemsgdefs.xml steht zur Verfügung. Wenn Sie verschiedene Informationen auf verschiedene Copy Books anwenden möchten, müssen Sie mehrere XML-Dateien erstellen und das Dienstprogramm mehrmals ausführen.
Das Dienstprogramm mqsicreatemsgdefs ermöglicht Ihnen zudem, als Teil des Importvorgangs eine neue Nachrichtengruppe zu erstellen, in der die Nachrichtendefinitionsdateien gespeichert werden. Sie können auch festlegen, ob die erstellte Nachrichtengruppe auf einer bestehenden Nachrichtengruppe basieren soll. Mit dieser Funktion können Sie eine leere Nachrichtengruppe vorbereiten, die ein CWF-Format und vorab aufgefüllte CWF-Eigenschaften auf Nachrichtengruppenebene enthält, die dann in die beim Import erstellte Nachrichtengruppe kopiert werden.