z/OS Basics: SMP/E

Eileen McClintockeileen.mc@juno.comSession 2219

Agenda

z/OS Basics: SMP/E Product Installation SMP/E Terminology RECEIVE, APPLY, and ACCEPT HOLDDATA RESTORE and REJECT CSI Structure Queries, LIST, and REPORT

Product Installation

Installation Process Input vendor data sets Install jobs assemble, link, copy Output system libraries

Product Installation

SMPTLIBs TargetLIBs

Utilities

SMP/E Product Installation

AssembleLinkCopy

SMP/E Terminology

SMPPTS

SMPTLIBs

GLOBAL

TARGET LIBs

TZONE

DLIBs

DZONE

RECEIVE

REJECT

APPLY

RESTORE

ACCEPT

Basic SMP/E Processing

SMP/E Terminology

Terminology Vendors distribute ELEMENTS

MAC MOD SRC Data EXEC, PARM, PROC, SAMP, PNLENU, etc. HFS JAR PROGRAM

SMP/E Terminology

Terminology (continued) SYSMOD SYStem MODification Product

FUNCTION 7 character FMID Service

PTF preventive maintenance APAR corrective maintenance USERMOD 'unauthorized modification'

SMP/E Terminology

Terminology (continued) MODIFICATION CONTROL STATEMENTS (MCS) Header

++FUNCTION++PTF++APAR++USERMOD

SMP/E Terminology

Terminology: Modification Control Statements++VER

SREL System Release Identifier Z038FMIDPRE, SUP and REQ

++HOLD action required

++JCLIN how target libraries are built

SMP/E Terminology

Terminology: SYSMOD SYSMOD contains MCS plus at least one element

New, replace, or update++MAC / ++MACUPD++MOD / ++ZAP++SRC / ++SRCUPD++data++HFS++JAR / ++JARUPD++PROGRAM

SMP/E Terminology

Terminology: Service Level Service Level

FMID Function Modification Identifier RMID Replacement Modification Identifier UMID Update Modification Identifier

SMP/E Terminology

SMPPTS

SMPTLIBs

GLOBAL

TARGET LIBs

TZONE

DLIBs

DZONE

RECEIVE

REJECT

APPLY

RESTORE

ACCEPT

Basic SMP/E Processing

RECEIVE, APPLY, and ACCEPT

SYSMOD Management Commands RECEIVE stage SYSMODs to DASD (SMPPTS)

Update GLOBAL zone APPLY build target libraries from SMPPTS

Update TARGET zone ACCEPT copy elements into distribution libraries

Update DLIB zone RESTORE undo APPLY by restoring unmodified

elements from distribution libraries Update TARGET zone

RECEIVE, APPLY, and ACCEPT

GLOBAL

SMPPTS

RELFILES SMPTLIBs

RECEIVE Processing RELFILE Packaging

MCS

RECEIVE, APPLY, and ACCEPT

GLOBAL

SMPPTS

RECEIVE Processing INLINE Packaging

MCSand

Elementsor

Updates

RECEIVE, APPLY, and ACCEPT

++FUNCTION(FUN0001).++VER(Z038).++JCLIN//S1 EXEC LINKS//SYSLMOD DD DSN=PROD.LINKLIB//SYSLIN DD *

INCLUDE MOD1INCLUDE MOD2NAME LMOD1(R)

++MOD(MOD1) DISTLIB(AMODLIB).++MOD(MOD2) DISTLIB(AMODLIB).

SampleFunction

RECEIVE, APPLY, and ACCEPT

LMOD1 PROD.LINKLIB

TZONE LMODMOD1 FMID=FUN0001

RMID=FUN0001

MOD2 FMID=FUN0001RMID=FUN0001

Function APPLIED

1 2

Maintenance++PTF(UY00010).++VER(Z038) FMID(FUN0001).++MOD(MOD1).

. . .

RECEIVE, APPLY, and ACCEPT

++APAR(AY00030).++VER(Z038) FMID(FUN0001) PRE(UY00010).++ZAP(MOD1).

. . . .

LMOD1 PROD.LINKLIB

TZONE LMODMOD1 FMID=FUN0001

RMID=UY00010

MOD2 FMID=FUN0001RMID=FUN0001

PTF APPLIED

1 2

Fix

RECEIVE, APPLY, and ACCEPT

LMOD1 PROD.LINKLIB

TZONE LMOD

MOD1 FMID=FUN0001RMID=UY00010UMID=AY00030

MOD2 FMID=FUN0001RMID=FUN0001

APAR APPLIED

1* 2

More maintenance

++PTF(UY00020).++VER(Z038) FMID(FUN0001) SUP(UY00010,AY00030).++MOD(MOD1).

. . . .

RECEIVE, APPLY, and ACCEPT

LMOD1 PROD.LINKLIB

TZONE LMOD

MOD1 FMID=FUN0001RMID=UY00020

MOD2 FMID=FUN0001RMID=FUN0001

Second PTF APPLIED

21

RECEIVE, APPLY, and ACCEPT

PROD.AMODLIB

DZONE

MOD1 FMID=FUN0001RMID=FUN0001

MOD2 FMID=FUN0001RMID=FUN0001

Function ACCEPTED

1 2

