z/OS Installation - Transferring Installation Files to z/OS
Overview
After downloading the distribution file to your workstation, you must extract the files and transfer them to the z/OS system, upon which Universal Agent for z/OS will be installed.
Transferring the Installation Files
Follow the steps below to transfer the contents of the distribution file to the z/OS system.
1 | Extract the installation files from the distribution file. |
|---|---|
2 | |
3 |
Extract the Installation Files
Each version of the Universal Agent for z/OS Installation distribution file is available in two formats:
- Compressed archive
- Compressed .zip file
The contents of both files are the same. The different formats are provided for flexibility.
Compressed Archive
This file may be decompressed using any utility that can process files in Lempel-Ziv (that is, compress) format. The contents of the decompressed file can be extracted using tar.
For example, use the following to decompress and extract the 7.2.0.0 Universal Agent for z/OS distribution file that contains the DFDSS backup on a UNIX-based system:
zcat sb-7.2.0.0-zos.tar.Z | tar xvf -
Similarly, use the following to decompress and extract the 7.2.0.0 Universal Agent for z/OS distribution file that contains the expanded archive of SMP/E installation datasets:
zcat sb-7.2.0.0-EXP-zos.tar.Z | tar xvf -
ZIP Archive
This file (for example, sb-7.2.0.0-zos.zip) can be decompressed using any utility that can process files in ZIP (or PKZIP) format. To unzip the file, use a third-party ZIP-based extraction application or the native Windows file extraction tool available from Windows Explorer. For example, to extract the files using Windows' File Explorer (or just Windows Explorer in some older Windows versions), right-click on the file name, select Extract All from the pop-up menu, and follow the instructions.
Transfer the Installation Files
For the .XMT file(s), a binary transfer must be performed; otherwise, the XMIT dataset(s) will not unpack correctly. For the .JCL file, text transfer must be performed.
Due to the numerous file transfer products available on the market, it is impractical to provide instructions for them all. FTP is one of the most popular, and the UNVFTP.TXT file included in the distribution file is a sample script that can be used as a reference to customize the transfer to your environment.
DFDSS Backup Distribution File
If you want to use UNVFTP.TXT (see the following illustration), begin by making the following changes:
Step 1 | Change #HOSTNAME to the z/OS host name or IP address. |
|---|---|
Step 2 | Change #USERNAME to a z/OS user ID that has updated access to the XMIT datasets being updated. |
Step 3 | Change #PASSWORD to the z/OS user ID's password. |
Step 4 | Change #HLQ to the data set high level qualifier used to allocate the XMIT datasets. |
Execute the script with FTP using whatever options the FTP client supports for reading command files. Most FTP clients support redirection from STDIN.
Carefully review the FTP output to confirm that each of the files are transferred successfully.
After uploading, review the comments contained in '#HLQ.UNV.V7R2M0.RECV.JCL' and make the necessary changes. Submit the job to receive and restore the install file.
Expanded Format Distribution File
The steps to transfer the Expanded Format version of the distribution file are the same as for the DFDSS Backup distribution file (see the following illustration). However, the UNVFTP.TXT sample provided in that file allocates and uploads each SMP/E install file separately.
Step 1 | Change #HOSTNAME to the z/OS host name or IP address. |
|---|---|
Step 2 | Change #USERNAME to a z/OS user ID that has updated access to the XMIT datasets being updated. |
Step 3 | Change #PASSWORD to the z/OS user ID's password. |
Step 4 | Change #HLQ to the data set high level qualifier used to allocate the XMIT datasets. |
Step 5 | Optional; Change #VOLSER to a volume upon which the *.XMT files provided in the Expanded Format version of the distribution file should reside. |
Execute the script with FTP using whatever options the FTP client supports for reading command files. Most FTP clients support redirection from STDIN.
Carefully review the FTP output to confirm that each of the files are transferred successfully.
After uploading, review the comments contained in '#HLQ.UNV.V6R7M0.RECV.JCL' and make the necessary changes. Submit the job to receive and restore the install file.
Receive the Installation Datasets
DFDSS Backup Distribution File
Note
The following instructions apply to the version of the distribution file that contains the DFDSS backup. See Expanded Format Distribution File, below, for information on processing the other version of the distribution file.
After transferring the installation file to z/OS, you must unpack them using the JCL uploaded from UNVRECV.JCL (which should now reside in #HLQ.UNV.V6R7M0.RECV.JCL). The following illustration shows the statements contained in UNVRECV.JCL. The job performs a TSO RECEIVE on the UNV720.XMT file uploaded by UNVFTP.TXT. It then executes a DFDSS restore on the transmitted data set to extract the packaged files.
The JCL includes a MODIFICATIONS section at the beginning of the file that describes what JCL modifications are required prior to submitting the job. Read and complete each of the listed modifications.
Submit the job on z/OS. Return code 0 is expected.
After the data set is successfully unpacked, it is longer required and can be deleted. The files then are ready to be installed.
Expanded Format Distribution File
Note
The following instructions apply to the Expanded Format version of the distribution file that contains the each of the SMP/E datasets separately. See DFDSS Backup Distribution File, above, for information on processing the version of the distribution file that provides the SMP/E install datasets packaged inside a DFDSS backup.
After transferring the installation files to z/OS, you must receive them using the JCL uploaded from UNVRECV.JCL (which should now reside in #HLQ.UNV.V6R7M0.RECV.JCL). The following illustration shows the statements contained in UNVRECV.JCL. The job performs a TSO RECEIVE on each of the files uploaded by UNVFTP.TXT.
The JCL includes a MODIFICATIONS section at the beginning of the file that describes what JCL modifications are required prior to submitting the job. Read and complete each of the listed modifications.
Submit the job on z/OS. Return code 0 is expected.
After the datasets are successfully received, the *.XMIT files are no longer required and can be deleted. The files then are ready to be installed.