SMP/E for z/OS

Commands

IBM

SA23-2275-30

Note

Before using this information and the product it supports, read the information in “Notices” on page565.

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: 2019-02-16© Copyright International Business Machines Corporation 1986, 2018.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract withIBM Corp.

Contents

List of Figures.................................................................................................... xviiList of Tables.......................................................................................................xxi

About this document......................................................................................... xxiiiSMP/E publications.................................................................................................................................. xxiii

How to send your comments to IBM.................................................................... xxvIf you have a technical problem............................................................................................................... xxv

Summary of changes......................................................................................... xxviChanges made in SMP/E Version 3 Release 6.........................................................................................xxviChanges made in SMP/E Version 1 Release 5 .......................................................................................xxviiChanges made in SMP/E Version 1 Release 4.......................................................................................xxviii

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

Chapter 2. The ACCEPT command.......................................................................... 5Zones for SET BOUNDARY........................................................................................................................... 5Syntax...........................................................................................................................................................6

Operands................................................................................................................................................ 8Syntax notes......................................................................................................................................... 20

Data sets used........................................................................................................................................... 21Usage notes................................................................................................................................................22

Adding new elements to the distribution libraries.............................................................................. 22DISTLIB operand checking.................................................................................................................. 22DISTSRC, ASSEM, and DISTMOD operands........................................................................................ 23Alias processing....................................................................................................................................23ACCEPT CHECK facility.........................................................................................................................23SYSMOD termination............................................................................................................................24ACCEPT termination............................................................................................................................. 25Automatic reinstallation of SYSMODs..................................................................................................25

Output........................................................................................................................................................ 25Examples....................................................................................................................................................26

Example 1: Accepting all SYSMODs from a given source....................................................................26Example 2: Accepting all SYSMODs for selected functions................................................................ 26Example 3: Accepting with the GROUP operand.................................................................................26Example 4: Accepting with the GROUPEXTEND operand................................................................... 27Example 5: Accepting with the CHECK operand................................................................................. 27Example 6: Combining ACCEPT operands...........................................................................................27Example 7: Doing ACCEPT before APPLY............................................................................................ 28Example 8: Installing service for all ESO service levels......................................................................28Example 9: Excluding SYSMODs with certain source IDs................................................................... 28Example 10: Bypassing system reason IDs.........................................................................................28Example 11: Excluding SYSMODs selected with an FMIDSET............................................................29

Processing..................................................................................................................................................29SYSMOD selection................................................................................................................................ 29SYSMOD installation.............................................................................................................................35Element selection.................................................................................................................................38Element installation............................................................................................................................. 40

iii

Recording after completion..................................................................................................................47Zone and data set sharing considerations................................................................................................ 49

Chapter 3. The APPLY command.......................................................................... 51Zones for SET BOUNDARY.........................................................................................................................51Syntax.........................................................................................................................................................52

Operands.............................................................................................................................................. 54Syntax notes......................................................................................................................................... 66

Data sets used........................................................................................................................................... 67Usage notes................................................................................................................................................68

Adding new elements other than modules to the target libraries...................................................... 68Adding new modules to the target libraries........................................................................................ 68Checking the DISTLIB operand............................................................................................................69DISTSRC, ASSEM, and DISTMOD operands........................................................................................ 69Use of the SMPMTS and SMPSTS as target libraries........................................................................... 70Use of the SMPLTS library.................................................................................................................... 70Alias processing....................................................................................................................................70APPLY CHECK facility........................................................................................................................... 71SYSMOD termination............................................................................................................................71APPLY termination................................................................................................................................72Automatic reapplication of SYSMODs..................................................................................................72Applying maintenance to a module in an LLA managed library..........................................................73

Output........................................................................................................................................................ 73Examples....................................................................................................................................................74

Example 1: Applying all SYSMODs from a given source......................................................................74Example 2: Applying all SYSMODs for selected functions.................................................................. 74Example 3: Applying APARs and USERMODs...................................................................................... 75Example 4: Applying with the GROUP operand...................................................................................75Example 5: Applying with GROUPEXTEND..........................................................................................75Example 6: Applying with the CHECK operand................................................................................... 75Example 7: Combining APPLY operands..............................................................................................76Example 8: Installing service for all ESO service levels......................................................................76Example 9: Excluding SYSMODs with certain source IDs................................................................... 76Example 10: Bypassing system reason IDs.........................................................................................77Example 11: Excluding SYSMODs selected with an FMIDSET............................................................77Example 12: Automatic release of system hold when ++HOLD keeps the originating SYSMOD ID..77

