SMP/E install of the OneAgent for z/OS

You can directly download the installation files of the OneAgents for z/OS to your mainframe from the DESK HTTPS or FTP server. Use one of the sample JCL pulldowns below to do this.

There are three retrieval methods

HTTPS RFN install (JOB RFNHINST) uses Receive From Network commands and HTTPS which requires an SMP/E computed hash value.
FTP RFN install (JOB RFNINSTL) uses the FTP server Receive From Network commands which also requires an SMP/E computed hash value. The current hash value is included with both RFN JCL pulldowns below. This hash value is also used for the RFNMAINT and RFNHMANT members located in the SZDTSAMP dataset.
FTP install (JOB FTPINSTL) uses standard FTP procedures. Refer to the SZDTSAMP member list further down the page.

CICS users

On a release upgrade, update zDC version first. This ensures the support of the earlier versions of OneAgents. Then update the Code Modules on CICS and restart CICS. Do not dynamically install new version.

Determine the desired high level qualifier for the install dataset names, and set the HLQ variable accordingly in the JCL below.

If you're using the RFN process, set a USS directory for temporary files required by SMP/E and the VOLSER where you want the install datasets created.

HTTPS RFN install for z/OS


        zos/smpe-install/https-rfn.txt

Download

//RFNHNST JOB ('ACCTINFO'),'User name or comment',NOTIFY=&SYSUID,
//             MSGLEVEL=(1,1),CLASS=A,MSGCLASS=X
//*
//* This job obtains OneAgent install pax files using RFN. Step 1
//* executes GIMGTPGK to receive the pax files from the HTTPS server
//* and store them in a USS directory. Step 2 executes GIMUNZIP to
//* to unpack the pax files.
//*
//* Change the JOB card and the SET statements below to meet
//* site standards. If the default HLQ is changed, a matching change
//* is required when running subsequent install and maintenance jobs.
//* This sample is using javahome in its default location and
//* pointing to Java 8.0.  It also uses the default javatruststore
//* to get the certificate.  You may need to change these depending
//* on your Java setup and levels.
//*
//* The hash value below should be correct for the current product
//* cumulative maintenance level, which changes monthly.
//*
//* You may clean up the "/u/myuserid/DT72" and the
//* "&HLQ..DTMF.LZDT720" file after the SMP/E job is complete.
//* To run the Maintance job RFNHMNT or FRNFMNT you will need to empty
//* the DT72 USS directory.
//*
// EXPORT SYMLIST=(HLQ,USSDIR,VOLUME,HASH,JAVAPATH)
// SET HLQ='DT'                  <===== SET HLQ HERE
// SET USSDIR='/u/myuserid'      <===== SET USS home/temp directory
// SET VOLUME='VOLSER'           <===== SET VOLSER
// SET JAVAPATH='/usr/lpp/java/J8.0/' <===== SET JAVA PATH
// SET HASH='D79D9284B03215F30BF5C8DD0F102C7E8759128A' <==== Nov 2019
//*
//* For use with z/OS V1, delete the previous lines, remove
//* SYMBOLS= from the SYSIN DD, and issue the edit command:
//* C &HLQ. <newHLQ>
//*
//* Run GIMTGTPKG to obtain the install package from the FTP site
//*
//GIMGTPKG EXEC PGM=GIMGTPKG,REGION=0M
//SMPOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SMPNTS   DD PATH='&USSDIR',PATHDISP=KEEP
//SMPCPATH DD PATH='/usr/lpp/smp/classes/',PATHDISP=KEEP
//SMPJHOME DD PATH='&JAVAPATH',PATHDISP=KEEP
//SMPCLNT  DD *,SYMBOLS=EXECSYS
<CLIENT
  downloadmethod="https"
  downloadkeyring="javatruststore"
  javahome="&JAVAPATH"
  >
