Deploy OneAgent on z/OS CTG and IMS SOAP gateway

Dynatrace supports CICS Transaction Gateway (CTG) and IMS SOAP Gateway running in a JVM on z/OS to collect path events. You need to download the OneAgent installer (oneagentjava4z.jar file) from the Dynatrace FTP site and follow the instructions to deploy it in your CTG or IMS SOAP Gateway.

Download OneAgent

Use the following JCL or the FTP program of your choice to download the oneagentjava4z.jar file as binary to the folder of your choice on OMVS.

If you're using a 32-bit JVM, use the agent/lib folder, rather than the agent/lib64 folder.

zos/jcl.txt
Download
//jobname  JOB ('ACCTINFO'),'User name or comment',NOTIFY=&SYSUID,
//             MSGLEVEL=(1,1),CLASS=A,MSGCLASS=X
//*
//* This job obtains OneAgent installer oneagent4z.jar file via
//* FTP.
//*
//* Change the JOB card and the PATH on the SET statement below to meet
//* site standards.
//*
// EXPORT SYMLIST=(PATH)
// SET PATH='/u/dt/7.2/agent/lib64      <===== SET INSTALL PATH HERE
//*
//FTP     EXEC PGM=FTP,DYNAMNBR=20,PARM='(EXIT TIMEOUT 99',TIME=5
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *,SYMBOLS=EXECSYS
us-et-ftp01.dynatrace.com
Dynatrace72
dynatrace72
binary
cd oneagentjava4z_7.2
lcd '&PATH'
get oneagentjava4z.jar REPLACE
quit
/*
//

Add OneAgent to CTG environment

  1. Modify the CTGENV member and the CTGSTART_OPTS variable to include the following:
    -j-javaagent:/u/dt/7.2/agent/lib64/oneagentjava4z.jar=\
    zdc-name=<YOUR_ZDC_SYSID>,log-stderr=true
    
    Where <YOUR_ZDC_SYSID> is your zDC Subsystem ID, without the brackets, for example zdc-name=MEPC.
  2. Stop and restart your CTG. You should see the OneAgent start.

Add OneAgent to IMS SOAP Gateway

  1. Modify your IMS SOAP Gateway parameters to include the following new option zDT:
    zDT="-javaagent:/u/dt/7.2/agent/lib64/oneagentjava4z.jar=\
    zdc-name=<YOUR_ZDC_SYSID>,log-stderr=true
    
    Where <YOUR_ZDC_SYSID> is your zDC Subsystem ID, without the brackets, for example zdc-name=MEPC.
  2. Due to an issue with the IBM JIT, you must add the following as well:
    # OPTION: per Dynatrace - don't JIT this class
    IJO="$IJO -Xjit:exclude={com/ctc/wstx/sr/StreamScanner.parseLocalName*}"
    
  3. Finally, export the new Java options defined in the zDT variable so that IBM_JAVA_OPTIONS includes them.
    export IBM_JAVA_OPTIONS="$IJO $zDT $JAVA_OPTS"