z/OS Connect メッセージ・ペイロード変換の定義

IBM® z/OS® Connect には、z/OS オペレーティング・システム上のビジネス・アセットの呼び出しに使用される要求および応答のペイロードをオプションで変換する機能があります。 z/OS Connect に含まれる com.ibm.wsspi.zos.connect.DataXform サービス・プロバイダー・インターフェース (SPI) を実装することで、特定のニーズを満たすメッセージ・ペイロード変換プログラムを作成することができます。

このタスクについて

要求および応答のメッセージ・フォーマットが JSON であることを要求する実装を z/OS Connect は提供します。 このフィーチャーは、ネイティブ言語の COBOL、PL/I、または C の構造によってマップ可能なバイト配列への要求の変換をサポートします。 ターゲット・プログラムのこの言語構造またはコピーブック (in パラメーターと out パラメーターの記述を含む) を使用して、z/OS Connect 提供のユーティリティーにより、バインディング・ファイルと、JSON 要求および応答スキーマ・ファイルを生成します。 z/OS Connect は、このユーティリティーで生成されるバインディング・ファイルを使用して、 要求が到着したときや応答が戻されるときに、JSON とネイティブ・データ形式の間で相互にデータ変換を行います。 要求および応答メッセージの JSON スキーマは、z/OS Connect 提供の REST API 呼び出しで取得できます。

z/OS Connect では、 特定サービスに適用される属性のセットを管理者が構成するための zosConnectService 構成エレメントが用意されています。 これらの属性の 1 つとして、dataXformRef があります。 これは、特定サービスに対して使用されるデータ変換構成を指します。 このタスクでは、z/OS Connect 提供のデータ変換プログラムを使用するように要求する方法について説明します。

手順

  1. z/OS Connect 提供のデータ変換を可能にする、server.xml 構成内の各サービスについて、 zosConnectService エレメントを更新します。
    <!-- z/OS Connect service definition --> 
    <zosConnectService id="zcs1" 
    	serviceName="recordOpsCreate" 
    	serviceRef="wolaOpsCreateService" 
    	dataXformRef="xformJSON2btye"/> 
  2. 関連する zosConnectDataXform エレメントを作成します。
    <!-- z/OS Connect data transformation provider --> 
    <zosConnectDataXform id="xformJSON2Byte" 
    		bindFileLoc="/u/bindfiles" bindFileSuffix=".bnd" 
    		requestSchemaLoc="/u/json" responseSchemaLoc="/u/json"
    		requestSchemaSuffix=".json" responseSchemaSuffix=".json"/>  

    zosConnectDataXform エレメントに関連する構成可能な属性定義について詳しくは、z/OS Connect フィーチャーの資料を参照してください。

  3. オプション: すべてのサービスに適用されるデータ変換プログラムを構成します。 zosConnectManager エレメントの globaDataXformRef をグローバル使用のための構成済みデータ変換プログラム ID に設定します。 グローバルとサービスの両方のデータ変換プログラムが定義され、 データ変換プログラムが構成されたサービスについて要求が着信した場合、 z/OS Connect は、そのサービス用に特に構成されたデータ変換プログラムを使用します。
    <zosConnectManager id="zosConnectGlobals" globalDataXformRef="globalDataXform"/>   
    
    <!-- z/OS Connect data transformation provider --> 
    <zosConnectDataXform id="globalDataXform" 
    		bindFileLoc="/u/bindfiles" bindFileSuffix=".bnd"         
    		requestSchemaLoc="/u/json" responseSchemaLoc="/u/json"
    		requestSchemaSuffix=".json" responseSchemaSuffix=".json"/>      
  4. オプション: pollingRate および updateTrigger などの設定を構成してモニタリング・アクションを微調整します。 デフォルトで、データ変換定義に関連付けられたディレクトリーは、新規ファイルおよびファイル更新についてモニターされます。これらの構成属性について詳しくは、 under zosConnect-1.0 および zosConnect 1.2 の下の zosConnectDataXform エレメント・セクションを参照してください。
      <zosConnectDataXform id="ibmDataXform2"        
    bindFileLoc="/zosConnect/banking/bind/" bindFileSuffix=".bnd"    
    requestSchemaLoc="/zosConnect/banking/reqSchema" requestSchemaSuffix=".json"    
    responseSchemaLoc="/zosConnect/banking/respSchema" responseSchemaSuffix=".json" pollingRate="500ms">    
    </zosConnectDataXform>

    この例では、500 ミリ秒ごとにファイル更新について /zosConnect/banking/bind,/zosConnect/banking/reqSchema ディレクトリーと /zosConnect/banking/respSchema ディレクトリーがポーリングされます。pollingRate 構成属性と updateTrigger 構成属性が構成されていない場合は、polled および 2 seconds のデフォルト値がそれぞれ使用されます。ファイルのモニタリングが必要ない場合は、updateTrigger 属性を disabled に設定することにより使用不可にできます。特定のファイルの手動最新表示をトリガーしたい場合は、updateTrigger属性を mbean に設定し、ファイル通知 mbean: com.ibm.ws.kernel.filemonitor.FileNotificationMBean を使用して更新をトリガーしてください。例えば、次のように指定します。

    String[] MBEAN_METHOD_SIGNATURE = new String[] {Collection.class.getName(),Collection.class.getName(),Collection.class.getName() };        
    JMXConnector jmxConnector = ...;        
    MBeanServerConnection mbsc = jmxConnector.getMBeanServerConnection();        
    ObjectName fileMonitorMBeanName = new ObjectName("WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean");        
    
    List<String> paths = new ArrayList<String>();        
    paths.add("/zosConnect/banking/bind/customer.bnd");        
    paths.add("/zosConnect/banking/reqSchema/customer_request.json");       
    paths.add("/zosConnect/banking/respSchema/customer_response.json");        
    
    Object[] params = new Object[] { null, paths, null };        
    mbsc.invoke(fileMonitorMBeanName, "notifyFileChanges", params, MBEAN_METHOD_SIGNATURE);

    この例では、restConnector-1.0 フィーチャーを使用して customer.bnd、customer_request.json、および customer_response.json の各ファイルの更新をトリガーしています。セキュア JMX 接続の作成方法について詳しくは、Liberty へのセキュア JMX 接続の構成の資料を参照してください。


トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_zconnect_msg_payload_conv
ファイル名: twlp_zconnect_msg_payload_conv.html