z/OS Basics: SMP/E

Eileen McClintock
eileen.mc@juno.com
Session 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
SMP/E Product Installation

Utilities
SMPTLIBs
Assemble
Link
Copy

Target
LIBs

SMP/E Terminology
Basic SMP/E Processing
APPLY
RECEIVE

REJECT

SMPPTS
SMPTLIBs

TARGET
LIBs

GLOBAL

TZONE

RESTORE
DLIBs

ACCEPT
DZONE

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 Z038
FMID
PRE, 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
Basic SMP/E Processing
APPLY
RECEIVE

REJECT

SMPPTS
SMPTLIBs

TARGET
LIBs

GLOBAL

TZONE

RESTORE
DLIBs

ACCEPT
DZONE

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

RECEIVE Processing RELFILE Packaging
MCS
SMPPTS
GLOBAL

RELFILES

SMPTLIBs

RECEIVE, APPLY, and ACCEPT

RECEIVE Processing INLINE Packaging
MCS
and
Elements
or
Updates

SMPPTS
GLOBAL

RECEIVE, APPLY, and ACCEPT

++FUNCTION(FUN0001).
++VER(Z038).
++JCLIN
//S1 EXEC LINKS
//SYSLMOD DD DSN=PROD.LINKLIB
//SYSLIN DD *
INCLUDE MOD1
INCLUDE MOD2
NAME LMOD1(R)
++MOD(MOD1) DISTLIB(AMODLIB).
++MOD(MOD2) DISTLIB(AMODLIB).

Sample
Function

RECEIVE, APPLY, and ACCEPT

Function APPLIED
LMOD1
1 2
TZONE

PROD.LINKLIB
LMOD

MOD1 FMID=FUN0001
RMID=FUN0001
MOD2 FMID=FUN0001
RMID=FUN0001

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

Maintenance

RECEIVE, APPLY, and ACCEPT

PTF APPLIED
LMOD1
1 2
TZONE

PROD.LINKLIB
LMOD

MOD1 FMID=FUN0001
RMID=UY00010
MOD2 FMID=FUN0001
RMID=FUN0001

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

Fix

RECEIVE, APPLY, and ACCEPT

APAR APPLIED
LMOD1
1* 2
TZONE

PROD.LINKLIB
LMOD

MOD1 FMID=FUN0001
RMID=UY00010
UMID=AY00030
MOD2 FMID=FUN0001
RMID=FUN0001

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

RECEIVE, APPLY, and ACCEPT

Second PTF APPLIED

LMOD1
1 2
TZONE

PROD.LINKLIB

LMOD

MOD1 FMID=FUN0001
RMID=UY00020
MOD2 FMID=FUN0001
RMID=FUN0001

RECEIVE, APPLY, and ACCEPT

Function ACCEPTED

2
DZONE

PROD.AMODLIB

MOD1 FMID=FUN0001
RMID=FUN0001
MOD2 FMID=FUN0001
RMID=FUN0001

RECEIVE, APPLY, and ACCEPT

RECEIVE

REJECT

APPLY
SMPPTS
SMPTLIBs

TARGET
LIBs

GLOBAL

TZONE

RESTORE
ACCEPT

DLIBs
DZONE

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

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

RESTORE

MOD1 FMID=FUN0001
RMID=UY00020

TARGET
LIBs
TZONE

RESTORE
MOD1 FMID=FUN0001
RMID=FUN0001

DLIBs
DZONE

RESTORE Processing
Function ACCEPTED

2
DZONE

PROD.AMODLIB

MOD1 FMID=FUN0001
RMID=FUN0001
MOD2 FMID=FUN0001
RMID=FUN0001

DLIBs allow fall-back to unmodified version of elements

RESTORE Processing
UZ00001

UZ00007

UZ00002

UZ00004

UZ00003

UZ00006

UZ00005

RESTORE

MOD1 FMID=FUN0001
RMID=UZ00005

TARGET
LIBs
TZONE

RESTORE
MOD1 FMID=FUN0001
RMID=FUN0001

DLIBs
DZONE

RESTORE Processing
RESTORE S(UZ00001) CHECK GROUP.
UZ00001

UZ00007

UZ00002

UZ00004

UZ00003

UZ00006

UZ00005

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

REJECT Processing
RECEIVE Processing Undone
MCS
SMPPTS
GLOBAL

RELFILES

SYSMOD
HOLDDATA

SMPTLIBs

SYSMOD Processing
RECEIVE

REJECT

APPLY
SMPPTS
SMPTLIBs

TARGET
LIBs

GLOBAL

TZONE

RESTORE
ACCEPT

DLIBs
DZONE

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
SMPE.SMPCSI.CSI

GLOBAL
.
TZMVSP
.
Related [
DZMVSP
.
TZMVST
. ] Related
DZMVST

CSI Structure
TEST

PRODUCTION
TARGET
LIBs
R

TZMVSP

TARGET
LIBs
SMPPTS

TZMVST

R
E

GLOBAL

SREL

T
E

Z038
DLIBs

DLIBs

E
D

DZMVSP

DZMVST

CSI Structure
MAINTENANCE

PRODUCTION

TARGET
LIBs
SMPPTS

TZMVSM

R
E

RUNTIME
LIBRARIES

GLOBAL

L
A

SREL

Z038
DLIBs

E
D

Not SMP/E Maintainable

DZMVSM

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)

Resources

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

Conclusion

Questions & Answers

z/OS Basics: Basic SMP/E

Eileen McClintock
eileen.mc@juno.com
Session 2219