Befehl 'mqsicreatemsgdefsfromwsdl'

Unterstützte Plattformen

  • Windows
  • Linux (x86-Plattform)

Zweck

Mit dem Befehl mqsicreatemsgdefsfromwsdl können Sie eine einzelne WSDL-Definition importieren. Ist die WSDL-Definition in mehrere Dateien aufgeteilt, muss die angegebene Datei die WSDL-Servicedefinition oder -Bindungsdefinition enthalten. Das WS-I-Prüfprogramm kann mit Hilfe des Attributs '-vfa' automatisch für die importierte WSDL-Definition ausgeführt werden.

Anmerkung:
  1. Stellen Sie sicher, dass nur die für die zu importierende WSDL-Definition erforderlichen Dateien in der angegebenen Verzeichnis- bzw. Unterverzeichnisstruktur ausgeführt werden. Bei der Ausführung des Befehls mqsicreatemsgdefsfromwsdl werden unter anderem alle Dateien im Verzeichnis und in den Unterverzeichnissen vor der Erstellung der Nachrichtendefinition in den Arbeitsbereich kopiert. Dazu gehören Dateien, die nicht dieser WSDL-Definition zugeordnet sind.
  2. Wenn die WSDL-Definition einen relativen Pfad mit Dateien, die sich nicht in der angegebenen Verzeichnis- bzw. Unterverzeichnis-Struktur befinden, verwendet, müssen diese Dateien vor Ausführung des Befehls in den Arbeitsbereich importiert werden. Stellen Sie sicher, dass die relativen Pfade nach dem Import dieser Dateien in den Arbeitsbereich immer noch Gültigkeit haben.
  3. Die Nachrichtengruppen, die erstellt werden, sind für den Namensbereich aktiviert.
  4. Bestehende Nachrichtengruppen müssen für Namespaces aktiviert sein und ein physisches XML-Format haben.
  5. Wenn Sie eine neue Nachrichtengruppe für die Laufzeit-Syntaxanalyse erstellen, sollte sie auf einer bereits vorhandenen Nachrichtengruppe mit einem physischen XML-Format basieren.

Syntax

Parameter

-base <ProjektnameBasisnachrichtengruppe>\<NameBasisnachrichtengruppe>
(Optional) Wenn eine neue Nachrichtengruppe erstellt werden soll, ist dies das vorhandene Nachrichtengruppenprojekt und die Nachrichtengruppe, auf dem bzw. auf der die neue Nachrichtengruppe basiert.
-binding <Bindung>
(Optional) Der Name der zu importierenden Bindung. Dieser Parameter ist verbindlich, wenn die WSDL-Definition mehr als eine Bindung enthält, jedoch ist sie optional, wenn die WSDL-Definition lediglich eine Bindung enthält.
-d Pfadname des Quellendateiordners
(Erforderlich) Der absolute oder relative Pfadname des Verzeichnisses, in dem sich die WSDL-Datei der höchsten Ebene befindet. Diese übergeordnete WSDL-Datei kann die gesamte WSDL-Definition enthalten oder die höchste Ebene in einer Hierarchie von Dateien darstellen, von denen jede über Importelemente weitere Dateien importieren kann. Ein Importelement gibt über ein entsprechendes Attribut das Verzeichnis der Ressource an, die importiert werden soll.

Das Importprogramm versucht, alle relativen Importpfade mit Bezug auf das angegebene Verzeichnis aufzulösen. Es versucht außerdem, alle eventuell angegebenen absoluten Importpfade aufzulösen; allerdings sollten nach Möglichkeit keine absoluten Pfade verwendet werden. Wenn einmal ein absoluter Pfad angegeben wurde, müssen für alle weiteren Importe in die Hierarchie ebenfalls absolute Pfade angegebenen werden.

-data <Arbeitsbereichspfad>
(Erforderlich) Pfad zum Arbeitsbereich, in dem Ihre Projekte erstellt werden.

