Befehl "createSIBWSInboundService"
Verwenden Sie den Befehl createSIBWSInboundService, um eine neue Servicekonfiguration für eingehende Daten für SIB-fähige Web-Services zu erstellen.
Sie können eine neue Servicekonfiguration für eingehende Daten, wie in diesem Artikel beschrieben, mit dem Tool "wsadmin" erstellen, oder Sie können, wie im Artikel Einen internen Service als Web-Service bereitstellen beschrieben, die Administrationskonsole verwenden.
Verwenden Sie zum Ausführen des Befehls das Objekt AdminTask des Scripting-Clients wsadmin.
Der Scripting-Client wsadmin wird über die Qshell ausgeführt.
Weitere Informationen finden Sie unter Qshell für die Ausführung von WebSphere-Scripts mit wsadmin-Scripting konfigurieren.
- Geben Sie den folgenden Befehl an der wsadmin-Eingabeaufforderung ein, um eine Liste der verfügbaren Befehle für busfähige Web-Services und eine Kurzbeschreibung jedes einzelnen Befehls
anzuzeigen:
print AdminTask.help('SIBWebServices')
- Zum Anzeigen einer übersichtlichen Hilfe zu einem bestimmten Befehl geben Sie an der
wsadmin-Eingabeaufforderung den folgenden Befehl ein:
print AdminTask.help('Befehlsname')
AdminConfig.save()
Zweck
Dieser Befehl erstellt ein neues InboundService-Objekt für einen Protokollanhang, der von den Serviceanforderern verwendet werden soll. Wenn Sie diesen Befehl ausführen, geben Sie ein einzelnes Serviceelement in einem WSDL-Schablonendokument und ein vorhandenes Serviceziel an.
Zielobjekt
ObjectName des Service Integration Bus, in dem der Service erstellt wird.
Wenn die WSDL über einen Proxy-Server abgerufen wird, muss der Server, in dem der Befehl ausgeführt wird, die Systemeigenschaften besitzen, die den Proxy-Server ordnungsgemäß angeben. Falls der Proxy-Server eine Authentifizierung erfordern, können die Benutzer-ID und das Kennwort als Parameter mit dem Befehl angegeben werden.
Nach der Ausführung dieses Befehls können Sei den Service mit anderen Befehlen konfigurieren. Beispielsweise können Sie einen Port für eingehende Daten hinzufügen.
Erforderliche Parameter
- -name
- Der Name des Service für eingehende Daten. Er darf nicht länger als 250 Zeichen sein.
- -destination
- Der Name des Serviceziels. Wenn das angegebene Ziel nicht vorhanden ist, schlägt der Befehl fehl.
- -wsdlLocation
- Die Position der WSDL-Schablonendatei.
Dies ist entweder eine Webadresse oder der servicespezifische Teil eines UDDI-Serviceschlüssels. Wenn Sie eine UDDI-Referenz angeben, wird angenommen, dass es sich bei der WSDL-Position um einen UDDI-Serviceschlüssel handelt.
Es folgt ein Beispiel für einen vollständigen UDDI-Serviceschlüssel:
Der servicespezifische Teil dieses Schlüssels ist der letzte Teil:uddi:blade108node01cell:blade108node01:server1:default:6e3d106e-5394-44e3-be17-aca728ac1791
6e3d106e-5394-44e3-be17-aca728ac1791
Vorgegebene Parameter
- -wsdlServiceName
- Der Name des Service in der WSDL-Schablone. Dieser Parameter muss nur angegeben werden, wenn die WSDL-Schablone mehrere Services enthält oder die WSDL mit einer UDDI-Registry gesucht wird.
- -wsdlServiceNamespace
- Der Namespace des Service im WSDL-Dokument. Dieser Parameter muss nur angegeben werden, wenn die WSDL-Schablone mehrere Services enthält oder die WSDL mit einer UDDI-Registry gesucht wird oder der Service nicht im Standard-Namespace für das WSDL-Dokument enthalten ist.
Optionale Parameter
- -uddiReference
- Wenn Sie einen UDDI-Serviceschlüssel als Position der WSDL-Schablone angegeben haben, müssen Sie die UDDI-Referenz für die UDDI-Zielregistry angeben.
- -userId
- Die Benutzer-ID für das Abrufen der WSDL.
- -password
- Das Kennwort für das Abrufen der WSDL.
Beispiel
- Mit Jython:
inService = AdminTask.createSIBWSInboundService(bus, ["-name", "MyService", "-destination", "destName", "-wsdlLocation", "http://myserver.com/MyService.wsdl"] )
- Mit Jacl:
set inService [$AdminTask createSIBWSInboundService $bus {-name "MyService" -destination $destName -wsdlLocation "http://myserver.com/MyService.wsdl"}]