z/OS Connect サービスの定義

z/OS® Connect サービス定義では、REST 呼び出しを使用して z/OS アプリケーション・アセットに到達するための手段が用意されています。 z/OS Connect サービスを使用可能にするには、Liberty の server.xml ファイルに、エレメント名 zosConnectService に名前とサービス・プロバイダー参照エレメント名を指定して、z/OS Connect サービス定義を追加する必要があります。

このタスクについて

z/OS Connect サービスは、zosConnectService 構成エレメントで定義されます。 このエレメントの属性定義には、対応するグローバル定義がある場合があります。 属性は、zosConnectManager エレメントでグローバルに定義できます。 これらの属性が定義された場合は、すべてのサービスに適用されます。 グローバル・レベルとサービス・レベルの属性が両方構成された場合は、 zosConnectService レベルで定義された値が使用されます。

z/OS Connect では、 z/OS Connect 要求が WebSphere 最適化ローカル・アダプター (WOLA) を通して z/OS アセットと対話可能なサービス実装が提供されています。 zosConnect-1.0 と zosLocalAdapters-1.0 の両方のフィーチャーが構成されると、 このサービスは自動的に使用可能になります。このサービスのインスタンスは、 localAdaptersConnectService 構成エレメントにより定義できます。

z/OS Connect では、z/OS Connect 要求がリモート REST エンドポイントに接続することを可能にするサービス実装も提供されています。このサービスは、zosConnect-1.2 フィーチャーが構成されている場合使用可能です。このサービスのインスタンスは、zosConnectServiceRestClient 構成エレメントにより定義できます。詳細情報については、z/OS Connect REST クライアント・サービスの資料を参照してください。