Processing..................................................................................................................................................78SYSMOD selection................................................................................................................................ 78SYSMOD installation.............................................................................................................................83Element selection.................................................................................................................................87Building load modules..........................................................................................................................90Element installation............................................................................................................................. 90Recording after completion............................................................................................................... 102Global zone SYSMOD entries............................................................................................................. 104

Zone and data set sharing considerations.............................................................................................. 104

Chapter 4. The BUILDMCS command.................................................................. 107Zones for SET BOUNDARY.......................................................................................................................107Syntax...................................................................................................................................................... 107Operands..................................................................................................................................................107Data sets used......................................................................................................................................... 108Usage notes............................................................................................................................................. 108

Product intersections.........................................................................................................................108Other considerations..........................................................................................................................108

Output...................................................................................................................................................... 109Reports............................................................................................................................................... 109SMPPUNCH output.............................................................................................................................109

iv

Example................................................................................................................................................... 109Processing................................................................................................................................................110

FMID applicability.............................................................................................................................. 110Determine SYSMODs associated with FMIDs................................................................................... 110Determine elements for all associated SYSMODs.............................................................................111Determine LMODs for module elements........................................................................................... 111Create JCLIN...................................................................................................................................... 112

Zone and data set sharing considerations.............................................................................................. 113

Chapter 5. The CLEANUP command....................................................................115Zones for SET BOUNDARY.......................................................................................................................115Syntax...................................................................................................................................................... 115

Operands............................................................................................................................................ 116Data sets used......................................................................................................................................... 116Output...................................................................................................................................................... 116Example: Using CLEANUP with the COMPRESS operand.......................................................................116Processing................................................................................................................................................118Zone and data set sharing considerations.............................................................................................. 119

Chapter 6. The DEBUG command........................................................................121Zones for SET BOUNDARY.......................................................................................................................121Syntax...................................................................................................................................................... 122

Operands............................................................................................................................................ 122Syntax notes.......................................................................................................................................123

Data sets used......................................................................................................................................... 124Output...................................................................................................................................................... 124Examples..................................................................................................................................................124

Example 1: Tracing SMP/E messages................................................................................................124Example 2: Dumping control blocks and storage areas....................................................................124Example 3: Dumping a VSAM RPL control block...............................................................................125Example 4: Dumping SMP/E storage when messages are issued.................................................... 125

Processing................................................................................................................................................126

Chapter 7. The GENERATE command..................................................................127Zones for SET BOUNDARY.......................................................................................................................127Syntax...................................................................................................................................................... 127

Operands............................................................................................................................................ 128Data sets used......................................................................................................................................... 129Usage notes............................................................................................................................................. 129Output...................................................................................................................................................... 130Examples..................................................................................................................................................130

Example 1: Using GENERATE to install new products...................................................................... 130Example 2: Reinstalling products not included by SYSGEN............................................................. 131

Processing................................................................................................................................................132Target zone analysis........................................................................................................................... 132JCL creation........................................................................................................................................136Job generation................................................................................................................................... 137Using the output from GENERATE..................................................................................................... 140

Zone and data set sharing considerations.............................................................................................. 140

Chapter 8. The GZONEMERGE command.............................................................143Zones for SET BOUNDARY.......................................................................................................................143Syntax...................................................................................................................................................... 143

Operands............................................................................................................................................ 143Data sets used......................................................................................................................................... 144Usage notes............................................................................................................................................. 144Output...................................................................................................................................................... 145

v

Examples..................................................................................................................................................145Example 1: Merge definition entries..................................................................................................145Example 2: Merge content entries.....................................................................................................145

