ws2ls コマンド

Web サービス プロバイダーとして CICS アプリケーションを公開するか、Web サービス リクエスターをコンストラクトします。Web サービス記述ファイル (WSDL) から COBOL データ構造体、スケルトン COBOL プログラム、Web サービス バインド (WSBIND) ファイルを生成します。
重要: この機能は、早期採用者製品 (Early Adopter Product; EAP) リリース ステータスに提供されます。機能の最終版については、今後リリースする予定です。詳細については、Micro FocusSupportLine までお問い合わせください。

CICS Web サービス機能は、開発およびテスト用の 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]
     [ccsid=ccsid]
     [synconreturn={yes|no}]
ws2ls -help

パラメーター:

pgmname=program-name
生成されたスケルトン CICS プログラムに使用する、完全修飾ファイル名です。他の与えられたパラメーターに応じて、Web サービスを呼び出すため (リクエスター)、または Web サービスとして公開するため (プロバイダー)、このスケルトン プログラムが生成されます。
wsdl=wsdl-file
Web サービス記述を含む WSDL ファイルの完全修飾名。
wsbind=bind-file
Web サービス バインド ファイルの完全修飾名。
reqmem=request-prefix
リクエスター Web サービス用に生成されたコピーブック ファイルの命名に使用される、1 ~ 6 文字のプレフィックスを指定します。一意の名前が付けられたコピーブック ファイルを作成するため、一意の 2 桁の数字がこのプレフィックスに付与されます。生成された各コピーブック ファイルには、与えられた WSDL ファイルで定義された 1 つの操作用の要求データ構造体が含まれます。
respmem=response-prefix
プロバイダー Web サービス用に生成されたコピーブック ファイルの命名に使用される、1 ~ 6 文字のプレフィックスを指定します。コピーブック ファイル名を作成するため、一意の 2 桁の数字がこのプレフィックスに付与されます。生成されたコピーブック ファイルには、Web サービス応答データ構造体が含まれます。
pgmint={channel|commarea}
channel
チャネル コンテナーを介して、対象アプリケーション プログラムにデータを渡すサービス プロバイダーを作成します。
注: Web サービス リクエスターのコンストラクト時に、pgmint パラメーターは指定しないでください。
commarea
commarea を介して、対象アプリケーションにデータを渡すサービス プロバイダーを作成します。
注: Web サービス リクエスターのコンストラクト時に、pgmint パラメーターは指定しないでください。
uri=address
Web サービス プロバイダーに対して、Web サービスにアクセスする a によって使用される関連 URI を指定します。Web サービス リクエスターに対して、生成されたスケルトン プログラム内の EXEC CICS INVOKE SERVICE コールで使用される絶対 URI を指定します。リクエスター Web サービスに対して URI が与えられていない場合、EXEC CICS INVOKE SERVICE コールは WSDL ファイルにあるサービス エンド ポイント アドレスを使用します。
contid=container-name
SOAP メッセージを表すために使用される、トップレベルのデータ構造を保持するコンテナーの名前。指定されなかった場合、デフォルトで DFHWS-DATA に設定されます。Web サービス プロバイダーの生成時にのみ使用されます。
default-char-maxlength=max-length
WSDL ファイルで指定されていない場合に、バインドされていない文字列に使用するデフォルト文字列サイズです。
inline-maxoccurs-limit=max-occurs
バインドされていない配列に使用するデフォルトの配列サイズです。インライン変数の繰り返しコンテンツが使用されるかどうかを示します。
ccsid=ccsid
実行時に文字データをアプリケーション データ構造体にエンコードするために使用する CCSID です。
synconreturn={yes|no}
yes
リモート サービスは同期ポイントを発行できます。
no
リモート サービスは同期ポイントを発行できません。
-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