Z Data Tools Service Provider のインストール z/OS®

Service Provider の機能は UNIX システム・サービスに抽出された後、WLP 内の z/OS Connect にインストールされ、ZCC server で構成されます。

始める前に

インストール手順は UNIX® システム・サービス環境で実行され、環境の前提条件は次のとおりです。

シェル環境には、PATH 環境変数で使用可能な z/OS® の Java™ Connect EE 互換バージョンが必要です。UNIX® システム・サービスの echo $PATH コマンドを使用して PATH 変数を確認できます。
z/OS® Connect インストール・ディレクトリー <ZCON_INST_DIR>/v3r0/wlp/bin は PATH 環境変数内にある必要があります。

このタスクについて

Z Data Tools Service Provider for z/OS® Connect の機能は、SHFMSAM1 データ・セットの HFMZCEE メンバーのバイナリー・アーカイブとして提供されます。アーカイブには、以下のファイルが含まれます。

com.hcl.zosconnect.zdt.provider.feature_n.n.n.n.esa	機能アーカイブ
zdtService.sar	Z Data Tools Base component サービス・アーカイブ
zdtIMSService.sar	IMS™ サービス・アーカイブ
zdtDB2Service.sar	Db2® サービス・アーカイブ
zdatatools.properties	プロパティー・ファイル
com.hcl.zosconnect.buildtoolkit.zdatatools.jar	ビルド・ツールキット・プラグイン

手順

UNIX システム・サービスの z/OS® コマンドを使用して、Z Data Tools Service Provider for pax Connect のアーカイブを SHFMSAM1 データ・セットから抽出します。
```
pax -rf "//'<hlq>.SHFMSAM1(HFMZCEE)'"
```
このコマンドは、HFMZCEE アーカイブを現行作業ディレクトリーに抽出します。
(オプション) インストール・ディレクトリーを変更する場合は、プロパティー・ファイルで productInstall オプションを編集します。
```
com.ibm.websphere.productInstall=</your/preferred/directory>
```
これは、Z Data Tools Service Provider がインストールされる場所です。このディレクトリーは完全修飾されている必要があります。つまり、スラッシュ (/) で始まる必要があります。デフォルトのインストール・ディレクトリーは /var/zdatatools です。デフォルトのディレクトリを変更する場合は、既存のファイルやサブディレクトリが存在しないディレクトリを選択することをお勧めします。productInstall ディレクトリーは、存在しない場合には作成されます。
UNIX システム・サービス z/OS® コマンドを使用して、プロパティー・ファイルを <WLP_USER_DIR>/v3r0/extensions Connect cp ディレクトリーにコピーします。
例:
```
cp zdatatools.properties /var/zosconnect/v3r0/extensions
```
サービス・アーカイブ・ファイルを z/OS® Connect サービス・ディレクトリーにコピーします。
例:
```
cp zdt*.sar 
   /var/zosconnect/servers/<yourWLPServer>/resources/zosconnect/services
```
サービス・アーカイブ・ファイルが、z/OS® Connect WLP 開始タスク・ユーザーから読み取り可能であることを確認します。
installUtility コマンドを使用して、Z Data Tools Service Provider の機能を z/OS® Connect にインストールします。例:
```
installUtility install 
com.hcl.zosconnect.zdt.provider.feature_2.0.0.0.esa --to=zdatatools
```
ESA ファイルのバージョン番号がアーカイブ内のファイル名と一致することを確認します。
z/OS Connect WLP の server.xml 構成を編集します。

server.xml に次の変更を加える必要があります。
1. Z Data Tools 機能を featureManager スタンザに追加します。
```
<featureManager>
	<feature>zdatatools:zdtProvider-2.0</feature>
</featureManager>
```
2. 機能の runport およびの最大タイムアウト構成を追加します。
```
<ZDataTools_Connection id="default" runport="2800" max_timeout="1800" />
```
  runport は ZCC server セッションの確立に使用される Z Data Tools ポートを表し、max_timeout はアクティビティーがなくてもクライアントが Z Data Tools セッションを開いたままにしておける最大秒数を表します。
ZCC server JCL を、z/OS Connect REST 要求をサポートするように変更します。
HFISRV CONFIG DD ステートメントで、CONFIG=ZDT スタンザの後に REST=YES を追加します。例:
```
//CONFIG DD *
	CONFIG=ZDT
	REST=YES
	…
/*
```
z/OS Connect WLP タスクおよび ZCC server タスクを再始動または更新します。

次のタスク

Z Data Tools Service Provider が正常にインストールされたことを確認するには、次の手順を実行します。

z/OS Connect WLP 開始タスクの JOBLOG を調べて、CWWKF0012I メッセージに zdtProvider-2.0 がインストール済み機能の 1 つとしてリストされていることを確認します。例:
```
CWWKF0012I: The server installed the following features: ssl-1.0, 
jdbc-4.1, zdatatools:zdtProvider-2.0, …
```
次のペイロードで https://zceehost:zceeport/zosConnect/services/zdtService?action=invoke への HTTP PUT 要求を使用して、Z Data Tools Service Provider を手動で起動します。
```
{
    "action" : "verify"
}
```
この操作は、ブラウザーまたは POSTMAN などの REST API ツールから行うことができます。HTTP 動詞は PUT または POST である必要があり、Content-Type: application/json ヘッダーは必須です。HTTP ステータス・コード 200 は、Z Data Tools Service Provider が正しくインストールされていることを示します。

インストールの確認が失敗した場合、すべてのインストール手順が指定された順序で完了したことを確認します。「Z Data Tools ユーザーズ・ガイドおよびリファレンス」にも、Z Data Tools Service Provider for z/OS Connect のトラブルシューティング・トピックがあります。