Preparation
The preparation to the installation process consists of three stages:
- Receiving the product with the SMP/E (System
Modification Program/Extended) utility in dedicated PDSs.
This stage must be performed by the system staff who are accustomed to installing IBM products with SMP/E.
- Allocating a PDS file where all the installation and operation JCLs will be saved.
- Running the installation JCL from the PDS members that was created during the first stage.
Stage 1
Follow these steps to install the product from the extracted files:
1 - Download to Z/OS the sample JCLs provided.
Sample JCLs are provided: a JCL for the allocation of the compressed RELFILEs and SMPMCS files, as well as the SMP/E configuration and installation JCLs.
1.1 - Allocate the receiving file on Z/OS, either by parameterizing the JCL presented hereafter, or by directly creating it with all the required characteristics (tsouid represents the TSO user code).
//ALLOC1 EXEC PGM=IEFBR14
//*
//FTPALLO DD DSN=tsouid.HBVPxxx.SAMPLE.JCL.BIN,
// DISP=(NEW,CATLG,DELETE),
// DSORG=PS,RECFM=FB,LRECL=80,BLKSIZE=6160,
// SPACE=(TRK,(2,1)),UNIT=SYSALLDA
//* VOL=SER=&TVOL1
1.2 - Download the provided binary files to the Z/OS file that is already created.
To do so, perform an FTP transfer as follows:
1.2.1 - Copy the FTP sample command 'ftpini_model.scr' to a work directory and name it 'ftpini.scr'. Then, enter the parameters as it is explained in the file.
1.2.2 - Run the FTP command -s:ftpini.scr from the work directory.
2 - Extract the sample JCLs with the TSO command RECEIVE INDA('tsouid.HBVPxxx.SAMPLE.JCL.BIN').
This creates the tsouid.HBVPxxx.TMP.JCLINST file with the following members:
- BVPALLOC
- BVPMACC
- BVPMAPP
- BVPMREC
- BVPXMIT
- BVP1DCSI
- BVP2ICSI
- BVP3ALLO
- BVP4DEFZ
- BVP5DDEF
- BVP6DDEF
- BVP7ALLO
3 - Download the compressed RELFILEs and the SMPMCS.
3.1 - Parameterize and submit the BVPALLOC JCL contained in tsouid.HBVPxxx.TMP.JCLINST in order to allocate, on Z/OS, the files required for the download operations.
To do so, follow the instructions in the JCL.
3.2 - Download the provided binary files to the Z/OS files.
To do so, perform an FTP transfer as follows:
3.2.1 Copy the FTP sample command 'ftpput_model.scr' to a work directory and name it 'ftpput.scr'. Then, enter the parameters as it is explained in the file.
3.2.2 Run the FTP command -s:ftpput.scr from the work directory.
4 - Extract the RELFILEs files on Z/OS.
To do so, parameterize and submit the BVPXMIT JCL contained in tsouid.HBVPxxx.TMP.JCLINST
5 - You can then install the product with SMP/E using the JCLs contained in tsouid.HBVPxxx.TMP.JCLINST.
At the end of this first stage, all the components required for the installation are located in the following PDSs ; 'hlq' indicates the common prefix of the elements supplied (High-Level Qualifier):
- hlq.SBVPINST: all the 80-character-long files:
- The error messages file (BVPAE)
- The initial installation JCL (BVPMINIT)
- A file which contains the installation and operation JCLs and procedures (BVPMTTAL)
- The SMP/E sample JCLs
- The BVPAMIAM file that contains the parameters of the MIAM procedure
- hlq.SBVPMBR8: Load-modules for the migration procedures
- hlq.SBVMPF3: SG and SS skeletons
- hlq.SBVMPF4: SC skeleton
Stage 2
This stage is optional but recommended. It consists in allocating a PDS file with the following characteristics:
- Lrecl=80
- Size: around 100 tracks of a 3390 disk, 30 pads directory.
Stage 3
Stage 3 consists in copying the 'hlq.SBVPINST(BVPMINIT)' JCL to the PDS mentioned in stage 2, modifying its parameters to match the constraints of the site and running it to obtain the complete installation and operation JCL.
The BVPMINIT JCL runs the BVPMMJCL program loaded into the hlq.SBVPMBR8 PDS.
It must be completed as follows:
- Fill in '&hlq' with the value of the 'hlq' parameter used in the SMP/E first stage.
- In the '//SYSUT2 DD DSN=' field, enter the name of
the file into which the complete JCL is to be loaded.
This file can be either a PDS member initially created to receive all the JCLs, or a sequential file selected by the user.
- Enter the parameters.
The BVPMMJCL program execution must be saved. It can be used for a subsequent re-installation.