Download z/OS product datasets
You can download the PAX file containing the CICS, IMS, z/OS Java, and zDC modules in two ways:
- Dynatrace version 1.272+ Download via Deployment API.
- Dynatrace version 1.276+ Download via web UI.
Starting with OneAgent release 1.277, the PAX file will no longer be published on our FTP server.
Download the PAX file
You can download the latest or a specific PAX file version via web UI or the Deployment API of OneAgent.
The PAX file version must be equal to or lower than the zRemote module version.
Download latest version via web UI
-
In the Dynatrace menu, go to Deploy Dynatrace and select Start installation.
-
Select z/OS and Download z/OS product datasets to download the latest PAX file version.
The file name
dynatrace-zos-1.nnn.m.pax
includes the major release versionnnn
andm
minor.
Download a specific version via web UI
You can download a specific PAX file version via web UI as follows:
-
In the Dynatrace menu, go to Settings and select Monitoring > Monitoring oveview.
-
Select Download Dynatrace OneAgent or ActiveGate installer and define your preferred version:
- Installer:
OneAgent - z/OS
- Build: Select your preferred major version
- Revision: Select your preferred minor version
- Installer:
-
Select Continue and Download z/OS product datasets to download your defined PAX file version.
The file name
dynatrace-zos-1.nnn.m.pax
includes the major release versionnnn
andm
minor.
Download latest version via Deployment API
You can download the latest PAX file version via Deployment API as follows:
-
Generate an Access token with the scope PaaS integration - Installer download (
InstallerDownload
). -
Download the latest PAX file via Deployment API - Download latest OneAgent:
HTTP method Dynatrace environment Endpoint GET
SaaS
https://{your-environment-id}.live.dynatrace.com/api/v1/deployment/installer/agent/zos/mainframe/latest
GET
Managed
https://{your-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/zos/mainframe/latest
Below is a sample
curl
command for a SaaS environment that uses the Deployment API to download the latest PAX file version:curl -X GET "https://<environment>.live.dynatrace.com/api/v1/deployment/installer/agent/zos/mainframe/latest" -H "accept: */*" -H "Authorization: Api-Token <accessToken>" --output dynatrace-zos.pax
Replace
<environment>
with your Dynatrace environment ID and<accessToken>
with your generated access token.
Download a specific version via Deployment API
You can download a specific PAX file version via Deployment API as follows:
-
Generate an Access token with the scope PaaS integration - Installer download (
InstallerDownload
). -
List all available PAX file versions via Deployment API - List available versions of OneAgent.
HTTP method Dynatrace environment Endpoint GET
SaaS
https://{your-environment-id}.live.dynatrace.com/api/v1/deployment/installer/agent/versions/zos/mainframe
GET
Managed
https://{your-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/versions/zos/mainframe
Below is a sample
curl
command for a SaaS environment that uses the Deployment API to list all available PAX file versions:curl -X GET "https://<environment>.live.dynatrace.com/api/v1/deployment/installer/agent/versions/zos/mainframe" -H "accept: */*" -H "Authorization: Api-Token <accessToken>"
Replace
<environment>
with your Dynatrace environment ID and<accessToken>
with your generated access token. -
Download a specific PAX file version via Deployment API - Download OneAgent of specific version:
HTTP method Dynatrace environment Endpoint GET
SaaS
https://{your-environment-id}.live.dynatrace.com/api/v1/deployment/installer/agent/zos/mainframe/version/{version}
GET
Managed
https://{your-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/zos/mainframe/version/{version}
Below is a sample
curl
command for a SaaS environment that uses the Deployment API to download a specific PAX file version:curl -X GET "https://<environment>.live.dynatrace.com/api/v1/deployment/installer/agent/zos/mainframe/version/<version>" -H "accept: */*" -H "Authorization: Api-Token <accessToken>" --output dynatrace-zos.pax
Replace
<environment>
with your Dynatrace environment ID,<version>
with your selected PAX file version, and<accessToken>
with your generated access token.
Extract product datasets
You can extract the product datasets from the PAX file as follows:
-
Transfer the PAX file to your z/OS USS directory in binary mode.
-
Rename the PAX file from
dynatrace-zos-1.nnn.m.pax
todynatrace-zos.pax
. -
Run
pax -rvf dynatrace-zos.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 z/OS USS directory path where you placed thedynatrace-zos.pax
file. - Change the volume serial number
VOLSER
to match site standards.
If the job ends with a return code of
0
, the extraction was successful. - Determine the desired high-level qualifier for the install dataset names and set the
Product datasets
The extraction process creates the following product datasets (the names are provided for the default high-level qualifier and the R1nnnx
release version):
DT.R1nnnx.SZDTAUTH
: Contains the zDC subsystem and the IMS module including IMS ConnectDT.R1nnnx.SZDTLOAD
: Contains the CICS moduleDT.R1nnnx.SZDTSAMP
: Includes sample JCL and CICS RDO definitions
Define aliases
We recommend defining an ALIAS
without the version number for the product datasets. Use these ALIAS
in the zDC, CICS, and IMS module injection jobs. You can then perform maintenance without updating the jobs.
For example:
DEFINE ALIAS(NAME('DT.DYNTRC.SZDTAUTH') RELATE('DT.R12710.SZDTAUTH'))
DEFINE ALIAS(NAME('DT.DYNTRC.SZDTLOAD') RELATE('DT.R12710.SZDTLOAD'))