Download OneAgent to z/OS

You have two options for OneAgent deployment on z/OS

Direct download and installation
Manual extraction of installation files

Direct download

You can directly download the installation PAX file of the OneAgent for z/OS to your mainframe from the Dynatrace FTP server.

To do it, use the FTPINSTL job below. The FTP install job uses standard FTP procedures to receive the installation PAX file (oneagentzos-R1nnnxx.pax, where R1nnnxx is the release number) from the Dynatrace FTP server and extracts the product installation datasets from the PAX file.

Here's what you need to modify before using the job:

Determine the required USS directory to receive the PAX file and set the MYUSS variable in the job.
Determine the required high level qualifier for the install dataset names and set the HLQ variable in the job.
Change the volume serial number VOLSER to match the site standards.

Notes

The install job must be in mixed case.
Sequence numbers are not allowed.
Make sure that the JCL is uploaded with CAPS OFF and NUM OFF options.

FTPINSTL job


        zos/ftpinstl.txt

Download

//FTPINSTL JOB ('ACCTINFO'),'User name or comment',NOTIFY=&SYSUID,      
//             MSGLEVEL=(1,1),CLASS=A,MSGCLASS=X,REGION=0M,             
//             COND=(0,NE)                                              
//*                                                                     
//* This job obtains OneAgent for z/OS installation pax file from       
//* Dynatrace FTP site to the USS work directory MYUSS                  
//*                                                                     
//* Extracts the product installation datasets from the installation    
//* files at <MYUSS>/GIMZIP to <hlq>.<rel>.SZDT* libraries              
//*                                                                     
//* Change the JOB card and the SET statements below to meet            
//* site standards.                                                     
//*                                                                     
//* Verify if the SMPCPATH and SMPJHOME DD in STEP3 points to the       
//* correct PATH to meet site standards.                                
//*                                                                     
//* WARNING!                                                            
//* This JCL must be in mixed case and sequence numbers are not allowed 
//*                                                                     
// EXPORT SYMLIST=*                                                     
// SET HLQ='DT'           <== HLQ of the target PDS datasets            
// SET REL='R119500'      <== Release number                            
// SET VOLSER='NSMF13'    <== Volume of the target PDS datasets         
// SET MYUSS='/u/dt'      <== USS work directory                        
//STEP1   EXEC PGM=FTP,DYNAMNBR=20,PARM='(EXIT TIMEOUT 99',TIME=5       
//SYSPRINT DD SYSOUT=*                                                  
//SYSIN    DD *,SYMBOLS=EXECSYS                                         
us-et-ftp01.dynatrace.com                           
DynatracezOS                                        
DynatracezOS                                        
binary                                              
lcd &MYUSS                                          
get oneagentzos-&REL..pax (replace                  
quit                                                
/*                                                  
//STEP2   EXEC PGM=IKJEFT01,DYNAMNBR=55             
//SYSPRINT DD SYSOUT=*                              
//SYSTSPRT DD SYSOUT=*                              
//STDOUT   DD SYSOUT=*                              
//STDERR   DD SYSOUT=*                              
//SYSIN    DD DUMMY                                 
//SYSTSIN  DD *,SYMBOLS=EXECSYS                     
BPXBATCH SH rm -Rf &MYUSS/GIMZIP                    
BPXBATCH SH cd &MYUSS &&  +                         
         pax -rvf oneagentzos-&REL..pax GIMZIP      
/*                                                  
//STEP3    EXEC PGM=GIMUNZIP,PARM='HASH=YES',COND=(0,LT)    
//SMPDIR   DD PATH='&MYUSS/GIMZIP/',PATHDISP=KEEP           
//SMPCPATH DD PATH='/usr/lpp/smp/classes/',PATHDISP=KEEP    
//SMPJHOME DD PATH='/usr/lpp/java/J8.0/',PATHDISP=KEEP      
//SMPOUT   DD SYSOUT=*                                      
//SYSPRINT DD SYSOUT=*                                      
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))              
//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))              
//SYSIN    DD *,SYMBOLS=EXECSYS                             
<GIMUNZIP>                                                  
  <ARCHDEF archid="AUTHLIB"                                 
           replace="YES"                                    
           volume="&VOLSER"                                 
           newname="&HLQ..&REL..SZDTAUTH">                  
  </ARCHDEF>                                                
                                                            
  <ARCHDEF archid="LOAD"                                    
           replace="YES"                                    
           volume="&VOLSER"                                 
           newname="&HLQ..&REL..SZDTLOAD">                  
  </ARCHDEF>                                                
  <ARCHDEF archid="SAMPLE"                                  
           replace="YES"                                    
           volume="&VOLSER"                                 
           newname="&HLQ..&REL..SZDTSAMP">                  
  </ARCHDEF>                                                
</GIMUNZIP>                                                 
/*                                                          
//STEP4   EXEC PGM=IKJEFT01,DYNAMNBR=55          
//SYSPRINT DD SYSOUT=*                           
//SYSTSPRT DD SYSOUT=*                           
//STDOUT   DD SYSOUT=*                           
//STDERR   DD SYSOUT=*                           
//SYSIN    DD DUMMY                              
//SYSTSIN  DD *,SYMBOLS=EXECSYS                  
BPXBATCH SH rm -Rf &MYUSS/GIMZIP                 
BPXBATCH SH rm  &MYUSS/oneagentzos-&REL..pax     
//

Manual extraction

If you don't have access to the FTP server, follow the procedure below to extract the product installation datasets from the oneagentzos-R1nnnxx.pax file. In all cases below, R1nnnxx is the release number.

Procedure

Obtain the oneagentzos-R1nnnxx.pax file from Dynatrace Support or Sales Engineer.
Copy the oneagentzos-R1nnnxx.pax file to the desired USS directory.
Run pax -rvf oneagentzos-R1nnnxx.pax GIMZIP to unpack the installation files.
Use the EXTRACT job below to extract the product datasets from the installation files. Before running the job, modify the following:
1. Determine the desired high level qualifier for the install dataset names and set the HLQ variable accordingly.
2. Set MYUSS to the USS directory path where you placed oneagentzos-R1nnnxx.pax file.
3. Change the volume serial number VOLSER to match the site standards.

EXTRACT job


        zos/extract-pax.txt

Download

//EXTRACT JOB ('ACCTINFO'),'User name or comment',NOTIFY=&SYSUID,         
//             MSGLEVEL=(1,1),CLASS=A,MSGCLASS=X,REGION=0M,               
//             COND=(0,NE)                                                
//*                                                                       
//* This job extracts the product installation datasets from              
//* the installation files at <MYUSS>/GIMZIP to                           
//* <hlq>.<rel>.SZDT* libraries.                                          
//*                                                                       
//* Change the JOB card and the SET statements below to meet              
//* site standards.                                                       
//*                                                                       
//* Verify if the SMPCPATH and SMPJHOME DD below points to the            
//* correct PATH to meet site standards.                                  
//*                                                                       
//* WARNING!                                                              
//* This JCL must be in mixed case and sequence numbers are not allowed   
//*                                                                       
// EXPORT SYMLIST=*                                                       
// SET HLQ='DT'             <== HLQ of the target PDS datasets            
// SET REL='R119500'        <== Release number                            
// SET VOLSER='NSM001'      <== Volume of the target PDS datasets         
// SET MYUSS='/u/dt'        <== USS work directory                        
//STEP1    EXEC PGM=GIMUNZIP,PARM='HASH=YES'                              
//SMPDIR   DD PATH='&MYUSS/GIMZIP/',PATHDISP=KEEP                         
//SMPCPATH DD PATH='/usr/lpp/smp/classes/',PATHDISP=KEEP                  
//SMPJHOME DD PATH='/usr/lpp/java/J8.0/',PATHDISP=KEEP                    
//SMPOUT   DD SYSOUT=*                                                    
//SYSPRINT DD SYSOUT=*                                                    
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))                           
//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))                            
//SYSIN    DD *,SYMBOLS=EXECSYS                                           
<GIMUNZIP>                                     
  <ARCHDEF archid="AUTHLIB"                    
           replace="YES"                       
           volume="&VOLSER"                    
           newname="&HLQ..&REL..SZDTAUTH">     
  </ARCHDEF>                                   
                                               
  <ARCHDEF archid="LOAD"                       
           replace="YES"                       
           volume="&VOLSER"                    
           newname="&HLQ..&REL..SZDTLOAD">     
  </ARCHDEF>                                   
  <ARCHDEF archid="SAMPLE"                     
           replace="YES"                        
           volume="&VOLSER"                    
           newname="&HLQ..&REL..SZDTSAMP">     
  </ARCHDEF>                                   
</GIMUNZIP>                                    
/*                                             
//STEP2   EXEC PGM=IKJEFT01,DYNAMNBR=55        
//SYSPRINT DD SYSOUT=*                         
//SYSTSPRT DD SYSOUT=*                         
//STDOUT   DD SYSOUT=*                         
//STDERR   DD SYSOUT=*                         
//SYSIN    DD DUMMY                            
//SYSTSIN  DD *,SYMBOLS=EXECSYS                
BPXBATCH SH rm -Rf &MYUSS/GIMZIP               
//

If the job ends with a RC of 0, the installation has been successful. The installation process creates the following product datasets (the names are provided for the default high level qualifier and the R1nnnxx release version):

DT.R1nnnxx.SZDTAUTH: Contains zDC load modules, IMS and IMS Connect code modules of OneAgent.
DT.R1nnnxx.SZDTLOAD: Contains CICS code modules of OneAgent.
DT.R1nnnxx.SZDTSAMP: Includes sample JCL and CICS RDO definitions.

Note

Consider defining an alias without the version number for the product datasets. In that case you'll be able to install maintenance without updating the jobs for zDC, CICS and IMS installers.

Installed datasets and installation files in the USS directory take that much space:

Dsname                Tracks(3390) %Used
---------------------------------------
DT.R119500.SZDTAUTH   88            30
DT.R119500.SZDTLOAD   53            30
DT.R119500.SZDTSAMP  305            59

./GIMZIP/                   6Meg
./oneagentzos-R119500.pax   5Meg

Upgrade and maintenance

To upgrade the OneAgent for z/OS version or to install the maintenance, download the latest version of oneagentzos-R1nnnxx.pax installation file. Use any of the options above to install it.