手順

  1. server.xml 構成に、各サービスの zosConnectService 構成エレメントを追加します。 少なくとも serviceRef 属性と serviceName 属性の構成が必要です。 serviceRef エレメントは、サービス・プロバイダーの構成エレメントを指します。 serviceName 属性を使用して、サービス・プロバイダーは z/OS Connect で識別され、 また、その名前が、特定サービスをターゲットにした z/OS Connect 要求の URL の一部として使用されます。 サービス名は固有である必要があります。 以下は、z/OS Connect サービス recordOpsCreate の追加に必要な内容を示したサンプルの server.xml ファイルです。
    <!-- z/OS Connect service definitions --> 
    <zosConnectService id="zcs1"  
    	serviceName="recordOpsCreate"  
    	serviceRef="wolaCreateService"/> 
    zosConnectService エレメントに関連する構成可能な属性定義について詳しくは、z/OS Connect フィーチャーの資料を参照してください。
  2. (オプション) server.xml ファイルに zosConnectManager 構成エレメントを追加します。

    このエレメントは、server.xml 構成内の singleton で、 サーバーに定義されたすべての z/OS Connect サービスに適用されるグローバル値を含みます。 このエレメントは、サーバー内のすべてのサービスに適用される z/OS Connect インターセプターまたはデータ変換プロバイダー構成エレメントの名前を含むことができます。

    以下の例では、項目 globalOperationsGroup で操作グループ名 Operator1 を定義する zosConnectManager 構成エレメントを記述しています。 これは、z/OS Connect 操作要求 (action=start|stop|status など) が許可される前に要求側クライアント・ユーザー ID が属する必要があるセキュリティー (SAF または LDAP) グループの名前です。 このグループは、z/OS Connect 構成内のすべてのサービスに適用されます。 項目 dataxform は、z/OS Connect がデータ変換プロバイダーを検索するエレメント名を定義します。 zosConnect エレメントの dataxform を指定すると、これが、構成内で独自のデータ変換エレメント参照がないすべてのサービスの変換プロバイダー実装であることになります。 interceptors の項目は、構成内の全サービスに適用される z/OS Connect インターセプターのセットを記述した、 構成内のエレメントの名前です。

    <zosConnectManager id="zosConnectGlobals"  
    	globalOperationsGroup="Operator1"  
    	globalDataxformRef="XformJSON2Byte"  
    	globalInterceptorsRef="GlobalInterceptors"/> 

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

    各属性について詳しくは、Liberty フィーチャーの資料を参照してください。
  3. Liberty で WOLA が構成された場合、要求の構成で server.xml ファイルに localAdaptersConnectService 構成エレメントが必要です。 この構成は、最低限、ターゲット WOLA 接続ファクトリー名、登録名、およびサービス名から構成されます。 z/OS Connect の構成は、最小限のパラメーターの指定だけを必要として、Liberty の規則に従います。z/OS Connect の対話に WOLA 接続ファクトリーを構成する場合、認証メカニズムとしてコンテナーを使用する必要があります。 containerAuthDataRef 属性の指定がない WOLA 接続ファクトリーはサポートされません。 以下に例を示します。
    <!-- Local adapters connection factory definition --> 
    <authData id="cauth1" user="user1" password="{xor}LDo8Ki02KyY="/> 
    <connectionFactory id="wolaCF" jndiName="eis/ola"        
    	containerAuthDataRef="cauth1"  >       
    	<properties.ola/> 
    </connectionFactory>     
    
    <!-- Local adapters config --> 
    <zosLocalAdapters wolaGroup="LIBERTY" wolaName2="LIBERTY"         
    	wolaName3="LIBERTY" /> 
    
    <!-- WOLA Connect service and z/OS Connect service definitions --> 
    <localAdaptersConnectService id="wolaOpsCreate"             
    	registerName="BATCH01"   
    	serviceName="COBLPGM1"   
    	connectionFactoryRef="wolaCF"/> 
    
    <zosConnectService id="zcs1" serviceName="recordOpsCreate"    
    	serviceRef="wolaOpsCreate"   
    	runGlobalInterceptors="true"    
    	interceptorsRef="serviceInterceptorList"/> 

    z/OS Connect 要求が WebSphere 最適化ローカル・アダプター (WOLA) を通して z/OS アセットと対話可能な z/OS Connect サービス実装には、 データ変換プログラムが必要な場合があります。 グローバルでもサービス・レベルでもデータ変換プログラムが構成された場合、 入出力のペイロードは、構成されたデータ変換プログラムを使用して変換されます。 データ変換プログラムが構成されず、要求に JSON ペイロードが含まれる場合、 サービスは、バックエンド・プログラムがデータ変換を処理することを想定します。 サービスは、要求ヘッダーに指定されたエンコード、またはデフォルト JSON エンコードの UTF-8 を使用して、現状の JSON ペイロードをバイト配列に変換します。 同様に、アセットがペイロードを戻し、データ変換プログラムが構成されていない場合、 WOLA サービス実装は、JSON ペイロードをバイト配列形式で受け取ることを予期します。 これは、JSON 要求ペイロードをバイト配列に変換するために使用されるものと同じエンコード・ルールに従って JSON 応答ペイロードに変換されます。

    WOLA サービス・プロバイダー実装は、 複数の他の WOLA 接続ファクトリー定義がその localAdaptersConnectService 構成エレメントで指定されることを許可します。 次の表に、localAdaptersConnectService 属性定義とそれぞれの説明をリストします。

    属性定義 説明

    serviceName

    required="true"

    type="String"

    WOLA ターゲット・サービスの名前。 このサービス名は、外部アドレス・スペースのアプリケーションが WOLA 要求受信またはホスト・サービス API 呼び出しでサービス名に使用する名前、 または WOLA CICS リンク・サーバーでの SVC に使用されるプログラム名に一致する必要があります。

    registerName

    required="true"

    type="String"

    WOLA ターゲット登録の名前。 このターゲット登録は、外部アドレス・スペースのアプリケーションが WOLA 登録 API 呼び出しで登録名に使用する名前、 または WOLA CICS リンク・サーバーでの RGN に使用される名前に一致する必要があります。

    connectionFactoryRef

    required="true"

    type="String"

    使用される WOLA リソース・アダプター接続ファクトリーの JNDI 名が含まれている接続ファクトリー・エレメントの名前。 詳しくは、Liberty WOLA リソース・アダプターの資料を参照してください。

    connectionWaitTimeout

    required="false"

    type="Integer"

    min="0"

    max="2147483647"

    登録名に一致する外部アドレス・スペース・アプリケーションが、WOLA 要求受信またはホスト・サービス API を発行してアクティブになるのを待機する秒数。 詳しくは、Liberty WOLA リソース・アダプターの資料を参照してください。

    linkTaskTranID

    required="false"

    type="String"

    WOLA CICS リンク・サーバーのリンク起動タスクのトランザクション ID の名前を指定します。 詳しくは、Liberty WOLA リソース・アダプターの資料を参照してください。

    useCICSContainer

    required="false"

    type="Boolean"

    default="false"

    WOLA CICS リンク・サーバーの使用時に、ペイロードがターゲット CICS アプリケーション・プログラムに単一の CICS コンテナーで渡されるか、 COMMAREA で渡されるかを示します。 詳しくは、Liberty WOLA リソース・アダプターの資料を参照してください。

    linkTaskTranID

    required="false"

    type="String"

    WOLA CICS リンク・サーバーを使用し、useCICSContainer フラグが true に設定されている場合に、ターゲット CICS 要求コンテナーの名前を指定します。 詳しくは、Liberty WOLA リソース・アダプターの資料を参照してください。

    linkTaskReqContType

    type="Integer"

    min="0"

    default="0"

    WOLA CICS リンク・サーバーを使用し、useCICSContainer フラグが true に設定されている場合に、ターゲット CICS 要求コンテナーのタイプを指定します (0=CHAR、1=BIT)。 詳しくは、Liberty WOLA リソース・アダプターの資料を参照してください。

    linkTaskRspContID

    required="false"

    type="String"

    WOLA CICS リンク・サーバーを使用し、useCICSContainer フラグが true に設定されている場合に、ターゲット CICS 応答コンテナーの名前を指定します。 詳しくは、Liberty WOLA リソース・アダプターの資料を参照してください。

    linkTaskRspContType

    type="Integer"

    min="0"

    default="0"

    WOLA CICS リンク・サーバーを使用し、useCICSContainer フラグが true に設定されている場合に、ターゲット CICS 応答コンテナーのタイプを指定します (0=CHAR、1=BIT)。 詳しくは、Liberty WOLA リソース・アダプターの資料を参照してください。

    linkTaskChanID

    required="false"

    type="String"

    WOLA CICS リンク・サーバーの使用時に、CICS コンテナーを使用したメッセージ送信と応答メッセージ受信に使用する CICS チャネル名を指定します。 詳しくは、Liberty WOLA リソース・アダプターの資料を参照してください。

    linkTaskChanType

    required="false"

    type="Integer"

    min="0"

    default="0"

    WOLA CICS リンク・サーバーを使用し、linkTaskChanID のチャネル名を指定する場合に、 そのチャネルに関連付けられたターゲット CICS コンテナーのタイプを指定します (0=CHAR、1=BIT)。 詳しくは、Liberty WOLA リソース・アダプターの資料を参照してください。

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



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