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.
- 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.
Manual extraction
If you don't have access to the FTP server from your z/OS environment, 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
- Connect to the FTP server from a Windows or Linux machine and download the
oneagentzos-R1nnnxx.pax
file in binary mode. If you can't connect to the FTP server from a Windows or Linux machine, obtain theoneagentzos-R1nnnxx.pax
file from Dynatrace Support or Sales Engineer.
- Upload 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:- Determine the desired high level qualifier for the install dataset names and set the
HLQ
variable accordingly. - Set
MYUSS
to the USS directory path where you placedoneagentzos-R1nnnxx.pax
file. - Change the volume serial number
VOLSER
to match the site standards.
- Determine the desired high level qualifier for the install dataset names and set the
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.
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.R121100.SZDTAUTH 520 5
DT.R121100.SZDTLOAD 261 6
DT.R121100.SZDTSAMP 184 97
./GIMZIP/ 8K
./oneagentzos-R121100.pax 5M
Upgrade and maintenance
Follow the procedure below to upgrade OneAgent for z/OS.
- Install the latest version of the OneAgent for z/OS modules from the
oneagentzos-R1nnnxx.pax
file usingFTPINSTL
orEXTRACT
jobs above - Update the zDC job, the DFHRPL in the CICS procedure, and the IMS code module injection job to point to the new distribution.
We recommend creating version independent ALIAS datasets for the product libraries. Use the ALIAS datasets in the zDC, CICS and IMS code module injection jobs. Whenever there is an upgrade, re-define the ALIAS to the new distribution.
For example:
DELETE 'DT.DYNTRC.SZDTAUTH' NOSCRATCH
DEFINE ALIAS(NAME('DT.DYNTRC.SZDTAUTH') RELATE('DT.R121100.SZDTAUTH'))
DELETE 'DT.DYNTRC.SZDTLOAD' NOSCRATCH
DEFINE ALIAS(NAME('DT.DYNTRC.SZDTLOAD') RELATE('DT.R121100.SZDTLOAD'))
See the NOTE below before deciding on if you are going to use the current z/OS version or a backlevel version with a bug fix on.
The product maintenance is provided as part of the latest oneagentzos-R1nnnxx.pax
file in the FTP server. The current JCL in this document will download the latest release that contains ALL maintenance.
If you wish to install a back-level release with a specific fix on it you must download the .pax file for that release. Where R1nnnxx has nnn as the release version and the xx is the fix version. This will only
give you fixes that are backported and NOT any new enhancements. You can browse the folder on our FTP site us-et-ftp01.dynatrace.com and choose the .pax file you wish to install then modify your JCL using this .pax file.
We suggest just using the most current one from the JCL above.
Refer to the steps 1 and 2 above to install the maintenance.
- The maintenance product installation will serve as a complete replacement of the existing product libraries
- Be aware that the most current version of the z/OS release can NOT be higher than the zRemote release (the nnn part of the release number) or the zDC and zRemote may not connect.