Die Position des Arbeitsbereichs ist auch die Standardposition für Projekte. Relative Pfade werden als relativ zu dem Verzeichnis interpretiert, in dem der Befehl gestartet wurde.

-f Name der WSDL-Datei der höchsten Ebene für die WSDL-Definition.
(Erforderlich) Der Name der WSDL-Datei der höchsten Ebene, die importiert werden soll.

Ist für die Identifizierung des Dateinamens ein Pfad erforderlich, muss der Pfad über den Parameter -d angegeben werden.

-log Pfadname der Berichtsdatei
(Optional) Absoluter oder relativer Pfadname der Berichtsdatei. Erfolgt keine Angabe, wird der Bericht in die Standardprotokolldatei <wsdl-Dateiname>.wsdl.report.txt geschrieben (wobei <WSDL-Dateiname> der Name der WSDL-Definition ist, die Sie importieren) und in dem Verzeichnis gespeichert, in dem der Befehl ausgegeben wurde.
-p Name des Nachrichtengruppenprojekts
(Erforderlich) Name des Nachrichtengruppenprojekts. Ist das Projekt vorhanden, muss es für den Namensbereich aktiviert sein. Ist das Projekt nicht vorhanden, muss ein neues für den Namensbereich aktiviertes Projekt erstellt werden.
-rmd
(Optional) Ersetzt eine vorhandene Nachrichtendefinitionsdatei desselben Namens.
Anmerkung:
  1. Wird diese Option nicht angegeben und ist eine Nachrichtendefinitionsdatei desselben Namens vorhanden, wird eine Warnung ausgegeben.
  2. Der Standort der generierten Nachrichtendefinitionsdatei in der Nachrichtengruppe wird durch den Zielnamensbereich bestimmt.
-rmp
(Optional) Ersetzt das vorhandene Projekt mit demselben Namen.
-v
(Optional) Ausführlicher Bericht.
-vfa
(Optional) Aktion, wenn das Prüfprogramm fehlschlägt. Gibt die erforderliche Aktion an, wenn bei der WS-I-Konformitätsprüfung ein Fehler in der WSDL-Datei festgestellt wird, die importiert werden soll. Der Standardwert ist 'fail' (fehlschlagen). Zur Auswahl stehen:
  • fail: Wenn die WSDL-Definition nicht WS-I-konform ist, wird der Importprozess gestoppt und Fehler werden in die Protokolldatei geschrieben.
  • warn: Wenn die WSDL-Definition nicht WS-I-konform ist, werden vom Importprozess Warnungen in die Protokolldatei geschrieben.
  • ignore: Wenn die WSDL-Definition nicht WS-I-konform ist, werden sie vom Importprozess ignoriert und Informationsnachrichten darüber, wie diese WSDL-Definition nicht mit dem WS-I-Profil übereinstimmt ist, werden in die Protokolldatei geschrieben.

Beispiele

Im folgenden Beispiel soll das WSDL-Dokument 'service.wsdl' aus dem Verzeichnis wsdlfiles in das Projekt 'meinProjekt' importiert werden und das Projekt überschreiben, falls es bereits vorhanden ist.

mqsicreatemsgdefsfromwsdl  -p meinProjekt -d .\wsdlfiles -f service.wsdl -rmd -data .\wsdlfilewspc

Im folgenden Beispiel soll das WSDL-Dokument 'service.wsdl' aus dem Verzeichnis wsdlfiles importiert werden, um ein neues Nachrichtengruppenprojekt ('neuesProj') auf der Grundlage eines bereits vorhandenen Projekts ('bestehendesProj')zu erstellen.

mqsicreatemsgdefsfromwsdl  -p neuesProj -base bestehendesProj -d .\wsdlfiles -f service.wsdl -data .\wsdlfilewspc
Zugehörige Konzepte
Nachrichtendefinitionsdateien
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
an07355_