Maintaining Z Data Tools Service Provider

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

Before you begin

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 (USS) 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 (USS) 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 Base 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

  1. Extract the Z Data Tools Service Provider for z/OS Connect archive from the SHFMSAM1 data set using the USS pax command.
    pax -rf "//'<hlq>.SHFMSAM1(HFMZCEE)'"
    This command extracts the HFMZCEE archive into the current working directory.
  2. 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.
  3. (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
  4. Check APAR HOLDDATA before continuing to the next step in case there are additional steps that need to occur at this point.
  5. Stop the z/OS Connect WLP server.
  6. Uninstall the current Z Data Tools Service Provider using the installUtility command. For example:
    installUtility uninstall zdatatools:zdtProvider-2.0
  7. 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.
  8. Restart the z/OS Connect WLP server.