SMP/E for z/OS

Reference

SA23-2276-30

IBM

NoteBefore using this information and the product it supports, read the information in Notices on page 525.

This edition applies to IBM SMP/E for z/OS, V3R6 (program number 5655-G44) and to all subsequent releases andmodifications until otherwise indicated in new editions.

Last updated: February 26, 2018

Copyright IBM Corporation 1986, 2018.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

Figures . . . . . . . . . . . . . . . v

Tables . . . . . . . . . . . . . . . vii

About this document . . . . . . . . . ixSMP/E publications. . . . . . . . . . . . ix

How to send your comments to IBM . . xiIf you have a technical problem. . . . . . . . xi

Summary of changes . . . . . . . . xiiiChanges made in SMP/E Version 3 Release 6. . . xiiiChanges made in SMP/E Version 3 Release 5 . . . xivChanges made in SMP/E Version 3 Release 4 . . . xv

Chapter 1. Syntax notation and rules . . 1How to read the syntax diagrams . . . . . . . 1Syntax rules for MCS and SMPPARM members. . . 2Syntax rules for XML statements. . . . . . . . 3

Chapter 2. SMP/E modification controlstatements . . . . . . . . . . . . . 5++APAR MCS . . . . . . . . . . . . . . 6++ASSIGN MCS . . . . . . . . . . . . . 8Data element MCS . . . . . . . . . . . . 10++DELETE MCS. . . . . . . . . . . . . 17++FEATURE MCS . . . . . . . . . . . . 21++FUNCTION MCS . . . . . . . . . . . 23Hierarchical file system element MCS . . . . . 26++HOLD MCS . . . . . . . . . . . . . 37++IF MCS . . . . . . . . . . . . . . . 45++JAR MCS . . . . . . . . . . . . . . 47++JARUPD MCS . . . . . . . . . . . . 54++JCLIN MCS . . . . . . . . . . . . . 59++MAC MCS. . . . . . . . . . . . . . 64++MACUPD MCS . . . . . . . . . . . . 71++MOD MCS. . . . . . . . . . . . . . 75++MOVE MCS . . . . . . . . . . . . . 84++NULL MCS . . . . . . . . . . . . . 87++PRODUCT MCS . . . . . . . . . . . . 88++PROGRAM MCS . . . . . . . . . . . 91++PTF MCS . . . . . . . . . . . . . . 96++RELEASE MCS . . . . . . . . . . . . 99++RENAME MCS . . . . . . . . . . . . 104++SRC MCS. . . . . . . . . . . . . . 106++SRCUPD MCS . . . . . . . . . . . . 111++USERMOD MCS . . . . . . . . . . . 114++VER MCS. . . . . . . . . . . . . . 117++ZAP MCS . . . . . . . . . . . . . 123

Chapter 3. Defining controlstatements in SMPPARM members . . 127GIMDDALC control statements . . . . . . . 127

GIMEXITS control statements . . . . . . . . 131OPCODE control statements . . . . . . . . 135

Chapter 4. SMP/E data sets and files 139CLIENT . . . . . . . . . . . . . . . 139Distribution library (DLIB) . . . . . . . . . 139INFILE . . . . . . . . . . . . . . . 140Link library (LKLIB) . . . . . . . . . . . 140ORDERSERVER . . . . . . . . . . . . 140OUTFILE . . . . . . . . . . . . . . . 141SERVER . . . . . . . . . . . . . . . 141SMPCLNT . . . . . . . . . . . . . . 142SMPCNTL . . . . . . . . . . . . . . 142SMPCPATH . . . . . . . . . . . . . . 143SMPCSI . . . . . . . . . . . . . . . 143SMPDATA1 . . . . . . . . . . . . . . 144SMPDATA2 . . . . . . . . . . . . . . 145SMPDEBUG . . . . . . . . . . . . . . 146SMPDIR . . . . . . . . . . . . . . . 146SMPDUMMY . . . . . . . . . . . . . 146SMPHOLD . . . . . . . . . . . . . . 147SMPHRPT . . . . . . . . . . . . . . 148SMPJCLIN . . . . . . . . . . . . . . 148SMPJHOME . . . . . . . . . . . . . . 149SMPLIST . . . . . . . . . . . . . . . 149SMPLOG . . . . . . . . . . . . . . . 150SMPLOGA . . . . . . . . . . . . . . 150SMPLTS . . . . . . . . . . . . . . . 151SMPMTS . . . . . . . . . . . . . . . 152SMPNTS . . . . . . . . . . . . . . . 153SMPOBJ . . . . . . . . . . . . . . . 154SMPOUT . . . . . . . . . . . . . . . 154SMPPARM . . . . . . . . . . . . . . 154SMPPTFIN . . . . . . . . . . . . . . 155SMPPTS . . . . . . . . . . . . . . . 156SMPPTS spill data set . . . . . . . . . . 157SMPPUNCH . . . . . . . . . . . . . 158SMPRPT . . . . . . . . . . . . . . . 158SMPSCDS . . . . . . . . . . . . . . 159SMPSNAP . . . . . . . . . . . . . . 159SMPSRVR . . . . . . . . . . . . . . 160SMPSTS . . . . . . . . . . . . . . . 160SMPTLIB . . . . . . . . . . . . . . . 160SMPTLOAD. . . . . . . . . . . . . . 162SMPWKDIR . . . . . . . . . . . . . . 163SMPWRK1 . . . . . . . . . . . . . . 163SMPWRK2 . . . . . . . . . . . . . . 164SMPWRK3 . . . . . . . . . . . . . . 164SMPWRK4 . . . . . . . . . . . . . . 165SMPWRK6 . . . . . . . . . . . . . . 165SMPnnnnn . . . . . . . . . . . . . . 166SYSIN . . . . . . . . . . . . . . . . 166SYSLIB . . . . . . . . . . . . . . . 166SYSPRINT . . . . . . . . . . . . . . 167SYSPUNCH . . . . . . . . . . . . . . 168