Processing................................................................................................................................................146FMID applicability.............................................................................................................................. 147Determine SYSMODs associated with FMIDs................................................................................... 147Determine HOLDDATA entries associated with FMIDs..................................................................... 147Determine FEATURE entries associated with FMIDs........................................................................147Determine PRODUCT entries associated with FMIDs.......................................................................147GLOBALZONE entry updates for content entries.............................................................................. 147Merging SYSMOD entries................................................................................................................... 148Merging HOLDDATA entries............................................................................................................... 149Merging FEATURE entries.................................................................................................................. 149Merging PRODUCT entries................................................................................................................. 150Merging DEFINITION entries.............................................................................................................150Compaction of inline data.................................................................................................................. 152

Zone and data set sharing considerations.............................................................................................. 152

Chapter 9. The JCLIN command......................................................................... 155Zone for SET BOUNDARY.........................................................................................................................155Syntax...................................................................................................................................................... 156

Operands............................................................................................................................................ 156Data sets used......................................................................................................................................... 157Usage notes............................................................................................................................................. 158

JCLIN input.........................................................................................................................................158SYSMODs with inline JCLIN............................................................................................................... 163OPCODE members to identify opcodes in assembler text................................................................163Processing after system generation.................................................................................................. 163Cross-zone relationships................................................................................................................... 163

Output...................................................................................................................................................... 164Examples..................................................................................................................................................164

Example 1: JCLIN for products with special utilities........................................................................ 164Example 2: JCLIN for products with special assembler opcodes.................................................... 164Example 3: JCLIN for MOD entries.................................................................................................... 165Example 4: JCLIN for MAC and SRC entries......................................................................................167Example 5: JCLIN for an assembler step to create a SRC entry.......................................................168Example 6: JCLIN for using the link-edit automatic library call function.........................................168Example 7: JCLIN for load modules residing in a UNIX file system................................................. 170Example 8: JCLIN for SIDEDECKLIB subentries...............................................................................171Example 9: JCLIN for UTIN subentries............................................................................................. 171

Processing................................................................................................................................................171Summary............................................................................................................................................ 172General JCLIN coding conventions....................................................................................................172Processing assembler steps.............................................................................................................. 174Processing copy steps........................................................................................................................176Processing link-edit steps..................................................................................................................179Processing update steps....................................................................................................................191Processing other utility steps............................................................................................................ 191

Zone and data set sharing considerations.............................................................................................. 192

Chapter 10. The LINK LMODS command............................................................. 193Zones for SET BOUNDARY.......................................................................................................................193Syntax...................................................................................................................................................... 193

Operands............................................................................................................................................ 193Data sets used......................................................................................................................................... 195Output...................................................................................................................................................... 195Processing................................................................................................................................................195

vi

LMOD applicability............................................................................................................................. 195Processing LMODs with CALLLIBS and XZMOD subentries..............................................................196Processing LMODs with CALLLIBS but no XZMOD subentries..........................................................196Processing LMODs without CALLLIBS subentries.............................................................................196Scheduling and batching link-edits................................................................................................... 196

Zone and data set sharing considerations.............................................................................................. 197

Chapter 11. The LINK MODULE command........................................................... 199Zones for SET BOUNDARY.......................................................................................................................199Syntax...................................................................................................................................................... 200

Operands............................................................................................................................................ 200Data sets used......................................................................................................................................... 201Output...................................................................................................................................................... 202Example: Linking a GDDM module into a CICS load module..................................................................202Processing................................................................................................................................................202

Preparing for linking........................................................................................................................... 203Building load modules....................................................................................................................... 205Linking the load modules...................................................................................................................205

Zone and data set sharing considerations.............................................................................................. 205

Chapter 12. The LIST command..........................................................................207Zones for SET BOUNDARY.......................................................................................................................207Syntax...................................................................................................................................................... 207

Distribution zone and target zone syntax.......................................................................................... 208Global zone syntax............................................................................................................................. 210SMPLOG syntax.................................................................................................................................. 212SMPSCDS syntax................................................................................................................................ 212Operands............................................................................................................................................ 213Syntax notes.......................................................................................................................................225

Data sets used......................................................................................................................................... 226Usage notes............................................................................................................................................. 226Output...................................................................................................................................................... 226Examples..................................................................................................................................................226

