This chapter describes the tasks required to install ELS software. It includes the following topics:
Before installing ELS, verify ELS requirements and review pre-installation considerations. See "Preparing for Installation" for more information.
Perform the following steps to verify that you have completed all ELS installation tasks:
Note:
Before installing ELS, verify ELS requirements and review pre-installation considerations. See "Preparing for Installation" for more information.Unload the SMP/E JCL library from ZIP file, or CD-ROM.
See "Unloading the SMP/E JCL Library" for more information.
Optionally, edit the CHGIT
member according to your requirements.
Use sample member CHGIT
.
See "Editing the CHGIT Member" for more information.
Test the CHGIT
member to verify your edits.
Use sample member I20TST
.
See "Testing the CHGIT Member" for more information.
Define and initialize the SMP/E CSI.
Use sample member I30CSI
.
See "Defining and Initializing the ELS Global SMP/E Consolidated Software Inventory (CSI)" for more information.
Allocate the ELS and JES3 target and distribution library data sets and their required DDDEF entries.
Use sample member I40ZON
.
See "Allocating Target and Distribution Library Data Sets and Required DDDEF Entries" for more information.
Update the SYSLIB
concatenation.
Use sample member I50LIB
.
See "Updating the SYSLIB Concatenation" for more information.
Review the ELS FMIDs.
See "Reviewing the ELS FMIDs" for more information.
SMP/E RECEIVE
the desired base functions, communication functions, and optionally, the SMC JES3 function. Use sample member I60RNTS
.
See "Receiving the ELS Functions" for more information.
SMP/E APPLY
the desired base functions, communication functions, and optionally, the SMC JES3 function.
Use sample member I70APP
.
See "Applying the ELS Functions" for more information.
SMP/E ACCEPT
the desired base functions, communication functions, and optionally, the SMC JES3 function.
Use sample member I80ACC
.
See "Accepting the ELS Functions" for more information.
SMP/E RECEIVE
maintenance for the ELS base functions.
Use sample member MAINTRCF
.
See "SMP/E RECEIVE Maintenance" for more information.
SMP/E APPLY
maintenance for the ELS base functions.
Use sample member MAINTAPF
.
See "SMP/E APPLY Maintenance" for more information.
Optionally, SMP/E ACCEPT
maintenance for the base functions.
Use sample member MAINTACF
.
See "SMP/E ACCEPT Maintenance" for more information.
Proceed with ELS post-installation tasks. See "Performing ELS Post Installation Tasks" for more information.
Proceed with ELS additional software post-installation tasks. See "Performing Post Installation Tasks for ELS Additional Software" for more information.
To begin ELS installation, unload the SMP/E JCL library from the ELS installation ZIP file or CD-ROM. This library includes JCL sample members used to prepare your installation environment and install the ELS functions and associated maintenance.
The following sample members are included:
CHGIT
Optional REXX exec used to customize ELS installation sample members
I20TST
Test and verify CHGIT
settings.
I30CSI
Define and initialize the ELS Global SMP/E CSI.
I40ZON
Allocate target and distribution data sets for ELS (and additional software) and define the appropriate DDDEF entries in the SMP/E CSI.
Allocate ELS (and optionally, JES3) target and distribution data sets and define the appropriate DDDEF entries in the SMP/E CSI.
I50LIB
Add required DDDEF entries and modify the SYSLIB concatenation.
I60RNTS
SMP/E RECEIVE
ELS and additional functions from the ELS installation ZIP file or CD-ROM.
I70APP
SMP/E APPLY
ELS and additional functions.
I80ACC
SMP/E ACCEPT
ELS and additional functions.
MAINTACF
SMP/E ACCEPT
maintenance in a mass mode for specific FMIDs.
MAINTAPF
SMP/E APPLY
maintenance in mass mode for specific FMIDs.
MAINTRCF
SMP/E RECEIVE
maintenance for a specific FMID.
To unload the SMP/E JCL library from the ELS installation ZIP file:
Establish network connectivity between your PC, MVS Host, and UNIX Systems Services (USS).
Extract the contents of the ELS Installation ZIP file.
Open the file README.html.
Follow the on-screen instructions to unload the SMP/E JCL library.
Note:
Many of the on-screen command examples can be cut and pasted from your browser window to your terminal window.To unload the SMP/E JCL library from the ELS installation CD-ROM:
Establish network connectivity between your PC, MVS Host, and UNIX Systems Services (USS).
Insert the ELS Installation CD-ROM into the CD-ROM drive of your PC.
Navigate to the root directory of your CD-ROM drive and open the file README.html. (This will open automatically on some systems.)
Follow the on-screen instructions to unload the SMP/E JCL library.
Note:
Many of the on-screen command examples can be cut and pasted from your browser window to your terminal window.The CHGIT
member in the SMP/E JCL library includes typical ISPF edit commands used to customize the ELS installation sample members according to your requirements.
CHGIT
enables you to edit installation settings and apply them to the sample members used to install the ELS functions. CHGIT
runs as an optional REXX exec.
To edit the CHGIT
member:
Edit the CHGIT
member according to the instructions commented in the sample member and save your changes.
Copy CHGIT
into your SYSEXEC
concatenation to enable CHGIT
to be executed as a command.
Alternatively, you can enable CHGIT
by issuing the following TSO commands:
TSO allocate dd(SYSUEXEC) shr dsn(your.ELS73.SAMPLES.JCL)
TSO altlib activate user(exec)
Supply the REUSE
keyword if you intend to override a preexisting allocation of SYSUEXEC
.
Note:
Though the use ofCHGIT
is recommended, it is optional. You may choose to edit each installation sample individually using an editor. In this case, CHGIT
can serve as a guide.Use sample member I20TST
(included in your SMP/E JCL library) to test and verify your CHGIT
edits.
Enter Edit mode for member I20TST
, and execute the CHGIT
command.
Submit the I20TST
job.
If the job is successful, the CHGIT
member is ready to be applied to the remaining ELS installation jobs.
If errors are encountered, edit the CHGIT
member to correct the errors, and submit it again.
This section describes how to prepare the SMP/E environment for installation of the ELS base functions and SMC JES3 support function. If you are installing service, see Chapter 3, "Installing ELS Maintenance" for more information.
ELS products are installed using SMP/E. The SMP/E installation process involves a RECEIVE
, APPLY
, and ACCEPT
job to install functions into the correct SMP/E target and distribution zones.
The following are SMP/E considerations:
ELS must be installed with SMP/E. All installation instructions in this guide are based on SMP/E.
If you are installing ELS from CD, SMP/E version 3 Release 1 or higher is required to install ELS from the UNIX Systems Services (USS) platform. Additionally, you must have access to USS with read and write permissions.
Install all ELS 7.3 product components in a new target and distribution SMP/E CSI.
Do not install products from other vendors in the same global SMP/E CSI as ELS.
SMP/E ACCEPT
all of your ELS base products.
Load modules for the TMS (Tape Management System) interface routines (SLUDRCA1
, SLUDRRMM
, SLUDRSMC
, SLUDRTLM
, and SLUDRZAR
) are included in the SEALINK
library generated during ELS installation. These modules are shared among HSC, SMC, and MVS/CSC.
Additionally, consider the following warnings:
If you install an ELS 7.3 product component in an existing global SMP/E CSI containing a previous release of that product, all SYSMODS for the previous release (except for those related to SAS/C) are deleted from the SMP/E CSI.
It is recommended that you back up the existing global SMP/E CSI before installing the ELS 7.3 product components.
If you install LibraryStation 7.3 or MVS/CSC 7.3 in an existing global SMP/E CSI where a previous release of LibraryStation or MVS/CSC has been installed, it is not necessary to re-install the SAS/C functions (FMIDs SSCR70C
and SSCR70D
).
Do not install LibraryStation 7.3 or MVS/CSC 7.3 and supportive SAS/C functions in a global SMP/E CSI containing other StorageTek products with SAS/C functions you want to preserve. Doing so may cause unpredictable results.
Use sample member I30CSI
(included in your SMP/E JCL library) to define and initialize the ELS global Consolidated Software Inventory (CSI).
This job performs the following actions:
Defines the required SMP/E data sets.
Defines the Consolidated Software Inventory (CSI) data set that contains the SMP/E global, target, and distribution zones for this release.
Initializes the SMP/E CSI.
Adds zones, options, utilities, and DDDEF entries to the SMP/E CSI.
To run the I30CSI
job:
Enter Edit mode for member I30CSI
, and execute the CHGIT
command to apply your CHGIT
edits.
Submit the I30CSI
job.
Note:
Though the use ofCHGIT
is recommended, it is optional. If you choose not to use CHGIT
, follow the instructions in the prologue of the I30CSI
sample member, edit as needed, and submit the job.Use sample member I40ZON
(included in your SMP/E JCL library) to allocate target and distribution data sets and define the appropriate DDDEF entries in the SMP/E CSI. Table 2-1, "ELS Target Library Data Sets" and Table 2-2, "ELS Distribution Library Data Sets" list the target and distribution library data sets for ELS and additional software.
To run the I40ZON
job:
Enter Edit mode for member I40ZON
, and execute the CHGIT
command to apply your CHGIT
edits.
Submit the I40ZON
job.
Consider the following:
Though the use of CHGIT
is recommended, it is optional. If you choose not to use CHGIT
, follow the instructions in the prologue of the I40ZON
sample member, edit as needed, and submit the job.
If you install an ELS 7.3 product component in an existing global SMP/E CSI containing a previous release of that product:
SMPCSI
statement must point to the existing global CSI.
SMPLOG
and SMPLOGA
statements must point to the global log.
SMPPTS
statement must point to the global SMPPTS.
If you are using PDS instead of PDSE (Partitioned Data Set Extended), increase directory blocks for SEAMAC
and ASEAMAC
to 50.
The following tables list the target and distribution library data sets allocated by the I40ZON
job.
Note:
hlq represents the high-level qualifier for your data sets. Choose a high-level qualifier that conforms to the naming conventions defined for your installation.
The numbers listed for directory blocks and blocks are the minimum required for the product.
The numbers listed for directory blocks and blocks are the minimum required for the product.
The SMP/E DSSPACE
parameter, which specifies the amount of space to be allocated to temporary RELFILE
data sets, must be set to at least (300,150,270).
The following table lists the target library data sets allocated by the I40ZON
job:
Table 2-1 ELS Target Library Data Sets
Data Set Name | Product(s) | DSORG | RECFM | LRECL | BLKSIZE | Blocks (Pri/Sec) | Directory Blocks |
---|---|---|---|---|---|---|---|
hlq.SEALINK |
ELS |
PO |
U |
N/A |
32760 |
500/50 |
99 |
hlq.SEAMAC |
ELS |
PO-E |
FB |
80 |
27920 |
20/10 |
5 |
hlq.SEASAMP |
ELS |
PO-E |
FB |
80 |
27920 |
20/10 |
5 |
hlq.SMZLINK |
SMC JES3 |
PO |
U |
N/A |
32760 |
20/10 |
5 |
hlq.LCMLINK |
LCM |
PO-E |
U |
N/A |
32760 |
2504/250 |
5 |
hlq.LCMSAMP |
LCM |
PO-E |
FB |
80 |
27920 |
25/25 |
5 |
hlq.LCMGUI |
LCM |
PO |
U |
N/A |
32760 |
198/500 |
5 |
hlq.SCSLINK |
MVS/CSC |
PO |
U |
N/A |
32760 |
500/100 |
100 |
hlq.SCSMAC |
MVS/CSC |
PO-E |
FB |
80 |
27920 |
30/10 |
5 |
hlq.SCSSAMP |
MVS/CSC |
PO-E |
FB |
80 |
27920 |
30/10 |
5 |
hlq.SLCLINK |
LibraryStation |
PO |
U |
N/A |
32760 |
500/100 |
50 |
hlq.SLCSAMP |
LibraryStation |
PO-E |
FB |
80 |
27920 |
30/10 |
5 |
hlq.CSLLINK |
MVS/CSC LibraryStation |
PO |
U |
N/A |
32760 |
50/10 |
20 |
hlq.SACLINK |
MVS/CSC LibraryStation |
PO |
U |
N/A |
32760 |
200/10 |
100 |
Note:
If you are using PDS instead of PDSE (Partitioned Data Set Extended), increase directory blocks forASEAMAC
to 50.The following table lists the distribution library data sets allocated by the I40ZON
job:
Table 2-2 ELS Distribution Library Data Sets
Data Set Name | Product(s) | DSORG | RECFM | LRECL | BLKSIZE | Blocks (Pri/Sec) | Directory Blocks |
---|---|---|---|---|---|---|---|
hlq.ASEALINK |
ELS |
PO |
U |
N/A |
32760 |
500/50 |
999 |
hlq.ASEAMAC |
ELS |
PO-E |
FB |
80 |
27920 |
20/10 |
5 |
hlq.ASEASAMP |
ELS |
PO-E |
FB |
80 |
27920 |
20/10 |
5 |
hlq.ASMZLINK |
SMC JES3 |
PO |
U |
N/A |
32760 |
20/10 |
5 |
hlq.ALCMLINK |
LCM |
PO-E |
U |
N/A |
32760 |
2504/250 |
5 |
hlq.ALCMSAMP |
LCM |
PO-E |
FB |
80 |
27920 |
25/25 |
5 |
hlq.ALCMGUI |
LCM |
PO |
U |
N/A |
32760 |
198/500 |
5 |
hlq.ASCSLINK |
MVS/CSC |
PO |
U |
N/A |
32760 |
500/100 |
100 |
hlq.ASCSMAC |
MVS/CSC |
PO-E |
FB |
80 |
27920 |
30/10 |
5 |
hlq.ASCSSAMP |
MVS/CSC |
PO-E |
FB |
80 |
27920 |
30/10 |
5 |
hlq.ASLCLINK |
LibraryStation |
PO |
U |
N/A |
32760 |
500/100 |
50 |
hlq.ASLCSAMP |
LibraryStation |
PO-E |
FB |
80 |
27920 |
30/10 |
5 |
hlq.ACSLLINK |
MVS/CSC LibraryStation |
PO |
U |
N/A |
32760 |
50/10 |
20 |
hlq.ASACLINK |
MVS/CSC LibraryStation |
PO |
U |
N/A |
32760 |
200/10 |
100 |
Note:
If you are using PDS instead of PDSE (Partitioned Data Set Extended), increase directory blocks forASEAMAC
to 50.ELS supports different versions of MVS/ESA JES3 and multiple tape management systems. For example, TLMS and CA-1.
Use sample member I50LIB
(included in your SMP/E JCL library) to add required DDDEF entries to the SMP/E CSI, and modify the SYSLIB concatenation to include the appropriate macro libraries.
To run the I50LIB
job:
Enter Edit mode for member I50LIB
and execute the CHGIT
command to apply your CHGIT
edits.
Submit the I50LIB
job.
The return code must be 4 or less for all steps executed in this job. If you receive a different return code, contact StorageTek Software Support.
Note:
Though the use of CHGIT
is recommended, it is optional. If you choose not to use CHGIT
, follow the instructions in the prologue of the I50LIB
sample member, edit as needed, and submit the job.
If you install an ELS 7.3 product component in an existing global SMP/E CSI containing a previous release of that product, the SMPCSI statement must point to the existing global CSI.
ELS is packaged in standard SMP/E format, and is delivered as multiple function SYStem MODifications (SYSMODs) identified by the following SMP/E FMIDs:
SSEA730
This FMID includes HSC, SMC, VTCS and CDRT load modules, distributed macros, and samples.
SMZ7300
This FMID includes SMC JES3 support load modules, distributed macros, and samples for MVS systems running JES3 Release 5.2.1, JES3 OS/390 Release 1.1 and higher, or JES3 z/OS Release 1.0 and higher.
SLM7300
This FMID includes LCM 7.2 load modules, distributed macros, and samples.
SOC7300
This FMID includes LibraryStation load modules and samples.
SCS7300
This FMID includes MVS/CSC load modules, distributed macros, and samples.
SSCR70C
This FMID includes SAS/C 7.0 selected components required for LibraryStation and MVS/CSC.
SSCR70D
This FMID includes SAS/C 7.0 selected components required for LibraryStation and MVS/CSC.
You must issue the SMP/E RECEIVE
command to receive the functions you want to install into the target and distribution zones. You can SMP/E receive the ELS functions from the ELS installation ZIP file or CD-ROM.
Consider the following warnings:
If you install an ELS 7.3 product component in an existing global SMP/E CSI containing a previous release of that product, all SYSMODS for the previous release (except for those related to SAS/C) are deleted from the SMP/E CSI.
It is recommended that you back up the existing global SMP/E CSI before installing the ELS 7.3 product components.
The SMPCSI
statement must point to the existing global CSI.
If you install LibraryStation 7.3 or MVS/CSC 7.3 in an existing global SMP/E CSI containing a previous release of LibraryStation or MVS/CSC, it is not necessary to re-install the SAS/C functions (FMIDs SSCR70C
and SSCR70D
).
Do not install LibraryStation 7.3 or MVS/CSC 7.3 and supportive SAS/C functions in a global SMP/E CSI containing other StorageTek products with SAS/C functions you want to preserve. Doing so may cause unpredictable results.
Use the I60RNTS
sample member to SMP/E RECEIVE the ELS functions from UNIX Systems Services (USS). I60RNTS
RECEIVEs the ELS functions from an SMPNTS
(Network Temporary Store) directory.
This member uses the IBM SMP/E RECEIVE FROMNTS
command. Refer to your IBM SMP/E publications for additional information about this command.
To run the I60RNTS
job:
Enter Edit mode for member I60RNTS
and execute the CHGIT
command to apply your CHGIT edits:
Download current HOLDDATA from the My Oracle Support (MOS) site.
In the I60RNTS
sample, replace the following four lines:
//SMPHOLD DD DATA,DLM='qq' Replace this data set with current HOLDDATA from MOS. ++ NULL /* Wed 2015-03-25 22:09:56+0000 */ . qq end of inline HOLDDATA
with:
//SMPHOLD DD DISP=SHR,DSN=holddata.downloaded.from.mos
Submit the I60RNTS
job.
The return code must be 4 or less for all steps executed in this job. If you receive a different return code, contact StorageTek Software Support.
Note:
Though the use of CHGIT
is recommended, it is optional. If you choose not to use CHGIT
, follow the instructions in the prologue of the I60RNTS
sample member, edit as needed, and submit the job.
If you install an ELS 7.3 product component in an existing global SMP/E CSI containing a previous release of that product, the SMPCSI
statement must point to the existing global CSI.
If you install LibraryStation 7.3 or MVS/CSC 7.3 in a global SMP/E CSI containing a previous release of LibraryStation or MVS/CSC, it is not necessary to re-install the SAS/C functions (FMIDs SSCR70C
and SSCR70D
).
Use the I70APP
sample member provided in your SMP/E JCL library to install the ELS functions into the appropriate target zone.
To run the I70APP
job:
Enter Edit mode for member I70APP
and execute the CHGIT
command to apply your CHGIT
edits.
Submit the I70APP
job.
The return code must be 4 or less for all steps executed in this job. If you receive a different return code, contact StorageTek Software Support.
Though the use of CHGIT
is recommended, it is optional. If you choose not to use CHGIT
, follow the instructions in the prologue of the I70APP
sample member, edit as needed, and submit the job.
You can use the APPLY CHECK
option as often as necessary to identify SMP/E processing problems before the actual APPLY
process. All SMP/E detected problems must be resolved before the base functions can be successfully installed.
Consider the following warnings:
If you install an ELS 7.3 product component in an existing global SMP/E CSI containing a previous release of that product, the SMPCSI
statement must point to the existing global CSI.
If you install LibraryStation 7.3 or MVS/CSC 7.3 in a global SMP/E CSI containing a previous release of LibraryStation or MVS/CSC, it is not necessary to re-install the SAS/C functions (FMIDs SSCR70C
and SSCR70D
).
Use the I80ACC
sample member provided in your SMP/E JCL library to accept the ELS functions in the appropriate target zone.
To run the I80ACC
job:
Enter Edit mode for member I80ACC
and execute the CHGIT
command to apply your CHGIT
edits.
Submit the I80ACC
job.
The return code must be 4 or less for all steps executed in this job. If you receive a different return code, contact StorageTek Software Support.
Though the use of CHGIT
is recommended, it is optional. If you choose not to use CHGIT
, follow the instructions in the prologue of the I80ACC
sample member, edit as needed, and submit the job.
You can use the ACCEPT CHECK
option as often as necessary to identify SMP/E processing problems before the actual ACCEPT
process. All SMP/E detected problems must be resolved before the base functions can be successfully installed.
Consider the following warnings:
If you install an ELS 7.3 product component in an existing global SMP/E CSI containing a previous release of that product, the SMPCSI
statement must point to the existing global CSI.
If you install LibraryStation 7.3 or MVS/CSC 7.3 in a global SMP/E CSI containing a previous release of LibraryStation or MVS/CSC, it is not necessary to re-install the SAS/C functions (FMIDs SSCR70C
and SSCR70D
).