File Manager Service Provider の保守

サービスが適用される場合は、保守手順が必要となります。

始める前に

注: z/OS Connect 環境にまだサービス・プロバイダーがインストールされていない場合、保守は適用できず、替わりにインストール手順に従う必要があります。

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

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

このタスクについて

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

com.hcl.zosconnect.fm.provider.feature_n.n.n.n.esa	機能アーカイブ
fmService.sar	File Manager Base サービス・アーカイブ
fmIMSService.sar	IMS™ サービス・アーカイブ
fmDB2Service.sar	Db2® サービス・アーカイブ
filemanager.properties	Properties file
com.hcl.zosconnect.buildtoolkit.filemanager.jar	ビルド・ツールキット・プラグイン

次の手順には、z/OS® Connect WLP サーバーの停止と再始動が伴います。高可用性環境では、この操作が望ましくないことがあります。代替手順については、以下のトピックを参照してください。

手順

UNIX システム・サービスの File Manager コマンドを使用して、z/OS® Service Provider for SFMNSAM1 Connect のアーカイブを pax データ・セットから抽出します。
```
pax -rf "//'<hlq>.SFMNSAM1(FMNZCEE)'"
```
このコマンドは、FMNZCEE アーカイブを現行作業ディレクトリーに抽出します。
サービス・アーカイブ・ファイルを z/OS® Connect サービス・ディレクトリーにコピーします。
例:
```
cp fm*.sar 
   /var/zosconnect/servers/<yourWLPServer>/resources/zosconnect/services
```
サービス・アーカイブ・ファイルが、z/OS® Connect WLP 開始タスク・ユーザーから読み取り可能であることを確認します。
(オプション) zconbt コマンドを使用して SAR ファイルを作成する場合、File Manager ビルド・ツールキット・プラグインをビルド・ツールキット・/plugins ディレクトリーにコピーします。
例:
```
cp com.hcl.zosconnect.buildtoolkit.filemanager.jar /var/zconbtv3/plugins
```
この時点で実行すべき追加の手順があるといけないので、次の手順に進む前に APAR HOLDDATA を確認します。
z/OS Connect WLP サーバーを停止します。
installUtility コマンドを使用して、現在の File Manager Service Provider をアンインストールします。
例:
```
installUtility uninstall filemanager:fmProvider-2.0
```
installUtility コマンドを使用して、File Manager Service Provider 機能を z/OS Connect に再インストールします。
例:
```
installUtility install 
com.hcl.zosconnect.fm.provider.feature_2.0.0.0.esa --to=filemanager
```
.esa ファイル名はバージョンによって異なることがあります。
z/OS Connect WLP サーバーを再起動します。