</CLIENT>
/*
//SMPSRVR  DD *,SYMBOLS=EXECSYS
<SERVER host="files.desk.com">
  <PACKAGE
    file="/downloads/OnPrem/dynaTrace/7.2/mainframe/GIMZIP/GIMPAF.XML"
    hash="&HASH"
    id="DT72">
  </PACKAGE>
</SERVER>
/*
//*
//* Run GIMUNZIP to unpack the pax files
//*
//INSUNZIP EXEC PGM=GIMUNZIP,REGION=0M,COND=(0,NE)
//*
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(50,10))
//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))
//* Message output datasets:
//SMPOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SMPDIR   DD PATH='&USSDIR/DT72',PATHDISP=KEEP
//SMPCPATH DD PATH='/usr/lpp/smp/classes/',PATHDISP=KEEP
//SMPJHOME DD PATH='&JAVAPATH',PATHDISP=KEEP
//SYSIN    DD *,SYMBOLS=EXECSYS
<GIMUNZIP>
  <ARCHDEF
   name="SMPPTFIN/S0001.DT.R070200.MEDIA.PROD.DTMF.LZDT720.MNT.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT720.MNT">
  </ARCHDEF>
  <ARCHDEF
   name="SMPPTFIN/S0002.DT.R070200.MEDIA.PROD.DTMF.LZDT720.MCS.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT720.MCS">
  </ARCHDEF>
  <ARCHDEF
   name="SMPRELF/DT.R070200.MEDIA.PROD.DTMF.LZDT720.F1.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT720.F1">
  </ARCHDEF>
  <ARCHDEF
   name="SMPRELF/DT.R070200.MEDIA.PROD.DTMF.LZDT720.F2.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT720.F2">
  </ARCHDEF>
  <ARCHDEF
   name="SMPRELF/DT.R070200.MEDIA.PROD.DTMF.LZDT720.F3.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT720.F3">
  </ARCHDEF>
</GIMUNZIP>
/*
//

FTP RFN install for z/OS


        zos/smpe-install/ftp-rfn.txt

Download

//RFNINSTL JOB ('ACCTINFO'),'User name or comment',NOTIFY=&SYSUID,
//             MSGLEVEL=(1,1),CLASS=A,MSGCLASS=X
//*
//* This job obtains OneAgent install pax files using RFN. Step 1
//* executes GIMGTPGK to receive the pax files from the FTP server
//* and store them in a USS directory. Step 2 executes GIMUNZIP to
//* to unpack the pax files.
//*
//* Change the JOB card and the SET statements below to meet
//* site standards. If the default HLQ is changed, a matching change
//* is required when running subsequent install and maintenance jobs.
//*
//* The hash value below should be correct for the current product
//* cumulative maintenance level, which changes monthly.
//*
// EXPORT SYMLIST=(HLQ,USSDIR,VOLUME,HASH,JAVAPATH)
// SET HLQ='DT'                  <===== SET HLQ HERE
// SET USSDIR='/u/myuserid'      <===== SET USS home/temp directory
// SET VOLUME='VOLSER'           <===== SET VOLSER
// SET JAVAPATH='/usr/lpp/java/J8.0/'   <==== SET JAVA PATH
// SET HASH='D79D9284B03215F30BF5C8DD0F102C7E8759128A' <==== Nov 2019
//*
//* For use with z/OS V1, delete the previous lines, remove
//* SYMBOLS= from the SYSIN DD, and issue the edit command:
//* C &HLQ. <newHLQ>
//*
//* Run GIMTGTPKG to obtain the install package from the FTP site
//*
//GIMGTPKG EXEC PGM=GIMGTPKG,REGION=0M
//SMPOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SMPNTS   DD PATH='&USSDIR',PATHDISP=KEEP
//SMPCPATH DD PATH='/usr/lpp/smp/classes/',PATHDISP=KEEP
//SMPJHOME DD PATH='&JAVAPATH',PATHDISP=KEEP
//SMPSRVR  DD *,SYMBOLS=EXECSYS
<SERVER host="us-et-ftp01.desk.com"
        user="DESK72"
        pw="desk72">
  <PACKAGE file="/GIMZIP/GIMPAF.XML"
           hash="&HASH"
           id="DT72">
  </PACKAGE>
</SERVER>
/*
//*
//* Run GIMUNZIP to unpack the pax files
//*
//INSUNZIP EXEC PGM=GIMUNZIP,REGION=0M,COND=(0,NE)
//*
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(50,10))
//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))
//* Message output datasets:
//SMPOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SMPDIR   DD PATH='&USSDIR/DT72',PATHDISP=KEEP
//SMPCPATH DD PATH='/usr/lpp/smp/classes/',PATHDISP=KEEP
//SMPJHOME DD PATH='&JAVAPATH',PATHDISP=KEEP
//SYSIN    DD *,SYMBOLS=EXECSYS
<GIMUNZIP>
  <ARCHDEF
   name="SMPPTFIN/S0001.DT.R070200.MEDIA.PROD.DTMF.LZDT720.MNT.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT720.MNT">
  </ARCHDEF>
  <ARCHDEF
   name="SMPPTFIN/S0002.DT.R070200.MEDIA.PROD.DTMF.LZDT720.MCS.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT720.MCS">
  </ARCHDEF>
  <ARCHDEF
   name="SMPRELF/DT.R070200.MEDIA.PROD.DTMF.LZDT720.F1.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT720.F1">
  </ARCHDEF>
  <ARCHDEF
   name="SMPRELF/DT.R070200.MEDIA.PROD.DTMF.LZDT720.F2.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT720.F2">
  </ARCHDEF>
  <ARCHDEF
   name="SMPRELF/DT.R070200.MEDIA.PROD.DTMF.LZDT720.F3.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT720.F3">
  </ARCHDEF>
</GIMUNZIP>
/*
//

FTP install for z/OS

Replace <MY_HLQ> with your actual value.


        zos/smpe-install/ftp.txt

Download

//FTPINSTL JOB ('ACCTINFO'),'User name or comment',NOTIFY=&SYSUID,
//             MSGLEVEL=(1,1),CLASS=A,MSGCLASS=X
//*
//* This job obtains OneAgent install XMIT files using FTP
//* and issues the TSO RECEIVE command to unpack them.
//*
//* Change the JOB card and the HLQ on the SET statement below to meet
//* site standards. If the default HLQ is changed, a matching change
//* is required when running subsequent install and maintenance jobs.
//*
// EXPORT SYMLIST=(HLQ)
// SET HLQ='<MY_HLQ>'
//*
//* For use with z/OS V1, delete the previous lines, remove
//* SYMBOLS= from he SYSIN DD, and issue the edit command:
//* C &HLQ. <newHLQ>
//*
//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
locsite fwfriendly
locsite recfm=fb lrecl=80 blksize=27920
locsite tracks primary=5 secondary=5
get MCS '&HLQ..DTMF.LZDT720.MCS.XMIT' (REPLACE
locsite tracks primary=1 secondary=1
get F1 '&HLQ..DTMF.LZDT720.F1.XMIT' (REPLACE
locsite tracks primary=30 secondary=15
get F2 '&HLQ..DTMF.LZDT720.F2.XMIT' (REPLACE
locsite tracks primary=45 secondary=15
get F3 '&HLQ..DTMF.LZDT720.F3.XMIT' (REPLACE
locsite tracks primary=300 secondary=15
get MNT '&HLQ..DTMF.LZDT720.MNT.XMIT' (REPLACE
quit
/*
//*
//RECEIVE  EXEC PGM=IKJEFT01,DYNAMNBR=20,COND=(0,NE)
//SYSPRINT DD  SYSOUT=*
//SYSTSPRT DD  SYSOUT=*
//SYSTSIN  DD  *,SYMBOLS=EXECSYS
 RECEIVE INDSN('&HLQ..DTMF.LZDT720.MCS.XMIT') NODISPLAY
 DATASET('&HLQ..DTMF.LZDT720.MCS') +
 RELEASE
 RECEIVE INDSN('&HLQ..DTMF.LZDT720.F1.XMIT') NODISPLAY
 DATASET('&HLQ..DTMF.LZDT720.F1') +
 RELEASE
 RECEIVE INDSN('&HLQ..DTMF.LZDT720.F2.XMIT') NODISPLAY
 DATASET('&HLQ..DTMF.LZDT720.F2') +
 RELEASE
 RECEIVE INDSN('&HLQ..DTMF.LZDT720.F3.XMIT') NODISPLAY
 DATASET('&HLQ..DTMF.LZDT720.F3') +
 RELEASE
 RECEIVE INDSN('&HLQ..DTMF.LZDT720.MNT.XMIT') NODISPLAY
 DATASET('&HLQ..DTMF.LZDT720.MNT') +
 RELEASE
/*
//XMITDEL  EXEC PGM=IDCAMS,REGION=1024K,COND=(0,NE)
//SYSPRINT DD  SYSOUT=*
//SYSIN    DD  *,SYMBOLS=EXECSYS
 DEL &HLQ..DTMF.LZDT720.MCS.XMIT PURGE
 DEL &HLQ..DTMF.LZDT720.F1.XMIT PURGE
 DEL &HLQ..DTMF.LZDT720.F2.XMIT PURGE
 DEL &HLQ..DTMF.LZDT720.F3.XMIT PURGE
 DEL &HLQ..DTMF.LZDT720.MNT.XMIT PURGE
/*
//

Note

This JCL takes advantage of inline symbols that first appeared in z/OS R 2.1

Run the Modified download JCL. If you use the default high level qualifier, the following datasets are created:

DT.DTMF.LZDT720.F1
DT.DTMF.LZDT720.F2
DT.DTMF.LZDT720.F3
DT.DTMF.LZDT720.MCS
DT.DTMF.LZDT720.MNT

The DT.DTMF.LZDT720.F2 PDS contains JCL for the SMP/E portion of the install and subsequent maintenance. After the SMP/E APPLY step has been run, copies of these members may be found in the SZDTSAMP dataset. The following members are provided:

Member	Description
`FTPINSTL`	A copy of the FTP download job.
`FTPMAINT`	A job to download cumulative PTF maintenance only. Note that all currently available maintenance is also delivered with the product install.
`RFNHINST`	A copy of the RFN HTTPS download job.
`RFNHMNT`	A job to download cumulative PTF maintenance only through HTTPS RFN commands. Update this member with the SET HASH value in the aforementioned `RFNHINST` job pulldown. Hash value changes are updated in this documentation. All currently available maintenance is also delivered with the product install.
`RFNINSTL`	A copy of the RFN download job.
`RFNMAINT`	A job to download cumulative PTF maintenance only through RFN commands. Update this member with the SET HASH value in the aforementioned `RFNINSTL` job. Hash value changes are updated in this documentation. All currently available maintenance is also delivered with the product install.
`SMPINSTL`	An SMP/E job to complete the product install.
`SMPMAINT`	An SMP/E job to apply cumulative PTF maintenance to the target libraries.

If you changed the default HLQ in the download job, make the same change to the SMPINSTL job and any subsequent maintenance download or install jobs.

Run the modified SMPINSTL job. If you use the default high level qualifier, the following datasets are created:

DT.LZDT720.GLOBAL.CSI
DT.LZDT720.SMPLOG
DT.LZDT720.SMPLTS
DT.LZDT720.SMPMTS
DT.LZDT720.SMPPTS
DT.LZDT720.SMPSCDS
DT.LZDT720.SMPSTS

DT.LZDT720.TZONE.CSI
DT.LZDT720.SZDTAUTH
DT.LZDT720.SZDTIMSA
DT.LZDT720.SZDTLOAD
DT.LZDT720.SZDTSAMP

DT.LZDT720.DZONE.CSI
DT.LZDT720.AZDTLOAD
DT.LZDT720.AZDTSAMP

If the job ends with a RC of 4, the SMP/E portion of the installation is a success. The installation process creates and populates four target libraries. If you use the default high level qualifier, the target dataset names are

DT.LZDT720.SZDTAUTH: Contains zDC load modules.
DT.LZDT720.SZDTLOAD: Contains CICS code modules.
DT.LZDT720.SZDTIMSA: Contains IMS and IMS Connect code modules.
DT.LZDT720.SZDTSAMP: Includes sample JCL and CICS RDO definitions.