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. Verwendet die WSDL-Definition einen relativen Pfad, der Dateien außerhalb der angegebenen Verzeichnis- bzw. Unterverzeichnisstruktur umfasst, 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 Namespace 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

-p NameNachrichtengruppenprojekt
(Erforderlich) Name des Nachrichtengruppenprojekts. Ist das Projekt vorhanden, muss es für den Namespace aktiviert sein. Ist das Projekt nicht vorhanden, muss ein neues für den Namespace aktiviertes Projekt erstellt werden.
-base NameBasisnachrichtengruppenprojekt\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. außerdem versucht das Importprogramm, alle gefundenen absoluten Importpfade aufzulösen. Absolute Importpfade sollten jedoch nicht verwendet werden, da nach Angabe eines absoluten Pfades bei allen weiteren Importen in der Hierarchie absolute Pfade verwendet werden müssen.

-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>
(Erforderlich) Der Dateiname 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 PfadnameBerichtsdatei
(Optional) Der absolute oder relative Pfadname der Berichtsdatei; wird dieser nicht angegeben, wird der Bericht in die Standardprotokolldatei geschrieben und heißt dann <Name-der-WSDL-Datei>.wsdl.report.txt. <Name-der-WSDL-Datei> ist dabei der Name der zu importierenden WSDL-Definition und wird in dem Verzeichnis gespeichert, aus dem der Befehl aufgerufen wurde.
-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 Zielnamespace 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, 2007 Letzte Aktualisierung: Jan 24, 2008
an07355_