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 クライアント・サービスの資料を参照してください。
手順
- server.xml 構成に、各サービスの zosConnectService 構成エレメントを追加します。 少なくとも serviceRef 属性と serviceName 属性の構成が必要です。
serviceRef エレメントは、サービス・プロバイダーの構成エレメントを指します。
serviceName 属性を使用して、サービス・プロバイダーは z/OS Connect で識別され、
また、その名前が、特定サービスをターゲットにした z/OS Connect 要求の URL の一部として使用されます。
サービス名は固有である必要があります。
以下は、z/OS Connect サービス recordOpsCreate の追加に必要な内容を示したサンプルの
server.xml ファイルです。
zosConnectService エレメントに関連する構成可能な属性定義について詳しくは、z/OS Connect フィーチャーの資料を参照してください。<!-- z/OS Connect service definitions --> <zosConnectService id="zcs1" serviceName="recordOpsCreate" serviceRef="wolaCreateService"/> - (オプション) 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 フィーチャーの資料を参照してください。 - 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 2016http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_zconnect_srvcdef
ファイル名: twlp_zconnect_srvcdef.html
