Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Follow the steps below to transfer the contents of the distribution file to the z/OS system.

Anchor
Extract the Installation Files
Extract the Installation Files

Extract the Installation Files

Each version of the Universal Agent for z/OS Installation distribution file is available in two formats:

...

This file (for example, sb-7.5.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.

Anchor
Transfer the Installation Files
Transfer the Installation Files

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.

Anchor
DFDSS Backup Distribution File - Transfer
DFDSS Backup Distribution File - Transfer

DFDSS Backup Distribution File

If you want to use UNVFTP.TXT (see the following illustration), begin by making the following changes:

...

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.

Anchor
Expanded Format Distribution File - Transfer
Expanded Format Distribution File - Transfer

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.

...

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.

Anchor
Receive the Installation Datasets
Receive the Installation Datasets

Receive the Installation Datasets

Anchor
DFDSS Backup Distribution File - Receive
DFDSS Backup Distribution File - Receive
DFDSS Backup Distribution File

Note
titleNote

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.

...

Panel
//UNVRECV  JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),NOTIFY=&SYSUID, 
//             COND=(0,NE),REGION=(0M) 
//********************************************************************* 
//* (C) COPYRIGHT 2000-2020 STONEBRANCH, INC.  ALL RIGHTS RESERVED. 
//* 
//* STONEBRANCH, INC. 
//* UNIVERSAL PRODUCTS 
//* 
//* UNVRECV 
//* 
//* DESCRIPTION 
//* ----------- 
//* PERFORM A TSO RECEIVE ON THE TRANSMITTED DISTRIBUTION DATA SET 
//* AND A DFHSMdss RESTORE TO PREPARE FOR INSTALLATION. 
//* 
//* ALL STEPS MUST END WITH RC 0. 
//* 
//* MODIFICATIONS 
//* ------------- 
//* 1  MODIFY THE JOB STATEMENT TO MEET LOCAL REQUIREMENTS. 
//* 
//* 2  CHANGE ALL '#HLQ' TO THE HIGH-LEVEL QUALIFIER OF THE 
//*    UNIVERSAL PRODUCTS DATA SETS. 
//* 
//* 3  CHANGE ALL '#VOLSER' TO THE VOLUME SERIAL NAME ON WHICH TO 
//*    ALLOCATE THE DISTRIBUTION DATA SETS. 
//********************************************************************* 
//* 
//DEL00    EXEC PGM=IDCAMS 
//SYSPRINT DD SYSOUT=* 
//SYSIN    DD * 
  DELETE #HLQ.UNV.V7R2M0.DIST 
  SET MAXCC=0 
/* 
//* 
//********************************************************************* 
//* RECEIVE DISTRIBUTION FILE 
//********************************************************************* 
//RECV     EXEC PGM=IKJEFT01 
//SYSLBC   DD  DISP=SHR,DSN=SYS1.BRODCAST 
//SYSPROC  DD  DUMMY 
//SYSPRINT DD  SYSOUT=* 
//SYSTSPRT DD  SYSOUT=* 
//SYSTERM  DD  SYSOUT=* 
//SYSTSIN  DD  * 
  RECEIVE INDA('#HLQ.UNV.V7R2M0.DIST.XMIT') 
    DA('#HLQ.UNV. V7R2M0.DIST') + 
    UNIT(SYSALLDA) VOL(#VOLSER) + 
    CYL SPACE(750 100) RELEASE 
/* 
//* 
//DEL01    EXEC PGM=IDCAMS 
//SYSPRINT DD SYSOUT=* 
//SYSIN    DD * 
  DELETE #HLQ.UNV.V7R2M0.INSTALL.UNLD 
  DELETE #HLQ.UNV.V7R2M0.SMPMCS 
  DELETE #HLQ.UNV.V7R2M0.TUAG720.* 
  DELETE #HLQ.UNV.V7R2M0.TUBR720.* 
  DELETE #HLQ.UNV.V7R2M0.TUCM720.* 
  DELETE #HLQ.UNV.V7R2M0.TUDM720.* 
  DELETE #HLQ.UNV.V7R2M0.TUEC720.* 
  DELETE #HLQ.UNV.V7R2M0.TUEM720.* 
  DELETE #HLQ.UNV.V7R2M0.TUNV720.* 
  DELETE #HLQ.UNV.V7R2M0.TUSD620.* 
  DELETE #HLQ.UNV.V7R2M0.TUSP620.* 
  DELETE #HLQ.UNV.V7R2M0.TUTL720.* 
  DELETE #HLQ.UNV.V7R2M0.TUXD720.* 
  DELETE #HLQ.UNV.V7R2M0.UUBR720.* 
  DELETE #HLQ.UNV.V7R2M0.UUCM720.* 
  DELETE #HLQ.UNV.V7R2M0.UUDM720.* 
  DELETE #HLQ.UNV.V7R2M0.UUEM720.* 
  DELETE #HLQ.UNV.V7R2M0.UUNV720.* 
  DELETE #HLQ.UNV.V7R2M0.UUTL720.* 
  SET MAXCC=0 
/* 
//* 
//********************************************************************* 
//* RESTORE BACKUP  
//********************************************************************* 
//RESTORE  EXEC PGM=ADRDSSU 
//IN1      DD DISP=SHR, 
//            DSN=#HLQ.UNV.V7R2M0.DIST 
//OUT1     DD DISP=SHR, 
//            UNIT=SYSALLDA,VOL=SER=#VOLSER 
//SYSPRINT DD SYSOUT=* 
//SYSIN    DD * 
  RESTORE INDD(IN1) - 
          DS(INCL(**)) - 
          OUTDD(OUT1) - 
          CATALOG - 
          RENAMEUNCONDITIONAL(SBI.**,#HLQ.**) 
/* 
//* 
//DEL02    EXEC PGM=IDCAMS 
//SYSPRINT DD SYSOUT=* 
//SYSIN    DD * 
  DELETE #HLQ.UNV.V7R2M0.INSTALL 
  SET MAXCC=0 
/* 
//* 
//********************************************************************* 
//* RELOAD INSTALL JCL LIBRARY FROM SEQUENTIAL BACKUP 
//********************************************************************* 
//RELOAD   EXEC PGM=IEBCOPY 
//IN1      DD DISP=OLD, 
//            DSN=#HLQ.UNV.V7R2M0.INSTALL.UNLD 
//OUT1     DD DSN=#HLQ.UNV.V7R2M0.INSTALL, 
//            DISP=(,CATLG), 
//            DCB=(DSORG=PO,RECFM=FB,LRECL=80,BLKSIZE=3120), 
//            SPACE=(TRK,(15,10,10)), 
//            UNIT=SYSALLDA,VOL=SER=#VOLSER 
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1)) 
//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1)) 
//SYSPRINT DD SYSOUT=* 
//SYSIN    DD * 
  COPY I=(IN1),O=OUT1 
/* 
//* 

Anchor
Expanded Format Distribution File - Receive
Expanded Format Distribution File - Receive

Expanded Format Distribution File

Note
titleNote

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.

...