Download and SMP/E install z/OS Agent components

You can directly download the installation files for all mainframe z/OS Agent components to your mainframe from the Dynatrace FTP server. Use the sample JCL below to do this.  There are two retrieval methods.  The first method (JOB FTPINSTL) uses standard FTP procedures. The second method (JOB RFNINSTL) accesses the same FTP server but uses Receive From Network commands which requires an SMP/E computed hash value. The current hash value is included with the RFN JCL listed below. This hash value is also used for the RFNMAINT member located in the SZDTSAMP dataset. Refer to the SZDTSAMP member list further down the page.

Determine the desired high level qualifier for the install dataset names, and set the HLQ variable accordingly in the JCL below. If 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.

//FTPINSTL JOB ('ACCTINFO'),'User name or comment',NOTIFY=&SYSUID,
//             MSGLEVEL=(1,1),CLASS=A,MSGCLASS=X
//*
//* This job obtains Dynatrace 7.0 install XMIT files via 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='DT'             <===== SET HLQ HERE
//*
//* For use with z/OS V1, delete the lines above, remove SYMBOLS= from
//* the 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.dynatrace.com
Dynatrace70
Dynatrace70
binary
locsite recfm=fb lrecl=80 blksize=27920
locsite tracks primary=5 secondary=5
get MCS '&HLQ..DTMF.LZDT700.MCS.XMIT' (REPLACE
locsite tracks primary=1 secondary=1
get F1 '&HLQ..DTMF.LZDT700.F1.XMIT' (REPLACE
locsite tracks primary=30 secondary=15
get F2 '&HLQ..DTMF.LZDT700.F2.XMIT' (REPLACE
locsite tracks primary=45 secondary=15
get F3 '&HLQ..DTMF.LZDT700.F3.XMIT' (REPLACE
locsite tracks primary=75 secondary=15
get MNT '&HLQ..DTMF.LZDT700.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.LZDT700.MCS.XMIT') NODISPLAY
 DATASET('&HLQ..DTMF.LZDT700.MCS') +
 RELEASE
 RECEIVE INDSN('&HLQ..DTMF.LZDT700.F1.XMIT') NODISPLAY
 DATASET('&HLQ..DTMF.LZDT700.F1') +
 RELEASE
 RECEIVE INDSN('&HLQ..DTMF.LZDT700.F2.XMIT') NODISPLAY
 DATASET('&HLQ..DTMF.LZDT700.F2') +
 RELEASE
 RECEIVE INDSN('&HLQ..DTMF.LZDT700.F3.XMIT') NODISPLAY
 DATASET('&HLQ..DTMF.LZDT700.F3') +
 RELEASE
 RECEIVE INDSN('&HLQ..DTMF.LZDT700.MNT.XMIT') NODISPLAY
 DATASET('&HLQ..DTMF.LZDT700.MNT') +
 RELEASE
/*
//XMITDEL  EXEC PGM=IDCAMS,REGION=1024K,COND=(0,NE)
//SYSPRINT DD  SYSOUT=*
//SYSIN    DD  *,SYMBOLS=EXECSYS
 DEL &HLQ..DTMF.LZDT700.MCS.XMIT PURGE
 DEL &HLQ..DTMF.LZDT700.F1.XMIT PURGE
 DEL &HLQ..DTMF.LZDT700.F2.XMIT PURGE
 DEL &HLQ..DTMF.LZDT700.F3.XMIT PURGE
 DEL &HLQ..DTMF.LZDT700.MNT.XMIT PURGE
/*
//
//RFNINSTL JOB ('ACCTINFO'),'User name or comment',NOTIFY=&SYSUID,
//             MSGLEVEL=(1,1),CLASS=A,MSGCLASS=X
//*
//* This job obtains Dynatrace 7.0 install pax files via 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)
// SET HLQ='DT'                  <===== SET HLQ HERE
// SET USSDIR='/u/myuserid'      <===== SET USS home/temp directory
// SET VOLUME='VOLSER'           <===== SET VOLSER
// SET HASH='1066717A6CC9326A51BD15E473CABE823CD6034D'
//*
//* For use with z/OS V1, delete the lines above, 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='/usr/lpp/java/J7.0/',PATHDISP=KEEP
//SMPSRVR  DD *,SYMBOLS=EXECSYS
<SERVER host="us-et-ftp01.dynatrace.com"
        user="Dynatrace70"
        pw="Dynatrace70">
  <PACKAGE file="/GIMZIP/GIMPAF.XML"
           hash="&HASH"
           id="DT70">
  </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/DT70',PATHDISP=KEEP
//SMPCPATH DD PATH='/usr/lpp/smp/classes/',PATHDISP=KEEP
//SMPJHOME DD PATH='/usr/lpp/java/J7.0/',PATHDISP=KEEP
//SYSIN    DD *,SYMBOLS=EXECSYS
<GIMUNZIP>
  <ARCHDEF
   name="SMPPTFIN/S0001.DT.R070000.MEDIA.PROD.DTMF.LZDT700.MNT.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT700.MNT">
  </ARCHDEF>
  <ARCHDEF
   name="SMPPTFIN/S0002.DT.R070000.MEDIA.PROD.DTMF.LZDT700.MCS.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT700.MCS">
  </ARCHDEF>
  <ARCHDEF
   name="SMPRELF/DT.R070000.MEDIA.PROD.DTMF.LZDT700.F1.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT700.F1">
  </ARCHDEF>
  <ARCHDEF
   name="SMPRELF/DT.R070000.MEDIA.PROD.DTMF.LZDT700.F2.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT700.F2">
  </ARCHDEF>
  <ARCHDEF
   name="SMPRELF/DT.R070000.MEDIA.PROD.DTMF.LZDT700.F3.pax.Z"
   volume="&VOLUME"
   newname="&HLQ..DTMF.LZDT700.F3">
  </ARCHDEF>
</GIMUNZIP>
/*
//

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.LZDT700.F1
DT.DTMF.LZDT700.F2
DT.DTMF.LZDT700.F3
DT.DTMF.LZDT700.MCS
DT.DTMF.LZDT700.MNT

The DT.DTMF.LZDT700.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 above
FTPMAINT A job to download cumulative PTF maintenance only.
Note that all currently available maintenance is also delivered with the product install above.
RFNINSTL A copy of the RFN download job above
RFNMAINT A job to download cumlative PTF maintenance only through RFN commands.  This member
needs to be updated with the SET HASH value in the aforementioned RFNINSTL job.  As
the hash value changes, it will be updated in this documentation.
Note that all currently available maintenance is also delivered with the product install above.
SMPINSTL An SMP/E job to complete the product install.
SMPMAINT An SMP/E job to apply cumulative PTF maintenance to the target libararies.

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.LZDT700.GLOBAL.CSI
DT.LZDT700.SMPLOG
DT.LZDT700.SMPLTS
DT.LZDT700.SMPMTS
DT.LZDT700.SMPPTS
DT.LZDT700.SMPSCDS
DT.LZDT700.SMPSTS

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

DT.LZDT700.DZONE.CSI
DT.LZDT700.AZDTLOAD
DT.LZDT700.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.LZDT700.SZDTAUTH, which contains zDC load modules.
  • DT.LZDT700.SZDTLOAD, which contains CICS agent load modules.
  • DT.LZDT700.SZDTIMSA, which contains IMS and IMS Connect agent load modules.
  • DT.LZDT700.SZDTSAMP, which includes sample JCL and CICS RDO definitions.