Example 1: List all the entries in a particular zone........................................................................... 227Example 2: List all the entries of a particular type............................................................................227Example 3: List specific entries......................................................................................................... 227Example 4: List entries applicable to specific FMIDs....................................................................... 227Example 5: List entries for specific UNIX shell scripts..................................................................... 227Example 6: Check which SYSMODs are received but not installed.................................................. 227Example 7: Check whether SYSMODs are installed in the related zone.......................................... 228Example 8: Compare the SYSMODs installed in two zones of the same type..................................228Example 9: Requesting SYSMOD and HOLDDATA.............................................................................229

Processing................................................................................................................................................229Mass-mode processing...................................................................................................................... 229Select-mode processing.................................................................................................................... 230

Zone and data set sharing considerations.............................................................................................. 230

Chapter 13. The LOG command.......................................................................... 231Zones for SET BOUNDARY.......................................................................................................................231Syntax...................................................................................................................................................... 231

Operands............................................................................................................................................ 231Data sets used......................................................................................................................................... 231Output...................................................................................................................................................... 232Examples..................................................................................................................................................232

Example 1: Writing a message...........................................................................................................232Example 2: Coding parentheses correctly.........................................................................................232Example 3: Listing an SMPLOG data set............................................................................................233

vii

Processing................................................................................................................................................233

Chapter 14. The RECEIVE command...................................................................235Zones for SET BOUNDARY.......................................................................................................................235Syntax...................................................................................................................................................... 236

Operands............................................................................................................................................ 237Syntax notes.......................................................................................................................................244

Data sets used......................................................................................................................................... 244Usage notes............................................................................................................................................. 245

Receiving SYSMODs packaged in relative files..................................................................................245Receiving SYSMODs created by the BUILDMCS command.............................................................. 247Restarting RECEIVE FROMNETWORK............................................................................................... 248Defining an installation-wide exit routine for RECEIVE processing..................................................248Defining data sets and files for RECEIVE FROMNETWORK and RECEIVE ORDER processing........ 248

Output...................................................................................................................................................... 261Listings................................................................................................................................................261Reports............................................................................................................................................... 261

Examples..................................................................................................................................................262Example 1: Receiving SYSMODs and HOLDDATA..............................................................................262Example 2: Receiving HOLDDATA only.............................................................................................. 262Example 3: Receiving SYSMODs only................................................................................................ 262Example 4: Receiving selected SYSMODs and HOLDDATA...............................................................263Example 5: Receiving SYSMODs and HOLDDATA for a specific FMID.............................................. 263Example 6: Receiving RELFILEs from DASD......................................................................................263Example 7: Excluding SYSMODs selected with an FMIDSET............................................................263Example 8: Issuing an internet service retrieval request................................................................. 263Example 9: Downloading a pending order........................................................................................ 264

Processing input from SMPPTFIN and SMPHOLD.................................................................................. 264Processing relative files..................................................................................................................... 265Selecting SYSMODs............................................................................................................................267Selecting ++PRODUCT and ++FEATURE statements........................................................................268Selecting ++HOLD and ++RELEASE statements............................................................................... 269Processing SYSMODs......................................................................................................................... 269Processing ++ASSIGN statements.................................................................................................... 269Processing ++PRODUCT and ++FEATURE statements..................................................................... 269Processing ++HOLD and ++RELEASE statements............................................................................ 270Compaction of inline data.................................................................................................................. 270

Processing for RECEIVE FROMNETWORK.............................................................................................. 270Processing for RECEIVE FROMNTS......................................................................................................... 272Processing for RECEIVE ORDER..............................................................................................................272

ORDER request...................................................................................................................................272Query ORDER status.......................................................................................................................... 273Network transfer................................................................................................................................ 274RECEIVE processing...........................................................................................................................274

Zone and data set sharing considerations.............................................................................................. 274

Chapter 15. The REJECT command.....................................................................277Zones for SET BOUNDARY.......................................................................................................................277Syntax...................................................................................................................................................... 277

Mass mode syntax..............................................................................................................................278Select mode syntax............................................................................................................................279PURGE mode syntax.......................................................................................................................... 280NOFMID mode syntax........................................................................................................................ 281Operands............................................................................................................................................ 281

Data sets used......................................................................................................................................... 286Output...................................................................................................................................................... 286

Reports............................................................................................................................................... 286

viii

