Import aus C-Headerdateien zum Erstellen von Nachrichtendefinitionen

Sie können Ihre Nachrichtengruppe mit Nachrichtendefinitionen auffüllen, indem Sie die C-Headerdateien mit Hilfe des Assistenten für eine Neue Nachrichtendefinitionsdatei oder dem Befehlszeilendienstprogramm mqsicreatemsgdefs importieren.

Mit jeder importierten C-Headerdatei wird eine neue Nachrichtendefinitionsdatei erstellt. Der Stammname der Nachrichtendefinitionsdatei entspricht standardmäßig dem Namen der C-Headerdatei. 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 C-Headerdatei 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 C-Headerdatei sind für gewöhnlich eine oder mehrere C-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 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 C-Headerdatei importieren. Wenn Sie beim Import das Befehlszeilendienstprogramm verwenden, können Sie mit jedem Importvorgang mehrere C-Headerdateien importieren.

Wenn Ihre C-Headerdatei zur erfolgreichen Kompilierung weitere Header-Dateien benötigt, müssen Sie diese zur Verfügung stellen und ihren Speicherort angeben, da die Kompilierung Ihrer Header-Datei 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.

Physische Informationen

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 C-Strukturen, die Sie importiert haben, in einer TDS-Nachricht angezeigt werden sollten.

Wenn das physische TDS-Format nicht auf Ihre C-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.

Befehlszeilenaufruf

Das Befehlszeilendienstprogramm mqsicreatemsgdefs ermöglicht Ihnen, mehrere C-Headerdateien mit einem einzigen Vorgang zu importieren. Alle C-Headerdateien müssen sich in einem Verzeichnis befinden, und die Verzeichnisposition muss als Parameter an das Dienstprogramm übergeben worden sein.

Sie geben die erforderlichen umgebungsspezifischen Information an und schließen die Angaben zum Speicherort der Datei mit Hilfe einer XML-Datei mit ein. Diese muss ein XML-Element namens <C> enthalten. In diesem Element befindet sich eine Reihe von Informationen, die für alle C-Headerdateien gelten, die beim Aufruf des Dienstprogramms importiert wurden. Eine XML-Standarddatei namens mqsicreatemsgdefs.xml steht zur Verfügung. Wenn Sie verschiedene Informationen auf verschiedene Header-Dateien 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, dass diese neue 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.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ad00831_