Uninstall the z/OS modules

To uninstall the modules from z/OS, you need to uninstall its individual components as described below.

Uninstall the zDC subsystem

  1. Shut down the zDC started task.
  2. Remove the zDC started task from any automation process that starts it at IPL time.
  3. Remove SZDTAUTH from the APF Authorized list.
  4. Remove the zDC proc from your proclib.
  5. Remove the zDC JCL from your JCL library if one exists.

Uninstall the CICS module

  1. If a SOAP pipeline is used, scan all the pipeline configuration files and remove ZDTSOAPH references.
    If ZDTSOAPH remains in the pipeline, CICS SOAP requests will fail.

    DFHPI0604 <cicsapplid> CPIH The CICS SOAP handler encountered an error while trying to link to program ZDTSOAPH.
    The program was not loadable. PIPELINE: <pipeline name>.
  2. Remove ZDTPLT and ZDTPLTSD from the PLT list.
    An attempt to restart CICS without removing these might cause the CICS startup to hang while awaiting operator input to continue without ZDTPLT.

    DFHSI1579D <cicsapplid> Module DFHSIPLT PLT program ZDTPLT not found. Reply GO or CANCEL.
  3. Remove the ZDTPLT= parameter from INITPARM in the SIT parameter.

  4. Remove the Dynatrace GROUP definition (DTA1 by default) from the CSD.

  5. optional Remove SZDTLOAD if it was added to the DFHRPL concatenation.

  6. Use DTAX DISABLE to disable our hooks and exits until you can restart the CICS region.

  7. Restart the CICS region.

Uninstall the IMS module

For IMS control regions

  1. Run the ZDTIINST job with action code D to disable the IMS hook until you can restart the IMS region.
  2. Restart the IMS region.

For IMS Connect

  1. Remove SZDTAUTH from the STEPLIB.
  2. Restart IMS Connect.

Uninstall z/OS Java module

Follow the steps below to uninstall the z/OS Java module from the respective instances.

Application server

Middleware

Uninstall the zRemote module

Although the zRemote module is installed automatically during the ActiveGate installation, it isn't removed when the ActiveGate is removed. You need to uninstall the zRemote module separately.

Delete datasets

Delete the following installation datasets:

  • DT.R1nnnx.SZDTAUTH
  • DT.R1nnnx.SZDTLOAD
  • DT.R1nnnx.SZDTSAMP

Following uninstallation

There are installation files, log files, and configuration files in the z/OS Unix system services (USS) environment that need to be manually deleted following the uninstallation.

If you used the u/dt default home directory:

  • The zDC, zLocal, and Java module logs are stored in the /u/dt/log directory.
  • The installation files are stored in the /u/dt/agent directory.

Delete the u/dt directory to clean up those installation files and log files.

Delete the z/OS Java module dynatrace-oneagent-zos-java.jar file and the dtconfig.json configuration file from where you stored them in the z/OS USS environment.