3 Installing ELS Maintenance

This chapter describes how to install ELS maintenance. It includes the following topics:

"Maintenance Installation Data Sets"
"ELS Cumulative Service Contents"
"Unloading the ELS Maintenance SMP/E JCL Samples"
"Unloading Cumulative Maintenance"
"SMP/E RECEIVE Maintenance"
"SMP/E APPLY Maintenance"
"SMP/E ACCEPT Maintenance"
"Separate HELD ELS PTFs"

You must obtain and install the latest cumulative maintenance (PTFs and HOLDDATA) for ELS 7.3 and for any release of Oracle StorageTek software that coexists with ELS 7.2. Download cumulative maintenance from the My Oracle Support (MOS) site:

http://www.myoraclesupport.com

Visit this site frequently for HOLDDATA and PTF updates and install cumulative maintenance updates on a regular schedule. PTFs are released monthly to MOS.

Before attempting to install maintenance, contact Oracle Global Customer Services for information about the latest maintenance available. See "Preface" for information about contacting Oracle for assistance.

Note:

PTFs and HOLDDATA may not exist at ELS release launch but will follow in time and are released monthly to MOS.

Maintenance Installation Data Sets

ELS maintenance is installed with SMP/E. Thus, the SMP/E target and distribution libraries used for installation of the ELS base products are required. See "Allocating Target and Distribution Library Data Sets and Required DDDEF Entries" for more information about these libraries.

ELS Cumulative Service Contents

ELS cumulative maintenance is distributed in a ZIP file. The following table describes the files included in the ZIP file:

Table 3-1 ELS 7.3 Cumulative Service Contents (Code Directory)

File Number	Data Set Name	Description
1	els73.cvr	PTF cover letters and JCL samples
2	els73.hdd	SMP/E `HOLDDATA`
3	els73.ptf	Service PTFs
4	els73.smm	Summary data

Unloading the ELS Maintenance SMP/E JCL Samples

Sample JCL members for installing ELS maintenance were unloaded from the ELS ZIP file or CD-ROM during the ELS installation process. See "Unloading the SMP/E JCL Library" for more information.

You can use these JCL samples to process maintenance in mass mode, or by individual SYSMOD.

Unloading Cumulative Maintenance

Perform the following steps to unload COVER letters, HOLDDATA, PTFs, and SUMMARY data:

Pre-allocate the following FTP receiving data sets as shown in the following example. Change hlq to your high-level-qualifier; change vr to 73.

Data Set Name  . . . :hlq.ELSvr.HDD - HOLDDATA
//  RECFM=FB,LRECL=80,SPACE=(27920,(30,30))

Data Set Name  . . . :hlq.ELSvr.PTF - PTFs
//  RECFM=FB,LRECL=80,SPACE=(27920,(13000,300))

Data Set Name  . . . :hlq.ELSvr.CVR - Cover Letters
//  RECFM=FB,LRECL=80,SPACE=(27920,(30,30))

Data Set Name  . . . :hlq.ELSvr.SMM - Summary
//  RECFM=FB,LRECL=80,SPACE=(27920,(30,30))

Open a DOS window and use the cd (change directory) command to go to the directory that contains the downloaded cumulative maintenance files.
Enter the following commands:
```
FTP mvshost
(Supply your user and password credentials.)

binary

mput els73.cvr
mput els73.hdd
mput els73.ptf
mput els73.smm

quit
```
Running this sequence of mput commands copies the following files:
- els73.cvr
- els73.hdd
- els73.ptf
- els73.smm
...to the following data sets on your MVS system:
- hlq.ELS73.CVR
- hlq.ELS73.HDD
- hlq.ELS73.PTF
- hlq.ELS73.SMM
where hlq is your high-level qualifier.

SMP/E RECEIVE Maintenance

Sample member MAINTRCF provides sample JCL to SMP/E RECEIVE maintenance by specific FMID.

Modify this sample member as follows:

Modify the SMPPTFIN DD statement to point to the hlq.ELS73.PTF data set.
Modify the SMPHOLD DD statement to point to the hlq.ELS73.HDD data set.

Follow the instructions in the prologue of the sample member and submit the job to receive maintenance.

The return code must be zero (0) for all steps executed in this job. If you receive a different return code, contact StorageTek Software Support.

SMP/E APPLY Maintenance

Sample member MAINTAPF provides sample JCL used to SMP/E APPLY maintenance by specific FMID.

Follow the instructions in the prologue of the sample member for necessary modifications and procedures for performing an SMP/E APPLY CHECK followed by an actual SMP/E APPLY. Submit the job to apply maintenance.

Note:

You must specify the ASSEM option on the APPLY command in the sample JCL when the SMC JES3 FMID is included in the APPLY.

SMP/E ACCEPT Maintenance

Note:

Performing an SMP/E ACCEPT for maintenance is optional.

Sample member MAINTACF provides sample JCL to SMP/E ACCEPT maintenance by specific FMID.

Follow the instructions in the prologue of the sample member for necessary modifications and procedures for performing an SMP/E ACCEPT CHECK followed by an actual SMP/E ACCEPT. Submit the job to apply maintenance.

Separate HELD ELS PTFs

Examine the output from the APPLY in the previous section to identify those PTFs that failed to be applied due to HOLDSYSTEM exception data. Examine the cover letters for those PTFs to determine if the PTFs are applicable to your environment. Generally, ELS SYSMODS with HOLDSYSTEM fall into two categories:

SYSMODS that update the tape management system scratch conversion modules (SLUDRCA1, SLUDRRMM, SLUDRSMC, SLUDRTLM, and SLUDRZAR).
Those SYSMODS that have dependencies beyond control of the ELS SMP/E environment. For example, certain ELS PTFs may require a particular MVS PTF to be applied or you may need to update an automated operations package.

From the examination of the SYSMODS that were not applied due to HOLDSYSTEM exception data, create four lists of PTFs as follows:

list 1

Includes tape management system PTFs for a tape management system that is not installed at your site.
list 2

Includes tape management system PTFs where the tape management system is installed at your site and modification of the source is necessary.
list 3

Includes non-tape management system PTFs that cannot be applied because your site does not meet the conditions defined in the PTF cover letters.
list 4

Includes all other PTFs held for HOLDSYSTEM exception data. These are held PTFs that are applicable to your installation. Included are tape management system PTFs where the tape management system is installed at your site and you do not need to modify the source code.

APPLY Applicable ELS HOLDSYSTEM SYSMODS

Use the sample JCL provided in the following example to SMP/E APPLY applicable HOLDSYSTEM SYSMODS:

Example 3-1 JCL to SMP/E APPLY HOLDSYSTEM SYSMODS

//jobname  JOB .....
//S1       EXEC smpe-proc 
//SMPCNTL  DD  * 
   SET BDY(target-zone) .
   APPLY PTFS
         EXCLUDE(ptf1,ptf2,........ptfn)
         GROUPEXTEND
         FORFMID(
             /* FMID-id  */ 
                )
         BYPASS(HOLDSYSTEM)
          ASSEM
               .
/*