Statistics.............................................................................................................................................286Examples..................................................................................................................................................287

Example 1: Rejecting all SYSMODs that have not been installed (mass mode)...............................287Example 2: Rejecting all SYSMODs for a specific function (mass mode)......................................... 287Example 3: Rejecting selected SYSMODs that have been applied (select mode)........................... 288Example 4: Rejecting selected SYSMODs that have been accepted and applied (select mode).... 288Example 5: Rejecting HOLDDATA that has no SYSMOD entry (select mode)...................................288Example 6: Rejecting SYSMODs that have been accepted (PURGE mode)......................................288Example 7: Rejecting SYSMODs that have been accepted and applied (PURGE mode)................. 289Example 8: Rejecting SYSMODs for undefined functions (NOFMID mode)..................................... 289Example 9: Deleting service for a group of source IDs..................................................................... 289Example 10: Rejecting selected SYSMODs that have been superseded (select mode).................. 289

Processing................................................................................................................................................290Selecting the eligible SYSMODs, FEATUREs, PRODUCTs, and HOLDDATA.......................................290Processing the SYSMODs, FEATUREs, PRODUCTs, and HOLDDATA.................................................293

Zone and data set sharing considerations.............................................................................................. 294

Chapter 16. The REPORT CROSSZONE command................................................ 295Zones for SET BOUNDARY.......................................................................................................................295Syntax...................................................................................................................................................... 295

Operands............................................................................................................................................ 295Data sets used......................................................................................................................................... 297Usage notes............................................................................................................................................. 297Output...................................................................................................................................................... 297

Reports............................................................................................................................................... 298SMPPUNCH output.............................................................................................................................298

Examples..................................................................................................................................................299Example 1: Using REPORT CROSSZONE with zones controlled by the same global zone...............299Example 2: Using REPORT CROSSZONE with zones controlled by different global zones..............302

Processing................................................................................................................................................304Zone and data set sharing considerations.............................................................................................. 305

Chapter 17. The REPORT ERRSYSMODS command..............................................307Zones for SET BOUNDARY.......................................................................................................................307Syntax...................................................................................................................................................... 307

Operands............................................................................................................................................ 307Data sets used......................................................................................................................................... 309Usage notes............................................................................................................................................. 309Output...................................................................................................................................................... 309

Reports............................................................................................................................................... 309SMPPUNCH output.............................................................................................................................309

Example: Using REPORT ERRSYSMODS................................................................................................. 311Processing................................................................................................................................................312Zone and data set sharing considerations.............................................................................................. 313

Chapter 18. The REPORT MISSINGFIX command................................................315Zones for SET BOUNDARY.......................................................................................................................315Syntax...................................................................................................................................................... 315

Operands............................................................................................................................................ 315Data sets used......................................................................................................................................... 316Usage notes............................................................................................................................................. 317Output...................................................................................................................................................... 317

Reports............................................................................................................................................... 317SMPPUNCH output.............................................................................................................................317

Example: Using REPORT MISSINGFIX....................................................................................................318Processing................................................................................................................................................320Zone and data set sharing considerations.............................................................................................. 321

ix

Chapter 19. The REPORT SOURCEID command...................................................323Zones for SET BOUNDARY.......................................................................................................................323Syntax...................................................................................................................................................... 323

Operands............................................................................................................................................ 323Data sets used......................................................................................................................................... 324Output...................................................................................................................................................... 324

Reports............................................................................................................................................... 324SMPPUNCH output.............................................................................................................................324

Examples..................................................................................................................................................325Example 1: REPORT SOURCEID (SYSMODIDS operand specified).................................................. 325Example 2: REPORT SOURCEID (SYSMODIDS operand not specified)............................................326Example 3: REPORT SOURCEID (ZONES operand specified)........................................................... 327

Processing................................................................................................................................................328Zone and data set sharing considerations.............................................................................................. 328

Chapter 20. The REPORT SYSMODS command.................................................... 331Zones for SET BOUNDARY.......................................................................................................................331Syntax...................................................................................................................................................... 331

Operands............................................................................................................................................ 331Data sets used......................................................................................................................................... 332Output...................................................................................................................................................... 332

