smpe
TRANSCRIPT
![Page 1: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/1.jpg)
SMP/E
• • Who is this session for?• • What is SMP/E?• • Why would you use it?• • Where does it fit in?• • An SMP/E environment.• • Terminology• • Process Flow
![Page 2: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/2.jpg)
Who is this session for?
• If you are new to maintaining software on the mainframe and want to understand what magic is happening under the covers of
• • Hear the buzzwords, get the scoop on the lingo, see the structures, and learn the steps to use SMP/E to keep your mainframe humming.
![Page 3: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/3.jpg)
What is SMP/E?
• SMP/E is the basic tool for installing and maintaining software in z/OS systems and subsystems. It controls these changes at the element level by:
• Selecting the proper levels of elements to be installed from a large number of potential changes
• Calling system utility programs to install the changes
• Keeping records of the installed changes
![Page 4: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/4.jpg)
Why would you use it?
• • The product is delivered in this format• • Upgrade a product• • Fix a problem with a product• • Track an installation defined change
![Page 5: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/5.jpg)
Where does it fit in?
• The “mainframe” platform. • MVS” environment aka OS/390, z/OS. Not VM.
Not Linux.• Other Independent Software Vendors (ISV)
products.• ISPF based dialog and Batch jobs.
![Page 6: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/6.jpg)
An SMP/E environment - zones
• Global Zone– Waiting to be installed• Target Zone– Runnable copy• Distribution Zone– Source– Backup
![Page 7: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/7.jpg)
SMP/E components -Global Structure
• CSI - Consolidated Software Inventory – Describes Target and Distributions zones– Processing options– Status of work in progress– Exception data (hold for user acknowledgement)• Libraries (DDDEFs)– SMPPTS– Logs
![Page 8: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/8.jpg)
SMP/E components -Target Structure
• CSI - Consolidated Software Inventory– Describes executables• Libraries (DDDEFs)– Run-time (Product specific)– SMP Temporary Store (SMPMTS, SMPSTS, …)– Logs
![Page 9: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/9.jpg)
SMP/E components -Distribution Structure
• CSI - Consolidated Software Inventory– Describes modules (programs and
subroutines)• Libraries (DDDEFs)– Samples– Other text members– Logs
![Page 10: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/10.jpg)
SMP/E - packaging parts
• Function - A product identified by a unique FMID, a logicalgroup of elements.– FMID - Function Modification IDentifier is a SYSMOD idassigned to a function.• SYSMOD id - Identifier assigned to a SYStem MODification.– SYSMOD - input to SMP/E that defines the action to take onone or more elements.• Element - a single part of a product; a unique member of aPDS(E) or file in an HFS.• Program Temporary Fix (PTF) - a SYSMOD that changes one ormore elements.• USERMOD - your modification to a vendor supplied element.
![Page 11: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/11.jpg)
SMP/E - packaging parts
• Authorized Program Analysis Report (APAR) - a temporary fixreleased before a PTF is packaged.• Replacement Modification IDentifier (RMID) - used to identify aSYSMOD that completely replaced an element.• Updated Modification IDentifier (UMID) - used to identify aSYSMOD that updated the last replacement of an element.• COnditional REQuisite (COREQ) - identifies SYSMODs that canonly be installed correctly if both go on.• PRE REQuisite (PREREQ) - identifies SYSMOD(s) that must havebeen installed previously.• Negative PRErequisite (NPRE) - mutually exclusive PREREQ.
![Page 12: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/12.jpg)
SMP/E - processing terms
• Receive - makes known to the GLOBAL CSI.– Similar to unzipping a pc based program and “cab” files thatare used to install a product.• Apply - makes known to the TARGET CSI.– Builds and copies the elements used to run the product.• Accept - makes known to the DISTRIBUTION CSI.– Copies elements to the backup libraries.• Reject - tells the GLOBAL zone to forget about it.• Restore - Rebuilds the Target version from what has beenaccepted. Similar to ctrl-z or “undo”.
![Page 13: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/13.jpg)
SMP/E - distributionmethods
• ServerPac - a complete set of products with appliedmaintenance.• CUM tape - cumulative service release between a span of time.• Product tape - a product at its base level.• CBPDO - a custom built product delivery option. This tapecontains one ore more products at their base level plus allmaintenance released.• SUF - service upgrade facility is a java web based internetapplication that can retrieve APARs and PTFs ensuring allrequired maintenance is also received in your Global zone.• ICSF - Internet Product/Maintenance Retrieval.• FTP - service from Boulder.
![Page 14: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/14.jpg)
Process Flow
• Build environment• Receive• Apply• Test• Accept• Other backup
![Page 15: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/15.jpg)
Where’s your backup?
• Physical volume(s)• Logical data set• SMP/E distribution libraries• SMP/E Zone(s)– Global– Target– Distribution
![Page 16: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/16.jpg)
What do I order?
• ServerPac– System replacement• CBPDO– Product upgrade• Service– PTF and/or APAR
![Page 17: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/17.jpg)
Where do I begin?
• Backup• Read the doc• Receive the files• Backup• Read more doc• Apply check• Research issues/Order more service• Apply• Backup• Accept check• Accept• Backup
![Page 18: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/18.jpg)
Backup
• Make sure you have a backup, outside of SMP/E– Take a data set level backup of the global
datasets, thetarget zone data sets, and the distribution zone
data sets.– Coordinate with others who might be using these
data sets.– Consider IPL volumes, HFS data sets, other run-
time datasets.
![Page 19: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/19.jpg)
Read the doc
• Follow the directions as they apply to your installation.
• Take note of any actions that need to be done.• Coordinate with other areas.• Develop your plan for testing and
implementing.
![Page 20: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/20.jpg)
Receive the files
• GLOBAL processing.– Use ZONEGROUP to exclude receiving items alreadyprocessed.//STEP001 EXEC PGM=GIMSMP,REGION=6M//SMPCSI DD DISP=SHR,DSN=IBMSMPE.OS210.GLOBAL.CSI//SMPPTFIN DD DISP=SHR,DSN=MYUSERID.MPTF4414.UNPACKED//SMPHOLD DD DUMMY//SMPCNTL DD *SET BDY(GLOBAL) .RECEIVE SOURCEID(FTPHANG) ZONEGROUP(ALLZONES)./*
![Page 21: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/21.jpg)
Apply check
//STEP001 EXEC PGM=GIMSMP,REGION=6M,//SMPCSI DD DISP=SHR,DSN=IBMSMPE.OS210.GLOBAL.CSI//SMPOUT DD SYSOUT=*//SMPRPT DD SYSOUT=*//SMPLIST DD SYSOUT=*//SMPSNAP DD DUMMY//SYSPRINT DD SYSOUT=*//SYSUT1 DD UNIT=SYSALLDA,SPACE=(6160,(0230,0760))//SYSUT2 DD UNIT=SYSALLDA,SPACE=(6160,(0230,0760))//SYSUT3 DD UNIT=SYSALLDA,SPACE=(6160,(0230,0760))//SMPPTFIN DD DUMMY//SMPHOLD DD DUMMY//SMPCNTL DD *SET BDY(MDRES1T).APPLY CHECK GROUPEXTENDBYPASS(HOLDSYS(ACTION,DOC,DEP,AO,DELETE))FORFMID(HTCP320, JTCP32C, JTCP325)./*
![Page 22: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/22.jpg)
Research issues/ order moreservice
• Review the “Causer SYSMOD Summary” report and order/receive any missing maintenance, identify actions to be performed, and tailor your apply control cards asnecessary.
•Check the File Allocation Report: know what you are updating and make sure you have a backup.
• Review other reports and take action as necessary.
![Page 23: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/23.jpg)
Apply
• Same JCL as your apply check.• Remove “CHECK” from the control cards.• Review all reports and make sure you know
what was updated.– Did you notice the GLOBAL CSI is updated?• Consider doing another backup.• Test, Test, and test.
![Page 24: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/24.jpg)
Accept
//STEP001 EXEC PGM=GIMSMP,REGION=6M,//SMPCSI DD DISP=SHR,DSN=IBMSMPE.OS210.GLOBAL.CSI//SMPOUT DD SYSOUT=*//SMPRPT DD SYSOUT=*//SMPLIST DD SYSOUT=*//SMPSNAP DD DUMMY//SYSPRINT DD SYSOUT=*//SYSUT1 DD UNIT=SYSALLDA,SPACE=(6160,(0230,0760))//SYSUT2 DD UNIT=SYSALLDA,SPACE=(6160,(0230,0760))//SYSUT3 DD UNIT=SYSALLDA,SPACE=(6160,(0230,0760))//SMPPTFIN DD DUMMY//SMPHOLD DD DUMMY//SMPCNTL DD *SET BDY(MDRES1D).ACCEPT CHECK GROUPEXTENDBYPASS(HOLDSYS(ACTION,DOC,DEP,AO,DELETE))FORFMID(
![Page 25: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/25.jpg)
SYSMOD format
++ PTF (UY50707) /* 5665-28445-HDP3320-//UY50707 JOB 5665-50707-0,28445,MSGLEVEL=(1,1),CLASS=A */ .++ VER (Z038)FMID(HDP3320)PRE (UY44382)SUP (UY43696,AY27240,AY27237,AY24733)/*( DOCUMENTATION FOR THE PTF IS INSERTED HERE. )*/.++ HOLD(UY50707) SYS FMID(HDP3320) REASON(DELETE) DATE(90146)COMMENT(THIS PTF CONTAINS A ++DELETE MCS FOR THE FOLLOWING LMOD: IEBCOPYSMP/E WILL NOT RESTORE THIS PTF.).++DELETE IEBCOPYSYSLIB(LINKLIB).
![Page 26: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/26.jpg)
SYSMOD format
++ JCLIN .//SYSGEN0 JOB 1,'SYSTEM GENERATION',// MSGLEVEL=1,MSGCLASS=A,// CLASS=A//SG22 EXEC LINKS,// PARM='NCAL,LIST,XREF',// UNIT='3380',SER=SYSRES,N=SYSX,NAME=LINKLIB,P1=' ',// MOD=,P2=' ',OBJ=MACLIB,CLASS=A//AOSU0 DD DISP=SHR,VOLUME=(,RETAIN),DSNAME=SYS1.AOSU0//SYSLIN DD *INCLUDE AOSU0(IEBCFAMS)INCLUDE AOSU0(IEBCMSG)INCLUDE AOSU0(IEBCNVT)
![Page 27: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/27.jpg)
Did I really do that?
Did you do something you wish you hadn’t?– You did have a backup, right?– If you accepted something you need a non-
SMP/E restore.– If you applied something, do you want SMP/E
to RESTORE it?– Did you receive something you don’t want -
REJECT it.
![Page 28: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/28.jpg)
SMP/E Restore
//STEP001 EXEC PGM=GIMSMP,REGION=6M,// PARM='PROCESS=WAIT',DYNAMNBR=120//SMPCSI DD DISP=SHR,DSN=IBMSMPE.OS210.GLOBAL.CSI//SMPOUT DD SYSOUT=*//SMPRPT DD SYSOUT=*//SMPLIST DD SYSOUT=*//SMPSNAP DD DUMMY//SYSPRINT DD SYSOUT=*//SYSUT1 DD UNIT=SYSALLDA,SPACE=(6160,(0230,0760))//SYSUT2 DD UNIT=SYSALLDA,SPACE=(6160,(0230,0760))//SYSUT3 DD UNIT=SYSALLDA,SPACE=(6160,(0230,0760))//SMPPTFIN DD DUMMY//SMPHOLD DD DUMMY//SMPCNTL DD *SET BDY(MDRES1T).RESTORE CHECKS(UZ98456)./*
![Page 29: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/29.jpg)
Restore gotchas!
• You will regress back to the last accepted levelset.
• You must select every applied but not accepted sysmod.
• No guarantee an apply can get you back to where you started from. New HOLDDATA may prevent some sysmods from being applied in your current environment.
![Page 30: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/30.jpg)
Reject
• Used mostly to cleanup the SMPMTS.• If you have room, don’t bother.• May have to reject a sysmod to receive it
properly.– Damaged during download and you did not
notice it.– On usermods, consider updating the REWORK
value instead.
![Page 31: Smpe](https://reader033.vdocuments.mx/reader033/viewer/2022051111/555ed228d8b42a772f8b47ab/html5/thumbnails/31.jpg)
Namaskara!
• Thank you for not asking too many questions!!!!!!!!!!!