Deploy OneAgent on z/OS CTG and IMS SOAP gateway

DESK 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 DESK 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.desk.com
DESK72
desk72
binary
cd oneagentjava4z_7.2
lcd '&PATH'
get oneagentjava4z.jar REPLACE
quit
/*
//

Add OneAgent to CTG environment

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.
Stop and restart your CTG. You should see the OneAgent start.

Add OneAgent to IMS SOAP Gateway

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.

Due to an issue with the IBM JIT, you must add the following as well:

# OPTION: per DESK - don't JIT this class
IJO="$IJO -Xjit:exclude={com/ctc/wstx/sr/StreamScanner.parseLocalName*}"

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"
```