Reports............................................................................................................................................... 332SMPPUNCH output.............................................................................................................................332

Example 1: Using REPORT SYSMODS with zones controlled by the same global zone........................ 334Example 2: Using REPORT SYSMODS with zones controlled by different global zones........................338Processing................................................................................................................................................339Zone and data set sharing considerations.............................................................................................. 341

Chapter 21. The RESETRC command.................................................................. 343Zones for SET BOUNDARY.......................................................................................................................343Syntax...................................................................................................................................................... 343Data sets used......................................................................................................................................... 343Usage notes............................................................................................................................................. 343Examples..................................................................................................................................................343

Example 1: Using RESETRC between commands for one zone........................................................343Example 2: Using RESETRC between commands for different zones..............................................344

Processing................................................................................................................................................344

Chapter 22. The RESTORE command.................................................................. 345Zones for SET BOUNDARY.......................................................................................................................345Syntax...................................................................................................................................................... 345

Operands............................................................................................................................................ 346Data sets used......................................................................................................................................... 349Usage notes............................................................................................................................................. 349Output...................................................................................................................................................... 351Examples..................................................................................................................................................351

Example 1: Restoring a single SYSMOD............................................................................................ 352Example 2: Restoring multiple PTFs to remove one PTF..................................................................352Example 3: Restoring PTFs using the GROUP operand.................................................................... 352

Processing................................................................................................................................................352SYSMOD selection..............................................................................................................................353Element installation........................................................................................................................... 354Recording after completion............................................................................................................... 357Cross-zone processing.......................................................................................................................357Global zone SYSMOD entries............................................................................................................. 358

Zone and data set sharing considerations.............................................................................................. 358

x

Chapter 23. The SET command...........................................................................361Syntax...................................................................................................................................................... 361

Operands............................................................................................................................................ 361Data sets used......................................................................................................................................... 361Usage notes............................................................................................................................................. 362Examples..................................................................................................................................................362

Example 1: Receiving SYSMODs into the SMPPTS data set..............................................................362Example 2: Applying SYSMODs to the target libraries...................................................................... 362Example 3: Accepting SYSMODs to the distribution libraries...........................................................363Example 4: Processing multiple commands in one invocation of SMP/E.........................................363Example 5: Changing which OPTIONS entry is used........................................................................ 363Example 6: Resolving errors in dynamic allocation.......................................................................... 364

Processing................................................................................................................................................364Zone and data set sharing considerations.............................................................................................. 365

Chapter 24. The UCLIN command.......................................................................367Zones for SET BOUNDARY.......................................................................................................................367UCLIN and ENDUCL syntax......................................................................................................................367

Operands............................................................................................................................................ 369UCL statement syntax..............................................................................................................................369

ASSEM entry syntax (distribution and target zone)...........................................................................371BACKUP entry syntax (SMPSCDS data set)....................................................................................... 371Data element entry syntax (distribution and target zone)................................................................ 372DDDEF entry syntax (distribution, target, and global zone)..............................................................372DLIB entry syntax (distribution and target zone).............................................................................. 375DLIBZONE entry syntax (distribution zone)...................................................................................... 376FEATURE entry syntax (global zone)................................................................................................. 376FMIDSET entry syntax (global zone)................................................................................................. 376GLOBALZONE entry syntax (global zone)..........................................................................................377Hierarchical file system element entry syntax (distribution and target zone)................................. 378Java archive (JAR) file element entry syntax (distribution and target zone)....................................379LMOD entry syntax (distribution and target zone)............................................................................ 380MAC entry syntax (distribution and target zone)...............................................................................382MOD entry syntax (distribution and target zone).............................................................................. 383MTSMAC entry syntax (SMPMTS data set)........................................................................................ 384OPTIONS entry syntax (global zone)................................................................................................. 385ORDER entry syntax (global zone).....................................................................................................386PRODUCT entry syntax (global zone)................................................................................................ 386Program element entry syntax (distribution and target zone)..........................................................387SRC entry syntax (distribution and target zone)................................................................................388STSSRC entry syntax (SMPSTS data set)...........................................................................................388SYSMOD entry syntax (distribution and target zone)........................................................................ 388SYSMOD entry syntax (global zone).................................................................................................. 392TARGETZONE entry syntax (target zone).......................................................................................... 393UTILITY entry syntax (global zone)................................................................................................... 393ZONESET entry syntax (global zone)................................................................................................. 394