RECEIVE, APPLY, and ACCEPT

SMPPTS

SMPTLIBs

GLOBAL

TARGET LIBs

TZONE

DLIBs

DZONE

RECEIVE

REJECT

APPLY

RESTORE

ACCEPT

HOLDDATA

++HOLD May be internal or external GLOBAL zone HOLDDATA entry at RECEIVE EXCEPTION SYSMOD status Prevents APPLY or ACCEPT

HOLDDATA

SYSTEM Holds Identify held SYSMODs

SET BOUNDARY(GLOBAL). LIST HOLDDATA HOLDSYSTEM.

Perform (or prepare for) required action APPLY using BYPASS keyword

APPLY CHECK BYPASS(HOLDSYS(DOC)). APPLY CHECK FORFMID(FUN00001) BYPASS(HOLDSYS).

++HOLD(UZ12345) FMID(FUN0001) SYS REASON(EC).

ERROR Holds Regularly obtain Support Center information

RECEIVE HOLDDATA. Discover if PE already applied

REPORT ERRSYSMODS ZONES(zone1,zone2) Decide what action to take

APPLY the fix RESTORE the PTF in error Cross your fingers

Fix is APAR or PTF that supersedes the APAR

++HOLD(UZ00003) FMID(FUN0001) ERR REASON(AY55555) CLASS(ERREL).

HOLDDATA

RESTORE

TARGET LIBs

TZONE

DLIBs

DZONE

RESTORE

MOD1 FMID=FUN0001RMID=FUN0001

MOD1 FMID=FUN0001RMID=UY00020

RESTORE Processing

PROD.AMODLIB

DZONE

MOD1 FMID=FUN0001RMID=FUN0001

MOD2 FMID=FUN0001RMID=FUN0001

Function ACCEPTED

1 2

DLIBs allow fall-back to unmodified version of elements

RESTORE Processing

UZ00001

UZ00002 UZ00004

UZ00006UZ00003

UZ00005

UZ00007 *

RESTORE

TARGET LIBs

TZONE

DLIBs

DZONE

RESTORE

MOD1 FMID=FUN0001RMID=FUN0001

MOD1 FMID=FUN0001RMID=UZ00005

RESTORE Processing

UZ00001

UZ00002 UZ00004

UZ00006UZ00003

UZ00005

UZ00007

RESTORE S(UZ00001) CHECK GROUP.

ACCEPT S(UZ00001,UZ00002).RESTORE S(UZ00003) CHECK GROUP.

*

REJECT Processing

GLOBAL

SMPPTS

RELFILES SMPTLIBs

RECEIVE Processing Undone

MCS

SYSMOD

HOLDDATA

SYSMOD Processing

SMPPTS

SMPTLIBs

GLOBAL

TARGET LIBs

TZONE

DLIBs

DZONE

RECEIVE

REJECT

APPLY

RESTORE

ACCEPT

CSI Structure

Consolidated Software Inventory (CSI) One or more VSAM KSDSs Logically divided into zones

Global SMP processing options Staged products and maintenance

Target Content and structure of Target Libraries

DLIB Content of Distribution Libraries

Master CSI contains the global zone SMPCSI DD

CSI Structure

GLOBAL

TZMVSP

DZMVSP

TZMVST

DZMVST

.

.

.

.

[

]

SMPE.SMPCSI.CSI

Related

Related

CSI Structure

SMPPTS

GLOBAL

TARGET LIBs

TZMVSP

DLIBs

DZMVSP

TARGET LIBs

TZMVST

DLIBs

DZMVST

R

E

L

A

T

E

D

R

E

L

A

T

E

D

PRODUCTION TEST

SRELZ038

CSI Structure

SMPPTS

GLOBAL

TARGET LIBs

TZMVSM

DLIBs

DZMVSM

R

E

L

A

T

E

D

PRODUCTION MAINTENANCE

SRELZ038

RUNTIME

LIBRARIES

Not SMP/E Maintainable

CSI Considerations

GLOBAL ZONE Contains ZONEINDEX

TARGET-DLIB zone pairs Can manage one or more SRELs

Z038 MVS P115 IMS and DB2 C150 CICS P104 NCP

One-to-one relationship with SMPPTS data set Manage its size keep it cleaned up

CSI Considerations

GLOBAL ZONE (continued) Control point to manage or query system

Cross-zone requisite checking Cross-zone module dependencies Cross-zone Query REPORT CROSSZONE REPORT SYSMODS

SMP/E processing options HOLD information

Queries, LIST, and REPORT

Queries, LIST, and REPORT

Queries, LIST, and REPORT

LIST HOLDDATA LIST SYSMODS APARS

REPORT ERRORSYSMODS(TGT1) REPORT SYSMODS INZONE(TGT1)

COMPARETO (TGT2)

IBM class SMP/E Fundamentals ES261 IBM SMP/E for z/OS: Users Guide SA22-7773 IBM SMP/E for z/OS: SMP/E Reference SA22-7772 IBM SMP/E for z/OS: Commands SA22-7771 IBM Redbook OS/390 Software Management

Cookbook SG24-4775

Resources

Questions & Answers

Conclusion

z/OS Basics: Basic SMP/E

Eileen McClintockeileen.mc@juno.comSession 2219