ws2ls コマンド

Web サービスプロバイダーとして CICS アプリケーションを公開するか、Web サービスリクエスターをコンストラクトします。Web サービス記述ファイル (WSDL) から COBOL データ構造体、スケルトン COBOL プログラム、Web サービスバインド (WSBIND) ファイルを生成します。

注意：この機能は、早期採用者製品 (Early Adopter Product; EAP) リリースステータスに提供されます。機能の最終版については、今後リリースする予定です。詳細については、Micro Focus SupportLine までお問い合わせください。

CICS Web サービス機能は、開発およびテストでの使用を目的とした早期採用者製品 (Early Adopter Product; EAP) です。本製品リリースでは、この機能は製品のディプロイ用には推奨されません。

重要：CICS Web Services 機能を使用するための前提条件として、先に IBM CCSID 変換テーブルをインストールして構成する必要があります。手順については、「CCSID 変換テーブルのインストールおよび構成」を参照してください。

構文：

ws2ls pgmname=program-name
      wsdl=wsdl-file
      wsbind=bind-file
     [reqmem=request-prefix]
     [respmem=response-prefix]
     [pgmint={channel|commarea}]
     [uri=address]
     [contid=container-name]
     [default-char-maxlength=max-length
     [inline-maxoccurs-limit=max-occurs

ws2ls -help

パラメーター：

program-name: 生成されたスケルトン CICS プログラムに使用する、完全修飾ファイル名です。他の与えられたパラメーターに応じて、Web サービスを呼び出すため (リクエスター)、または Web サービスとして公開するため (プロバイダー)、このスケルトンプログラムが生成されます。
wsdl-file: Web サービス記述を含む WSDL ファイルの完全修飾名。
bind-file: Web サービスバインドファイルの完全修飾名。
request-prefix: リクエスター Web サービス用に生成されたコピーブックファイルの命名に使用される、1 ～ 6 文字のプレフィックスを指定します。一意の名前が付けられたコピーブックファイルを作成するため、一意の 2 桁の数字がこのプレフィックスに付与されます。生成された各コピーブックファイルには、与えられた WSDL ファイルで定義された 1 つの操作用の要求データ構造体が含まれます。
response-prefix: プロバイダー Web サービス用に生成されたコピーブックファイルの命名に使用される、1 ～ 6 文字のプレフィックスを指定します。コピーブックファイル名を作成するため、一意の 2 桁の数字がこのプレフィックスに付与されます。生成されたコピーブックファイルには、Web サービス応答データ構造体が含まれます。
チャネル: チャネルコンテナーを介して、対象アプリケーションプログラムにデータを渡すサービスプロバイダーを作成します。
注：Web サービスリクエスターのコンストラクト時には、pgmintパラメーターを指定することはできません。
commarea: commarea を介して、対象アプリケーションにデータを渡すサービスプロバイダーを作成します。
注：Web サービスリクエスターのコンストラクト時には、pgmintパラメーターを指定することはできません。
address: Web サービスプロバイダーに対して、Web サービスにアクセスする a によって使用される関連 URI を指定します。Web サービスリクエスターに対して、生成されたスケルトンプログラム内の EXEC CICS INVOKE SERVICE コールで使用される絶対 URI を指定します。リクエスター Web サービスに対して URI が与えられていない場合、EXEC CICS INVOKE SERVICE コールは WSDL ファイルにあるサービスエンドポイントアドレスを使用します。
container-name: SOAP メッセージを表すために使用される、トップレベルのデータ構造を保持するコンテナーの名前。指定されなかった場合、デフォルトで DFHWS-DATA に設定されます。Web サービスプロバイダーの生成時にのみ使用されます。
max-length: WSDL ファイルで指定されていない場合に、バインドされていない文字列に使用するデフォルト文字列サイズです。
max-occurs: バインドされていない配列に使用するデフォルトの配列サイズです。
-help: ws2ls パラメーターに関する情報を表示します。

例：

例 1

以下のコマンドは、mywsdl.wsdl WSDL ファイルを使用して、program.cbl スケルトン COBOL プログラムと mywsbind.wsbind Web サービスバインドファイルを作成します。

ws2ls wsdl=mywsdl.wsdl
      pgmname=program.cbl 
      wsbind=mywsbind.wsbind 
      pgmint=channel 
      reqmem=REQ 
      respmem=RESP

例 2

以下のコマンドは、mywsdl.wsdl WSDL ファイルと /mysvc/operation URI を使用して、mywsbind.wsbind Web サービスバインドファイル、適切な要求および応答コピーブックファイル、commarea インターフェイスを使用して要求を受け取り応答を返す program.cbl スケルトン COBOL プログラムを作成します。

ws2ls wsdl=mywsdl.wsdl
		    pgmname=program.cbl
		    wsbind=mywsbind.wsbind
		    reqmem=REQ
		    respmem=RESP
		    uri=/mysvc/operation
		    pgmint=commarea