Uninstall Dynatrace OneAgent on z/OS

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

1. Uninstall the zDC

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.

2. Uninstall OneAgent from CICS

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.
   Show error message

   dnscopydownload
   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.
   Show error message

   dnscopydownload
   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 to DISABLE our hooks and exits until you can recycle the CICS region.
7. Recycle the CICS region when possible.

3. Uninstall OneAgent from IMS

1. Run the ZDTIINST job with action code D to disable the IMS hook until you can recycle the IMS.
2. Recycle the IMS region when possible.
3. Uninstall OneAgent from IMS Connect.
   1. Remove SZDTAUTH from the STEPLIB.
   2. Recycle IMS Connect.

4. Uninstall Java code module on z/OS

If OneAgent for Java was installed on z/OS, follow the below steps to uninstall from the respective instances.

Uninstall from WebSphere Application Server

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

Uninstall from WebSphere Liberty

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

Uninstall from CICS Transaction Gateway

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

Uninstall from IMS SOAP Gateway

1. Remove the zDT reference from the IMS SOAP Gateway configuration file.
2. Recycle IMS SOAP Gateway.

Uninstall from z/OS Connect Enterprise Edition

1. Remove the dynatrace-oneagent-zos-java.jar referenced in -javaagent= in JVM_OPTIONS in STDENV.
2. Recycle z/OS Connect.

5. Uninstall the zRemote module

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

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

6. Delete datasets

Delete the following installation datasets:

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

7. Following uninstallation

There are installation files, log files, and configuration files in the USS directory that need to be manually deleted following the uninstallation.

If you used the u/dt default home directory:

• The zDC, zLocal, and Java OneAgent for z/OS 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 Java OneAgent for z/OS dynatrace-oneagent-zos-java.jar file and the dtconfig.json configuration file from where you stored them in the USS.