IBM Z Application Performance Management Connect 6.1 Product Documentation for integrating with AppDynamics APM Fix pack 9 November 2020 IBM Contents Integrating with AppDynamics APM.......................................................................5 Introducing components........................................................................................7 Z APM Connect Base....................................................................................................................................7 Z APM Connect Distributed Gateway.......................................................................................................... 8 Z APM Connect CICS TS Data Producer...................................................................................................... 8 Z APM Connect IMS Data Producer............................................................................................................. 9 Z APM Connect Interceptor......................................................................................................................... 9 Z APM Connect request monitoring exits..................................................................................................10 IBM MQ Monitoring Subsystem component............................................................................................. 11 Installing and configuring.................................................................................... 13 Prerequisites and system preparation...................................................................................................... 13 Z APM Connect Base..................................................................................................................................16 Installing Z APM Connect Base............................................................................................................16 Configuring Z APM Connect Base in default mode..............................................................................16 Validating Z APM Connect Base installation and configuration.......................................................... 17 Customizing the Z APM Connect Base default configuration..............................................................18 Z APM Connect Distributed Gateway........................................................................................................ 21 Installing Z APM Connect DG with Docker standalone....................................................................... 22 Deploying Z APM Connect DG in a cluster........................................................................................... 41 Z APM Connect CICS TS Data Producer.................................................................................................... 55 Installing Z APM Connect CICS TS Data Producer ............................................................................. 56 Configuring Z APM Connect CICS TS Data Producer to connect to another subsystem.................... 56 Configuring Z APM Connect CICS TS Data Producer to create Data Transaction Processing (DTP) transaction filtering............................................................................................................... 57 Tracking IBM MQ to CICS.....................................................................................................................58 Tracking CICS to Db2, IBM MQ, or IMS DB..........................................................................................60 Z APM Connect IMS Data Producer...........................................................................................................60 Installing Z APM Connect IMS Data Producer .................................................................................... 60 Configuring Z APM Connect IMS Data Producer .................................................................................61 Instrumenting application environment..............................................................................................62 Optional IMS Connect user message exit ...........................................................................................64 Optional IMS TM resource adapter plug-in support............................................................................69 Optional IMS MQ Bridge Configuration..................................................................................................... 70 IBM MQ monitoring agent subsystem.......................................................................................................71 Updating SYS1.PARMLIB members................................................................................................... 72 Setting up the subsystem without an IPL............................................................................................74 Using a subsystem other than AGMQ.................................................................................................. 75 Z APM Connect Interceptor....................................................................................................................... 76 Installing Z APM Connect Interceptor................................................................................................. 76 Configuring Z APM Connect Interceptor..............................................................................................77 Z APM Connect request monitoring exits..................................................................................................79 Installing Z APM Connect request monitoring exits............................................................................79 Changing the logging level of Z APM Connect's request monitoring exits..........................................82 Uninstalling Z APM Connect request monitoring exits........................................................................83 Securing communications....................................................................................85 If Z APM Connect DG is installed on Linux with Docker standalone........................................................ 87 Between z/OS components and Z APM Connect Distributed Gateway.............................................. 87 For tracking CICS Transaction Gateway.............................................................................................. 93 Between z/OS Connect EE and Z APM Connect DG............................................................................ 94 Disabling secure communications.......................................................................................................94 If Z APM Connect DG is installed in a OpenShift or Kubernetes cluster.................................................. 94 iii Between z/OS components and Z APM Connect Distributed Gateway.............................................. 94 For tracking CICS Transaction Gateway............................................................................................ 100 Between z/OS Connect EE and Z APM Connect DG.......................................................................... 101 Viewing z/OS-related data................................................................................. 103 Typical user scenario......................................................................................... 105 Troubleshooting and support............................................................................. 109 Known issues and limitations..................................................................................................................109 Troubleshooting.......................................................................................................................................109 Overall troubleshooting flowchart.....................................................................................................109 Z APM Connect z/OS components.....................................................................................................111 Z APM Connect Distributed Gateway.................................................................................................113 Z APM Connect request monitoring exits.......................................................................................... 117 Messages................................................................................................................................................. 118 Z APM Connect Container messages: AGMZ*................................................................................... 118 Z APM Connect Dispatcher messages: AGMA*................................................................................. 127 Z APM Connect Dispatcher Courier messages: AGMAA* and AGMAD*............................................135 CICS TS Data Producer messages: AGMP*....................................................................................... 138 Z APM Connect request monitoring exits: AGMG*............................................................................ 143 IMS Data Producer messages: AGMI*...............................................................................................149 MQ Tracking messages: AGMQ*........................................................................................................ 154 Z APM Connect Distributed Gateway Messages: AGMT*..................................................................162 Z APM Connect Interceptor Messages: AGMC*...............................................................................