Copyright IBM Corp. 1986, 2018 iii

SYSUT1, SYSUT2, and SYSUT3 . . . . . . . 168SYSUT4 . . . . . . . . . . . . . . . 169Target library . . . . . . . . . . . . . 169Text library (TXLIB) . . . . . . . . . . . 169Zone statement . . . . . . . . . . . . . 170

Chapter 5. SMP/E data set entries . . 171How the data sets are organized . . . . . . . 171How data set entries are organized . . . . . . 173ASSEM entry (distribution and target zone) . . . 183BACKUP entries (SMPSCDS) . . . . . . . . 187Data element entry (distribution and target zone) 190DDDEF entry (distribution, target, and global zone) 194DLIB entry (distribution and target zone) . . . . 208DLIBZONE entry (distribution zone) . . . . . 212FEATURE entry (global zone) . . . . . . . . 215FMIDSET entry (global zone) . . . . . . . . 218GLOBALZONE entry (global zone) . . . . . . 220Hierarchical file system element entry (distributionand target zone) . . . . . . . . . . . . 224HOLDDATA entry (global zone) . . . . . . . 234JAR entry (target and distribution zone) . . . . 237LMOD entry (distribution and target zone) . . . 244MAC entry (distribution and target zone) . . . . 261MCS entry (SMPPTS). . . . . . . . . . . 267MOD entry (distribution and target zone) . . . . 269MTSMAC entry (SMPMTS). . . . . . . . . 284OPTIONS entry (global zone) . . . . . . . . 286ORDER entry (global zone). . . . . . . . . 296PRODUCT entry (global zone) . . . . . . . 299PROGRAM entry (distribution and target zone) 301SRC entry (distribution and target zone) . . . . 306STSSRC entry (SMPSTS) . . . . . . . . . . 312SYSMOD entry (distribution and target zone) . . 313SYSMOD entry (global zone) . . . . . . . . 327TARGETZONE entry (target zone) . . . . . . 337UTILITY entry (global zone) . . . . . . . . 341ZONESET entry (global zone) . . . . . . . . 348

Chapter 6. SMP/E CSI applicationprogramming interface . . . . . . . 351Overview of GIMAPI. . . . . . . . . . . 351QUERY command . . . . . . . . . . . . 351FREE command . . . . . . . . . . . . 386VERSION command . . . . . . . . . . . 387Programming in C . . . . . . . . . . . 389Programming in PL/I . . . . . . . . . . 391Programming in assembler . . . . . . . . . 393Additional programming considerations . . . . 396Sample programs that use GIMAPI . . . . . . 396

Chapter 7. Writing UNIX shell scripts 407Designing a shell script for SMP/E processing . . 407Example shell script . . . . . . . . . . . 409

Chapter 8. Library change file records 413Library change file record structure . . . . . . 413Library change file record types . . . . . . . 413Valid action types . . . . . . . . . . . . 431Usage recommendations. . . . . . . . . . 432

Chapter 9. SMP/E exit routines . . . . 433RECEIVE exit routine. . . . . . . . . . . 433Retry exit routine . . . . . . . . . . . . 435

Chapter 10. JCL statements requiredto invoke SMP/E . . . . . . . . . . 437JOB statement . . . . . . . . . . . . . 437EXEC statement . . . . . . . . . . . . 437DD statements . . . . . . . . . . . . . 439

Chapter 11. Service routines . . . . . 441GIMCPTS: SYSMOD compaction service routine 441GIMDTS: Data transformation service routine . . 444GIMGTPKG service routine . . . . . . . . 445GIMUNZIP file extraction service routine . . . . 449GIMXSID software inventory data service routine 460GIMXTRX service routine . . . . . . . . . 470GIMZIP packaging service routine . . . . . . 478

Chapter 12. GIMIAP: Copy utilityinvocation program. . . . . . . . . 503Control statements used to invoke GIMIAP . . . 503

Appendix A. SMP/E namingconventions . . . . . . . . . . . . 513Naming conventions for HOLD reason IDs andHOLD classes . . . . . . . . . . . . . 514Naming conventions for source IDs . . . . . . 517Naming conventions for SYSMODs . . . . . . 518

Appendix B. Accessibility . . . . . . 521Accessibility features . . . . . . . . . . . 521Consult assistive technologies . . . . . . . . 521Keyboard navigation of the user interface . . . . 521Dotted decimal syntax diagrams . . . . . . . 521

Notices . . . . . . . . . . . . . . 525Terms and conditions for product documentation 527IBM Online Privacy Statement. . . . . . . . 528Policy for unsupported hardware. . . . . . . 528Minimum supported hardware . . . . . . . 528Programming interface information . . . . . . 529Trademarks . . . . . . . . . . . . . . 529

Index . . . . . . . . . . . . . . . 531

iv SMP/E Reference

Figures

1. Example of using data element MCSs . . . . 122. Load module structure for ++ZAP examples 1253. Sample GIMEXITS member provided in

SAMPLIB . . . . . . . . . . . . . 1344. Single-CSI structure . . . . . . . . . 1725. Multiple-CSI structure . . . . . . . . 1736. Global zone: relationships between entries

that control processing . . . . . . . . 1757. Target zone and distribution zone:

relationships between entries that controlprocessing . . . . . . . . . . . . 177

8. Target Zone: Relationships between entriesthat define status and structure . . . . . 179

9. Distribution zone: relationships betweenentries that define status and structure . . . 182

10. ASSEM entry: sample LIST output . . . . 18411. ASSEM entry: sample LIST output when

XREF is specified