• Home
  • Setup and configuration
  • Dynatrace OneAgent
  • Installation and operation
  • z/OS

z/OS

Dynatrace supports OneAgent installation on z/OS to achieve seamless observability for the IBM Z platform. OneAgent for z/OS includes the following modules: CICS code module, IMS code module, Java code module, z/OS Data Collection subsystem (zDC), and zRemote.

OneAgent for z/OS architecture

Z/OS architecture

CICS code module

CICS code module of OneAgent traces CICS transactions initiated using IBM MQ (Bridge or Trigger), CICS Transaction Gateway, HTTP/S, SOAP (over HTTP/S) or 3270 terminal. The CICS code module also traces DB2, DL/I and MQ API calls as well as any programs invoked using CICS Link.

IMS code module

The IMS code module of OneAgent traces IMS transactions submitted from IMS MQ Bridge or MQ Trigger Monitor, IMS TM Resource Adapter, IMS SOAP Gateway, 3270 terminal or IMS Connect API. The IMS code module also traces DB2, DL/I and MQ API calls.

Java code module

The Java code module of OneAgent traces web requests on WebSphere Application Server and WebSphere Liberty. It traces requests to CICS SOAP, CICS Transaction Gateway, IBM MQ and IMS SOAP Gateway. The Java code module also traces web requests on z/OS Connect Enterprise Edition.

zDC

The z/OS Data Collection subsystem (zDC) controls the communication between the OneAgent code modules and the zLocal. The zLocal, hosted in z/OS Unix environment, runs as part of zDC. The zLocal handles the TCP/IP connection and transfers data between the IBM Z platform and the zRemote module.

zRemote

The zRemote processes binary data from the OneAgent code modules that are channeled by zLocal and relays aggregated binary data to a Dynatrace ActiveGate. The zRemote can run in a Windows or Linux environment and thereby offloads much of the OneAgent processing from the code modules incurred in instrumenting applications.

Installation

  • Download OneAgent to z/OS
  • Install the zDC
  • Install OneAgent on CICS
  • Install OneAgent on IMS
  • Install OneAgent for Java on z/OS
  • Install the zRemote module
  • Verify the installation
  • OpenTelemetry interoperability for Java on z/OS
  • Troubleshoot OneAgent installation on z/OS

Operation

  • Configure CICS and IMS monitoring
  • IBM MQ monitoring
  • CICS and IMS SDK
  • zDC reference
  • DTAX transaction
  • z/OS code module logs
  • z/OS code module messages
  • CICS backtrace and PurePath
  • IBM Z infrastructure metrics
  • Uninstall Dynatrace OneAgent on z/OS