ls2ws コマンド

Web サービス記述 (WSDL) ファイルと Web サービスバインド (WSBIND) ファイルを生成して、Web サービスとして CICS アプリケーションプログラムを公開します。

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

CICS Web サービス機能は、開発およびテスト用の EAP です。この製品リリースの本番環境には使用しないでください。

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

構文：

ls2ws pgmint={channel|commarea}
      pgmname=program-name
      uri=address
      wsbind=bind-file
      wsdl=wsdl-file
      reqmem=request-copy-file
     [respmem=response-copy-file]
     [operation-name=operation-name]
     [wsdl-namespace=wsdl-namespace]
     [contid=container-name]
     [ccsid=ccsid]
     [synconreturn={yes|no}]
     [data-truncation={enabled|disabled}] 
     [datetime={unused|packed15}]

ls2ws -help

パラメーター：

pgmint={channel|commarea}

channel: チャネルコンテナーを介してデータを渡します。
commarea: commarea を介してデータを渡します。

pgmname=program-name

Web サービスとして公開する対象アプリケーションプログラムの名前。

uri=address

Web サービスへのアクセスにクライアントが使用する相対または絶対 URI。

wsbind=bind-file

Web サービスバインドファイルの完全修飾名。

wsdl=wsdl-file

Web サービス記述を含む WSDL ファイルの完全修飾名。

reqmem=request-copy-file

Web サービス要求の高水準言語構造体を含むコピーブックファイルの完全修飾名。

respmem=response-copy-file

Web サービス応答の高水準言語構造体を含むコピーブックファイルの完全修飾名。

operation-name=operation-name

生成された WSDL ファイルで使用されるオペレーション名。指定されなかった場合、デフォルトで program-name にリテラル値 Operation を追加した値に設定されます。

wsdl-namespace=wsdl-namespace

生成された WSDL ファイルで使用される CICS 名前空間。指定されなかった場合、デフォルトで http://www.pgmname.com に設定されます。

contid=container-name

SOAP メッセージを表すために使用される、トップレベルのデータ構造を保持するコンテナーの名前。指定されなかった場合、デフォルトで DFHWS-DATA に設定されます。

ccsid=ccsid

実行時に文字データをアプリケーションデータ構造体にエンコードするために使用する CCSID です。

synconreturn={yes|no}

yes: リモートサービスは同期ポイントを発行できます。
no: リモートサービスは同期ポイントを発行できません。

data-truncation={enabled|disabled}

enabled: 固定長フィールド構造体で可変長データが許容されます。
disabled: 固定長フィールド構造体で可変長データが許容されません。

datetime={unused|packed15}

unused: データ構造体内の長さ 15 (8 バイト) のパック 10 進数フィールドは使用されません。
packed15: データ構造体内の長さ 15 (8 バイト) のパック 10 進数フィールドは、CICS ABSTIME フィールドとして扱われ、タイムスタンプとしてマップされます。

-help

ls2ws パラメーターに関する情報を表示します。

例：

例 1

以下のコマンドは、incpy.cpy 要求コピーブックと outcpy.cpy 応答コピーブックを使用して comml1 CICS プログラムと通信し、mywsdl.wsdl WSDL ファイルと mywsbind.wsbind Web サービスバインドファイルを生成します。

ls2ws pgmname=comml1 
      pgmint=channel 
      reqmem=incpy.cpy 
      respmem=outcpy.cpy 
      wsdl=mywsdl.wsdl 
      wsbind=mywsbind.wsbind 
      uri=/mysvc/operation

例 2

以下のコマンドは、set1.cpy 要求コピーブックを使用して set1 CICS プログラムと通信し、それぞれ newOperation という名前の新たに定義された操作を含む、set1.wsdl WSDL ファイルと set1.wsbind Web サービスバインドファイルを生成します。

ls2ws pgmname=set1 
      pgmint=commarea 
      reqmem=set1.cpy 
      wsdl=set1.wsdl 
      wsbind=set1.wsbind 
      uri=/mysvc/operation 
      operation-name=newOperation