Data sets used......................................................................................................................................... 394Output...................................................................................................................................................... 394Usage notes............................................................................................................................................. 394Examples..................................................................................................................................................395

Example 1: UCLIN to change a global zone entry............................................................................. 395Example 2: UCLIN to change a target zone entry............................................................................. 395Example 3: UCLIN to change a distribution zone entry.................................................................... 395Example 4: UCLIN to delete an ORDER entry in the global zone......................................................395Example 5: UCLIN to change an ORDER retention subentry in an OPTIONS entry in the global

zone............................................................................................................................................... 396

xi

Example 6: UCLIN statements using the FIXCAT subentry in various OPTIONS entries in theglobal zone.................................................................................................................................... 396

Processing................................................................................................................................................396Zone and data set sharing considerations.............................................................................................. 398

Chapter 25. The UNLOAD command....................................................................399Zones for SET BOUNDARY.......................................................................................................................399Syntax...................................................................................................................................................... 400

Operands............................................................................................................................................ 401Syntax notes.......................................................................................................................................407

Data sets used......................................................................................................................................... 408Output...................................................................................................................................................... 408Examples..................................................................................................................................................408Processing................................................................................................................................................408

Mass-mode processing...................................................................................................................... 409Select-mode processing.................................................................................................................... 409

Zone and data set sharing considerations.............................................................................................. 409

Chapter 26. The UPGRADE command................................................................. 411Zones for SET BOUNDARY.......................................................................................................................411Syntax...................................................................................................................................................... 411Operands..................................................................................................................................................411Data sets used......................................................................................................................................... 411Output...................................................................................................................................................... 411Example................................................................................................................................................... 411Processing................................................................................................................................................412Zone and data set sharing considerations.............................................................................................. 412

Chapter 27. The ZONECOPY command............................................................... 413Zones for SET BOUNDARY.......................................................................................................................413Syntax...................................................................................................................................................... 413

Operands............................................................................................................................................ 413Syntax notes.......................................................................................................................................414

Data sets used......................................................................................................................................... 414Updating cross-zone subentries............................................................................................................. 415Output...................................................................................................................................................... 415Examples..................................................................................................................................................415

Example 1: Copying a target zone to a target zone........................................................................... 415Example 2: Copying a distribution zone to a distribution zone.........................................................416Example 3: Copying a distribution zone to a target zone..................................................................416

Processing................................................................................................................................................416Zone and data set sharing considerations.............................................................................................. 417

Chapter 28. The ZONEDELETE command............................................................ 419Zones for SET BOUNDARY.......................................................................................................................419Syntax...................................................................................................................................................... 419

Operands............................................................................................................................................ 419Syntax notes.......................................................................................................................................420

Data sets used......................................................................................................................................... 420Usage notes............................................................................................................................................. 420Output...................................................................................................................................................... 421Examples..................................................................................................................................................421

Example 1: Deleting a target zone.....................................................................................................421Example 2: Deleting a distribution zone............................................................................................421

Processing................................................................................................................................................421Zone and data set sharing considerations.............................................................................................. 422

xii

Chapter 29. The ZONEEDIT command.................................................................423Zones for SET BOUNDARY.......................................................................................................................423Syntax...................................................................................................................................................... 423

Operands............................................................................................................................................ 424Syntax notes.......................................................................................................................................427Specifying a pathname on the CHANGE PATH statement................................................................ 427

Data sets used......................................................................................................................................... 428Output...................................................................................................................................................... 428Examples..................................................................................................................................................428

Example 1: Editing DDDEF entries.....................................................................................................428Example 2: Conditionally editing DDDEF entries.............................................................................. 429Example 3: Changing the SYSOUT value........................................................................................... 429Example 4: Changing the zone value in cross-zone subentries........................................................429Example 5: Changing the PATH value of DDDEF entries...................................................................430Example 6: Adding VOLUME, WAITFORDSN, and UNIT values to DDDEF entries...........................430Example 7: Adding a PRINT value to UTILITY entries...................................................................... 430

