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.6.0.0 Universal Agent for z/OS distribution file that contains the DFDSS backup on a UNIX-based system:
zcat sb-7.6.0.0-zos.tar.Z | tar xvf -
Similarly, use the following to decompress and extract the 7.6.0.0 Universal Agent for z/OS distribution file that contains the expanded archive of SMP/E installation datasets:
zcat sb-7.6.0.0-EXP-zos.tar.Z | tar xvf -
ZIP Archive
This file (for example, sb-7.6.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. |
open #HOSTNAME
user #USERNAME #PASSWORD
ascii
quote site blksize=3120 recfm=fb lrecl=80 pri=1 sec=1 cyl
put UNVRECV.JCL '#HLQ.UNV.V7R2M0.RECV.JCL'
;Uncomment these lines when transferring from a
;Unix- or Windows-based system.
;put ascii/UNVRECV/JCL '#HLQ.UNV.V7R2M0.RECV.JCL'
bin
quote site blksize=3120 recfm=fb lrecl=80 pri=1000 sec=100 cyl
put UNV720.XMT '#HLQ.UNV.V7R2M0.DIST.XMIT'
quit
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. |
open #HOSTNAME
user #USERID #PSWD
ascii
quote site blksize=3120 recfm=fb lrecl=80 pri=1 sec=1 track
put UNVRECV.JCL '#HLQ.UNV.V7R2M0.RECV.JCL'
;Uncomment these lines when transferring from a
;Unix- or Windows-based system.
;put ascii/UNVRECV.JCL '#HLQ.UNV.V7R2M0.RECV.JCL'
cd '#HLQ.UNV.V6R7M0'
bin
quote site blksize=3120 recfm=fb lrecl=80 cyl unit=sysallda vol=#VOLSER
quote site pri=1 sec=1
del INSTALL.XMIT
put INSTALL.XMT INSTALL.XMIT
quote site pri=10 sec=10
del SMPMCS.XMIT
put SMPMCS.XMT SMPMCS.XMIT
quote site pri=1 sec=1
del TUNV720.F1.XMIT
put UNV720F1.XMT TUNV720.F1.XMIT
quote site pri=1
del TUTL720.F1.XMIT
put UTL720F1.XMT TUTL720.F1.XMIT
quote site pri=70
del TUTL720.F2.XMIT
put UTL720F2.XMT TUTL720.F2.XMIT
quote site pri=1
del TUBR720.F1.XMIT
put UBR720F1.XMT TUBR720.F1.XMIT
quote site pri=1
del TUBR720.F2.XMIT
put UBR720F2.XMT TUBR720.F2.XMIT
quote site pri=120
del TUBR720.F3.XMIT
put UBR720F3.XMT TUBR720.F3.XMIT
quote site pri=1
del TUCM720.F1.XMIT
put UCM720F1.XMT TUCM720.F1.XMIT
quote site pri=1
del TUCM720.F2.XMIT
put UCM720F2.XMT TUCM720.F2.XMIT
quote site pri=45
del TUCM720.F3.XMIT
put UCM720F3.XMT TUCM720.F3.XMIT
quote site pri=1
del TUDM720.F1.XMIT
put UDM720F1.XMT TUDM720.F1.XMIT
quote site pri=1
del TUDM720.F2.XMIT
put UDM720F2.XMT TUDM720.F2.XMIT
quote site pri=55
del TUDM720.F3.XMIT
put UDM720F3.XMT TUDM720.F3.XMIT
quote site pri=1
del TUEM720.F1.XMIT
put UEM720F1.XMT TUEM720.F1.XMIT
quote site pri=1
del TUEM720.F2.XMIT
put UEM720F2.XMT TUEM720.F2.XMIT
quote site pri=55
del TUEM720.F3.XMIT
put UEM720F3.XMT TUEM720.F3.XMIT
quote site pri=120
del TUXD720.F1.XMIT
put UXD720F1.XMT TUXD720.F1.XMIT
quote site pri=1
del TUAG720.F1.XMIT
put UAG720F1.XMT TUAG720.F1.XMIT
quote site pri=1
del TUAG720.F2.XMIT
put UAG720F2.XMT TUAG720.F2.XMIT
quote site pri=40
del TUAG720.F3.XMIT
put UAG720F3.XMT TUAG720.F3.XMIT
quote site pri=1
del TUEC720.F1.XMIT
put UEC7200F1.XMT TUEC720.F1.XMIT
quote site pri=70
del TUEC720.F2.XMIT
put UEC720F2.XMT TUEC720.F2.XMIT
quote site pri=20
del TUSD620.F1.XMIT
put USD620F1.XMT TUSD620.F1.XMIT
quote site pri=1
del TUSP620.F1.XMIT
put USP620F1.XMT TUSP620.F1.XMIT
quote site pri=1
del TUSP620.F2.XMIT
put USP620F2.XMT TUSP620.F2.XMIT
quote site pri=15
del TUSP620.F3.XMIT
put USP620F3.XMT TUSP620.F3.XMIT
quote site pri=1
del UUNV720.F1.XMIT
put UNV720U1.XMT UUNV720.F1.XMIT
quote site pri=1
del UUBR720.F1.XMIT
put UBR720U1.XMT UUBR720.F1.XMIT
quote site pri=50
del UUBR720.F2.XMIT
put UBR720U2.XMT UUBR720.F2.XMIT
quote site pri=1
del UUCM720.F1.XMIT
put UCM720U1.XMT UUCM720.F1.XMIT
quote site pri=30
del UUCM720.F2.XMIT
put UCM720U2.XMT UUCM720.F2.XMIT
quote site pri=1
del UUDM720.F1.XMIT
put UDM720U1.XMT UUDM720.F1.XMIT
quote site pri=30
del UUDM720.F2.XMIT
put UDM720U2.XMT UUDM720.F2.XMIT
quote site pri=1
del UUEM720.F1.XMIT
put UEM720U1.XMT UUEM720.F1.XMIT
quote site pri=30
del UUEM720.F2.XMIT
put UEM720U2.XMT UUEM720.F2.XMIT
quote site pri=70
del UUTL720.F1.XMIT
put UTL720U1.XMT UUTL720.F1.XMIT
quit
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.