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

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

Uninstall the CICS module

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.

Show error message

plaintext
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>.

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.
Show error message
```
plaintext
DFHSI1579D <cicsapplid> Module DFHSIPLT PLT program ZDTPLT not found. Reply GO or CANCEL.
```
Remove the ZDTPLT= parameter from INITPARM in the SIT parameter.
Remove the Dynatrace GROUP definition (DTA1 by default) from the CSD.
optional Remove SZDTLOAD if it was added to the DFHRPL concatenation.
Use DTAX DISABLE to disable our hooks and exits until you can restart the CICS region.
Restart the CICS region.

Uninstall the IMS module

For IMS control regions

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

For IMS Connect

Remove SZDTAUTH from the STEPLIB.
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

WebSphere Application ServerWebSphere Liberty

Remove -javaagent:/PATH_TO/dynatrace-oneagent-zos-java.jar from the generic JVM arguments.
Restart WebSphere Application Server.

Remove -javaagent:/PATH_TO/dynatrace-oneagent-zos-java.jar from the jvm.options file.
Remove the monitor-1.0 feature from featureManager in the server.xml file.
Restart WebSphere Liberty.

Middleware

z/OS Connect Enterprise EditionCICS Transaction GatewayIMS SOAP Gateway

Remove the dynatrace-oneagent-zos-java.jar referenced in -javaagent= in JVM_OPTIONS in STDENV.
Restart z/OS Connect EE.

Remove the dynatrace-oneagent-zos-java.jar referenced in -javaagent= in member CTGENV.
Restart CICS Transaction Gateway.

Remove the zDT reference from the IMS SOAP Gateway configuration file.
Restart IMS SOAP Gateway.

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.

LinuxWindows

You need root priviliges to execute this command.

bash
/bin/sh /opt/dynatrace/zremote/uninstall.sh

Because the zRemote module is managed by a standard MSI installation package, it can be uninstalled via the standard Windows list of installed programs, or via the usual command line and Powershell commands for uninstalling programs.

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.