Processing................................................................................................................................................431Zone and data set sharing considerations.............................................................................................. 431

Chapter 30. The ZONEEXPORT command........................................................... 433Zones for SET BOUNDARY.......................................................................................................................433Syntax...................................................................................................................................................... 433

Operands............................................................................................................................................ 433Data sets used......................................................................................................................................... 434Usage notes............................................................................................................................................. 435Output...................................................................................................................................................... 435Example: Backing up target and distribution zones............................................................................... 435Processing................................................................................................................................................435Zone and data set sharing considerations.............................................................................................. 436

Chapter 31. The ZONEIMPORT command............................................................437Zones for SET BOUNDARY.......................................................................................................................437Syntax...................................................................................................................................................... 437

Operands............................................................................................................................................ 437Data sets used......................................................................................................................................... 438Usage notes............................................................................................................................................. 439Output...................................................................................................................................................... 439Examples..................................................................................................................................................439

Example 1: Importing a distribution zone into a target zone............................................................439Example 2: Importing a global zone..................................................................................................439Example 3: Moving a zone to another CSI data set...........................................................................440

Processing................................................................................................................................................440Zone and data set sharing considerations.............................................................................................. 441

Chapter 32. The ZONEMERGE command............................................................. 443Zones for SET BOUNDARY.......................................................................................................................443Syntax...................................................................................................................................................... 444

Operands............................................................................................................................................ 444Data sets used......................................................................................................................................... 445Usage notes............................................................................................................................................. 445Output...................................................................................................................................................... 446Examples..................................................................................................................................................446

Example 1: Creating new target zone after system generation........................................................446Example 2: Creating a test target system..........................................................................................447Example 3: Creating a test distribution system................................................................................ 448

Processing................................................................................................................................................448

xiii

SYSMOD verification processing........................................................................................................450Element and LMOD verification processing.......................................................................................451Preserving CIFREQ subentries.......................................................................................................... 452

Zone and data set sharing considerations.............................................................................................. 452

Chapter 33. The ZONERENAME command...........................................................455Zones for SET BOUNDARY.......................................................................................................................455Syntax...................................................................................................................................................... 456

Operands............................................................................................................................................ 456Data sets used......................................................................................................................................... 457Usage notes............................................................................................................................................. 458Output...................................................................................................................................................... 458Examples..................................................................................................................................................458

Example 1: Renaming an existing zone............................................................................................. 458Example 2: Creating a target zone from a distribution zone.............................................................459Example 3: Creating a duplicate copy of a CSI data set................................................................... 459

Processing................................................................................................................................................460Zone and data set sharing considerations.............................................................................................. 461

Chapter 34. SMP/E reports.................................................................................463BUILDMCS entry summary report...........................................................................................................464

Format and explanation of data.........................................................................................................464Example: BUILDMCS entry summary report.....................................................................................466

BUILDMCS function summary report......................................................................................................466Format and explanation of data.........................................................................................................466Example: BUILDMCS function summary report................................................................................467

Bypassed HOLD reason report................................................................................................................ 467Format and explanation of data.........................................................................................................468Example: Bypassed HOLD reason report.......................................................................................... 468Example: Bypassed HOLD reason report.......................................................................................... 469

Causer SYSMOD summary report........................................................................................................... 469Format and explanation of data.........................................................................................................470Example: Causer SYSMOD summary report for APPLY processing.................................................. 470

CLEANUP summary report...................................................................................................................... 471Format and explanation of data.........................................................................................................471Example: CLEANUP summary report................................................................................................ 471

Cross-zone requisite SYSMOD report......................................................................................................471Report for REPORT CROSSZONE processing.................................................................................... 471Report for APPLY and ACCEPT processing........................................................................................ 473

Cross-zone summary report....................................................................................................................474Format and explanation of data.........................................................................................................474Example: Cross-zone summary report for APPLY processing.......................................................... 477

Deleted SYSMOD report.......................................................................................................................... 477Format and explanation of data.........................................................................................................477Example: Deleted SYSMOD report for APPLY....................................................................................478

Element summary report........................................................................................................................ 478Format and explanation of data.........................................................................................................479Example: APPLY CHECK element summary report...........................................................................482

Exception SYSMOD report..............................................................................