Maintaining Z Data Tools Service Provider

If service is applied, some maintenance steps are necessary.

Before you begin

If service is applied to the HFMZCEE member of the SHFMSAM1 data set, some maintenance steps are necessary.

Note: If the service provider is not already installed into the z/OS Connect environment, then maintenance is not applicable, and the installation steps should be followed instead.

The maintenance procedure is conducted in the UNIX® System Services environment and has the following environmental prerequisites:

The shell environment must have a z/OS® Connect EE-compatible version of Java™ available on the environment PATH variable. You can check the PATH variable by using the UNIX® System Services echo $PATH command.
The z/OS® Connect installation directory <ZCON_INST_DIR>/v3r0/wlp/bin must be in the PATH environment variable.

About this task

The Z Data Tools Service Provider for z/OS® Connect feature is shipped as a binary archive in the SHFMSAM1 data set as member HFMZCEE. The archive contains the following files:

com.hcl.zosconnect.zdt.provider.feature_n.n.n.n.esa	Feature archive
zdtService.sar	Z Data Tools Base component service archive
zdtIMSService.sar	IMS™ service archive
zdtDB2Service.sar	Db2® service archive
zdatatools.properties	Properties file
com.hcl.zosconnect.buildtoolkit.zdatatools.jar	Build Toolkit plug-in

The following procedure includes stopping and restarting the z/OS® Connect WLP server. In high-availability environments this may be undesirable. For alternative procedures refer to the following topics:

Procedure

Extract the Z Data Tools Service Provider for z/OS® Connect archive from the SHFMSAM1 data set using the UNIX System Services pax command.
```
pax -rf "//'<hlq>.SHFMSAM1(HFMZCEE)'"
```
This command extracts the HFMZCEE archive into the current working directory.
Copy the service archive files to the z/OS® Connect service directory.
For example:
```
cp zdt*.sar
   /var/zosconnect/servers/<yourWLPServer>/resources/zosconnect/services
```
Ensure that the service archive files are readable by the z/OS® Connect WLP started task user.
(Optional) If you use the zconbt command to create SAR files, copy the Z Data Tools Build Toolkit plug-in to the Build Toolkit /plugins directory.
For example:
```
cp com.hcl.zosconnect.buildtoolkit.zdatatools.jar /var/zconbtv3/plugins
```
Check APAR HOLDDATA before continuing to the next step in case there are additional steps that need to occur at this point.
Stop the z/OS Connect WLP server.
Uninstall the current Z Data Tools Service Provider using the installUtility command.
For example:
```
installUtility uninstall zdatatools:zdtProvider-2.0
```
Reinstall the Z Data Tools Service Provider feature into z/OS Connect using the installUtility command.
For example:
```
installUtility install
com.hcl.zosconnect.zdt.provider.feature_2.0.0.0.esa --to=zdatatools
```
Note that the .esa filename may vary by version.
Restart the z/OS Connect WLP server.