ws2ls コマンド

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

構文:

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