createSIBWSOutboundService コマンド
createSIBWSOutboundService コマンドを使用して、サービス統合バス対応 Web サービス構成を新規作成します。
このトピックで説明されているように wsadmin ツールを使用するか、外部でホスティングされている Web サービスを内部で使用可能にするで説明されているように管理コンソールを使用して、 新しいアウトバウンド・サービス構成を作成することができます。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは Qshell から実行されます。.
詳しくは、wsadmin スクリプトを使用した WebSphere スクリプトを実行するための Qshell の構成.
- 使用可能なバス対応 Web サービス・コマンドのリストと、各コマンドの簡単な説明を見るには、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('SIBWebServices')
- 特定のコマンドの概要ヘルプの場合は、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('command_name')
AdminConfig.save()
目的
このコマンドは、サービス・プロバイダーが使用するプロトコル接続を表す新規 OutboundService オブジェクトを作成します。このコマンドを実行する場合、WSDL 文書内の単一サービス・エレメントを識別します。
ターゲット・オブジェクト
その内部にサービスが作成されるメッセージング・バスの ObjectName。
WSDL をプロキシーから取得する場合は、このコマンドが実行されるサーバーに、 プロキシー・サーバー・セットを正しく識別するシステム・プロパティーがなければなりません。 プロキシーが認証を要求する場合、ユーザー ID とパスワードをコマンドにパラメーターとしてセットします。
このコマンドを実行した後、他のコマンドを使用してサービスをさらに構成します。例えば、アウトバウンド・ポートを追加する場合。
必須パラメーター
- -name
- アウトバウンド・サービス名。
- -wsdlLocation
- サービス・プロバイダー WSDL ファイルのロケーション。
これは Web アドレスまたは UDDI サービス・キーのサービス固有部分のいずれかになります。UDDI 参照を指定する場合、WSDL ロケーションは UDDI サービス・キーとして想定されます。
フル UDDI サービス・キーは、例えば次のような形式になっています。
このキーのサービス固有部分は、次の最終部分です。uddi:blade108node01cell:blade108node01:server1:default:6e3d106e-5394-44e3-be17-aca728ac1791
6e3d106e-5394-44e3-be17-aca728ac1791
条件付きパラメーター
- -wsdlServiceName
- WSDL 内のサービスの名前。サービス・プロバイダー WSDL に複数の名前が含まれている場合、または WSDL が UDDI レジストリーを介して位置指定される場合にのみ必要です。
- -wsdlServiceNamespace
- WSDL 内のサービスの名前空間。サービス・プロバイダー WSDL に複数のサービスが 含まれている場合、または UDDI レジストリーを介して WSDL を位置指定した場合、あるいはサービスが WSDL 文書のデフォルトの名前空間にない場合にのみ必要です。
オプション・パラメーター
- -uddiReference
- UDDI サービス・キーを WSDL ロケーションとして指定した場合は、ターゲット UDDI レジストリーの UDDI 参照を指定します。
- -destination
- サービス宛先の名前。注: このコマンドはサービス宛先を作成します。指定した名前またはデフォルトの名前を持つ宛先が存在している場合、コマンドは失敗します。
- -userId
- WSDL を取得するために使用するユーザー ID。
- -password
- WSDL を取得するために使用するパスワード。
例
- Jython の使用:
outService = AdminTask.createSIBWSOutboundService(bus, ["-name", "MyService", "-wsdlLocation", "http://myserver.com/MyService.wsdl"])
- Jacl を使用:
set outService [$AdminTask createSIBWSOutboundService $bus {-name "MyService" -wsdlLocation "http://myserver.com/MyService.wsdl"}]