Upload
others
View
45
Download
2
Embed Size (px)
Citation preview
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..............................................................................