2 Installing ELS and Additional Software

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.

Installation Checklist

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.

  1. Unload the SMP/E JCL library from ZIP file, or CD-ROM.

    See "Unloading the SMP/E JCL Library" for more information.

  2. Optionally, edit the CHGIT member according to your requirements.

    Use sample member CHGIT.

    See "Editing the CHGIT Member" for more information.

  3. Test the CHGIT member to verify your edits.

    Use sample member I20TST.

    See "Testing the CHGIT Member" for more information.

  4. 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.

  5. 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.

  6. Update the SYSLIB concatenation.

    Use sample member I50LIB.

    See "Updating the SYSLIB Concatenation" for more information.

  7. Review the ELS FMIDs.

    See "Reviewing the ELS FMIDs" for more information.

  8. 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.

  9. 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.

  10. 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.

  11. SMP/E RECEIVE maintenance for the ELS base functions.

    Use sample member MAINTRCF.

    See "SMP/E RECEIVE Maintenance" for more information.

  12. SMP/E APPLY maintenance for the ELS base functions.

    Use sample member MAINTAPF.

    See "SMP/E APPLY Maintenance" for more information.

  13. Optionally, SMP/E ACCEPT maintenance for the base functions.

    Use sample member MAINTACF.

    See "SMP/E ACCEPT Maintenance" for more information.

  14. Proceed with ELS post-installation tasks. See "Performing ELS Post Installation Tasks" for more information.

  15. Proceed with ELS additional software post-installation tasks. See "Performing Post Installation Tasks for ELS Additional Software" for more information.

Unloading the SMP/E JCL Library

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.

Unloading the SMP/E JCL Library from the ELS Installation Zip File

To unload the SMP/E JCL library from the ELS installation ZIP file:

  1. Establish network connectivity between your PC, MVS Host, and UNIX Systems Services (USS).

  2. Extract the contents of the ELS Installation ZIP file.

  3. Open the file README.html.

  4. 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.

Unloading the SMP/E JCL Library from the ELS Installation CD-ROM

To unload the SMP/E JCL library from the ELS installation CD-ROM:

  1. Establish network connectivity between your PC, MVS Host, and UNIX Systems Services (USS).

  2. Insert the ELS Installation CD-ROM into the CD-ROM drive of your PC.

  3. Navigate to the root directory of your CD-ROM drive and open the file README.html. (This will open automatically on some systems.)

  4. 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.

Editing the CHGIT Member

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:

  1. Edit the CHGIT member according to the instructions commented in the sample member and save your changes.

  2. 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 of CHGIT 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.

Testing the CHGIT Member

Use sample member I20TST (included in your SMP/E JCL library) to test and verify your CHGIT edits.

  1. Enter Edit mode for member I20TST, and execute the CHGIT command.

  2. 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.

Preparing the SMP/E Environment

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.

SMP/E Considerations

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.

Defining and Initializing the ELS Global SMP/E Consolidated Software Inventory (CSI)

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:

  1. Enter Edit mode for member I30CSI, and execute the CHGIT command to apply your CHGIT edits.

  2. Submit the I30CSI job.

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 I30CSI sample member, edit as needed, and submit the job.

Allocating Target and Distribution Library Data Sets and Required DDDEF Entries

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:

  1. Enter Edit mode for member I40ZON, and execute the CHGIT command to apply your CHGIT edits.

  2. 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.

Target and Distribution Library Data Sets

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 for ASEAMAC 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 for ASEAMAC to 50.

Updating the SYSLIB Concatenation

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:

  1. Enter Edit mode for member I50LIB and execute the CHGIT command to apply your CHGIT edits.

  2. 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.

Reviewing the ELS FMIDs

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.

Receiving the ELS Functions

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.

Receiving the ELS Functions from the ELS Installation ZIP File or CD-ROM

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:

  1. Enter Edit mode for member I60RNTS and execute the CHGIT command to apply your CHGIT edits:

  2. Download current HOLDDATA from the My Oracle Support (MOS) site.

  3. 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

  4. 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).

Applying the ELS Functions

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:

  1. Enter Edit mode for member I70APP and execute the CHGIT command to apply your CHGIT edits.

  2. 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).

Accepting the ELS Functions

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:

  1. Enter Edit mode for member I80ACC and execute the CHGIT command to apply your CHGIT edits.

  2. 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).