utility guide and reference - ibm · utility guide and reference sc27-8860-02 ibm. db2 12 for z/os...

Db2 12 for z/OS

Utility Guide and Reference

SC27-8860-02

IBM

NotesBefore using this information and the product it supports, be sure to read the general information under Notices at theend of this information.

Subsequent editions of this PDF will not be delivered in IBM Publications Center. Always download the latest edition fromDb2 12 for z/OS Product Documentation.

July 5, 2018 edition

This edition applies to Db2 12 for z/OS (product number 5650-DB2), Db2 12 for z/OS Value Unit Edition (productnumber 5770-AF3),Db2 Utilities Suite for z/OS, Version 12 (product number 5770-AF4), and to any subsequentreleases until otherwise indicated in new editions. Make sure you are using the correct edition for the level of theproduct.

Specific changes are indicated by a vertical bar to the left of a change. A vertical bar to the left of a figure captionindicates that the figure has changed. Editorial changes that have no technical significance are not noted.

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

http://www-01.ibm.com/support/docview.wss?uid=swg27047206

Contents

About this information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvWho should read this information . . . . . . . . . . . . . . . . . . . . . . . . . . . xviDb2 Utilities Suite for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviTerminology and citations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviAccessibility features for Db2 12 for z/OS. . . . . . . . . . . . . . . . . . . . . . . . . xviiHow to send your comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiiNaming conventions used in this information . . . . . . . . . . . . . . . . . . . . . . . xviiiHow to read syntax diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx

Part 1. Basic information about the Db2 utilities . . . . . . . . . . . . . . . . 1

Chapter 1. Db2 utilities packaging . . . . . . . . . . . . . . . . . . . . . . . . 3SMP/E jobs for the Db2 Utilities Suite for z/OS product . . . . . . . . . . . . . . . . . . . . 3Operation of Db2 utilities in a mixed-release data sharing environment. . . . . . . . . . . . . . . . 4Enabling the Db2 Utilities Suite for z/OS product . . . . . . . . . . . . . . . . . . . . . . . 4

Chapter 2. Privileges and authorization IDs for Db2 utilities . . . . . . . . . . . . . 7

Chapter 3. Utilities that can be run on declared temporary objects . . . . . . . . . . 9

Chapter 4. Effect of utilities on objects that have the DEFINE NO attribute . . . . . . 11

Chapter 5. Effect of utilities on data that is encrypted through built-in functions . . . . 13

Part 2. Db2 online utilities . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Chapter 6. Invoking Db2 online utilities . . . . . . . . . . . . . . . . . . . . . . 17Data sets that online utilities use . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Utility control statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Utility concurrency and compatibility. . . . . . . . . . . . . . . . . . . . . . . . . . . 24Invoking an online utility by using the DB2 Utilities panel in DB2I . . . . . . . . . . . . . . . . . 24Invoking a Db2 utility by using the DSNU CLIST command in TSO . . . . . . . . . . . . . . . . 29

DSNU CLIST command syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31DSNU CLIST command output. . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

The supplied JCL procedure (DSNUPROC) for invoking a Db2 online utility . . . . . . . . . . . . . 36Invoking a Db2 online utility by creating the JCL data set yourself . . . . . . . . . . . . . . . . . 39

Chapter 7. Monitoring and controlling online utilities . . . . . . . . . . . . . . . . 41Monitoring utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Monitoring processor use by utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Subsystem parameters for refining DFSMSdss COPY operation with utilities . . . . . . . . . . . . . 42Determining why a utility failed to complete . . . . . . . . . . . . . . . . . . . . . . . . 44Terminating an online utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Restarting an online utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Overriding the default utility restart behavior by using the RESTART parameter . . . . . . . . . . . 49Restarting a utility after the output data set is full . . . . . . . . . . . . . . . . . . . . . 50How utilities restart with templates . . . . . . . . . . . . . . . . . . . . . . . . . . 51How utilities restart with lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Chapter 8. BACKUP SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . 53Syntax and options of the BACKUP SYSTEM control statement . . . . . . . . . . . . . . . . . . 54Before running BACKUP SYSTEM. . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Copyright IBM Corp. 1983, 2017 iii

||

Copy pools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Data sets that BACKUP SYSTEM uses . . . . . . . . . . . . . . . . . . . . . . . . . 59Concurrency and compatibility for BACKUP SYSTEM . . . . . . . . . . . . . . . . . . . . 60

Dumping a fast replication copy to tape . . . . . . . . . . . . . . . . . . . . . . . . . . 60Backups of log copy pools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Termination or restart of BACKUP SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . 61Sample BACKUP SYSTEM control statements . . . . . . . . . . . . . . . . . . . . . . . . 61

Chapter 9. CATMAINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Updating the catalog for installation or migration to Db2 12 . . . . . . . . . . . . . . . . . . . 69Renaming the owner, creator, and schema of database objects . . . . . . . . . . . . . . . . . . 70Changing the ownership of objects from an authorization ID to a role . . . . . . . . . . . . . . . . 70Changing the catalog name used by storage groups or index spaces and table spaces. . . . . . . . . . . 70Identifying invalidated packages after the owner, creator, or schema name of an object is renamed . . . . . . 71

Chapter 10. CHECK DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Syntax and options of the CHECK DATA control statement . . . . . . . . . . . . . . . . . . . 74Before running CHECK DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Data sets that CHECK DATA uses . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Concurrency and compatibility for CHECK DATA . . . . . . . . . . . . . . . . . . . . . 90

Exception tables for the CHECK DATA utility . . . . . . . . . . . . . . . . . . . . . . . . 92Exception processing for tables with auxiliary columns . . . . . . . . . . . . . . . . . . . . . 93Specifying the scope of CHECK DATA . . . . . . . . . . . . . . . . . . . . . . . . . . 94How violations are identified . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94Detection and correction of constraint violations . . . . . . . . . . . . . . . . . . . . . . . 95CHECK DATA XML error detection . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Correcting XML data after running CHECK DATA . . . . . . . . . . . . . . . . . . . . . . 96Resetting CHECK-pending status . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97LOB column errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Resetting auxiliary CHECK-pending status . . . . . . . . . . . . . . . . . . . . . . . . . 98Termination and restart of CHECK DATA . . . . . . . . . . . . . . . . . . . . . . . . . 99Sample CHECK DATA control statements . . . . . . . . . . . . . . . . . . . . . . . . . 99

Chapter 11. CHECK INDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . 103Syntax and options of the CHECK INDEX control statement . . . . . . . . . . . . . . . . . . 104Data sets that CHECK INDEX uses . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Shadow data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Concurrency and compatibility for CHECK INDEX . . . . . . . . . . . . . . . . . . . . . . 111Single logical partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Indexes in parallel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114Reviewing CHECK INDEX output . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Termination or restart of CHECK INDEX . . . . . . . . . . . . . . . . . . . . . . . . . 118Correcting XML data after running CHECK INDEX . . . . . . . . . . . . . . . . . . . . . 118Sample CHECK INDEX control statements . . . . . . . . . . . . . . . . . . . . . . . . 118

Chapter 12. CHECK LOB . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Syntax and options of the CHECK LOB control statement . . . . . . . . . . . . . . . . . . . 122Before running CHECK LOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Data sets that CHECK LOB uses . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Concurrency and compatibility for CHECK LOB . . . . . . . . . . . . . . . . . . . . . 128

How CHECK LOB identifies violations . . . . . . . . . . . . . . . . . . . . . . . . . . 129Removing CHECK-pending status for a LOB table space . . . . . . . . . . . . . . . . . . . . 129Resolving media failure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129Termination or restart of CHECK LOB . . . . . . . . . . . . . . . . . . . . . . . . . . 130Sample CHECK LOB control statements . . . . . . . . . . . . . . . . . . . . . . . . . 130

Chapter 13. COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Syntax and options of the COPY control statement . . . . . . . . . . . . . . . . . . . . . . 135Before running COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

Data sets that COPY uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

iv Utility Guide and Reference

Concurrency and compatibility for COPY . . . . . . . . . . . . . . . . . . . . . . . . 150Full image copies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153Incremental image copies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154Multiple image copies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155FlashCopy image copies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Copies of lists of objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Using more than one COPY statement . . . . . . . . . . . . . . . . . . . . . . . . . . 163Copying partitions or data sets simultaneously . . . . . . . . . . . . . . . . . . . . . . . 164Copies of partition-by-growth table spaces . . . . . . . . . . . . . . . . . . . . . . . . 164Copies of XML table spaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164Copying catalog and directory objects . . . . . . . . . . . . . . . . . . . . . . . . . . 165Make copies of XML schema repository objects . . . . . . . . . . . . . . . . . . . . . . . 166Copies of Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Using DFSMSdss concurrent copy . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Specifying conditional image copies . . . . . . . . . . . . . . . . . . . . . . . . . . . 168Allocation of sequential image copy data sets . . . . . . . . . . . . . . . . . . . . . . . 169Preparing for recovery by using the COPY utility . . . . . . . . . . . . . . . . . . . . . . 170Improving performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Generation data group definitions for the COPY utility . . . . . . . . . . . . . . . . . . . . 171Using Db2 with DFSMS products. . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Image copies on tape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Termination of COPY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Restart of COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Sample COPY control statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

Chapter 14. COPYTOCOPY . . . . . . . . . . . . . . . . . . . . . . . . . . 185Syntax and options of the COPYTOCOPY control statement . . . . . . . . . . . . . . . . . . . 186Data sets that COPYTOCOPY uses . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Concurrency and compatibility for COPYTOCOPY . . . . . . . . . . . . . . . . . . . . . . 193Full or incremental image copies with COPYTOCOPY. . . . . . . . . . . . . . . . . . . . . 194Incremental image copies with COPYTOCOPY . . . . . . . . . . . . . . . . . . . . . . . 194Using more than one COPYTOCOPY statement . . . . . . . . . . . . . . . . . . . . . . . 194Copying from a specific image copy. . . . . . . . . . . . . . . . . . . . . . . . . . . 195Copying a FlashCopy image copy by using COPYTOCOPY . . . . . . . . . . . . . . . . . . . 195Using TEMPLATE with COPYTOCOPY . . . . . . . . . . . . . . . . . . . . . . . . . 196Updating SYSCOPY records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196How COPYTOCOPY determines which input copy to use . . . . . . . . . . . . . . . . . . . 196Generation data group definitions for the COPYTOCOPY utility . . . . . . . . . . . . . . . . . 196Using Db2 with DFSMS products. . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Image copies on tape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Copies of lists of objects from tape . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Termination or restart of COPYTOCOPY . . . . . . . . . . . . . . . . . . . . . . . . . 198Sample COPYTOCOPY control statements. . . . . . . . . . . . . . . . . . . . . . . . . 199

Chapter 15. DIAGNOSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203How to force a utility abend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

Chapter 16. EXEC SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

Chapter 17. LISTDEF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215Syntax and options of the LISTDEF control statement . . . . . . . . . . . . . . . . . . . . . 215Concurrency and compatibility for LISTDEF . . . . . . . . . . . . . . . . . . . . . . . . 225Creating the LISTDEF control statement . . . . . . . . . . . . . . . . . . . . . . . . . 226How to include objects in a list . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226Previewing the contents of a list . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230Creating LISTDEF libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230Referencing LISTDEF lists in other utility jobs . . . . . . . . . . . . . . . . . . . . . . . 231Using the TEMPLATE utility with LISTDEF . . . . . . . . . . . . . . . . . . . . . . . . 233Using the OPTIONS utility with LISTDEF . . . . . . . . . . . . . . . . . . . . . . . . . 233Termination or restart of LISTDEF . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

Contents v

Sample LISTDEF control statements . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

Chapter 18. LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239Syntax and options of the LOAD control statement. . . . . . . . . . . . . . . . . . . . . . 242Before running LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306

Data sets that LOAD uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308Concurrency and compatibility for LOAD . . . . . . . . . . . . . . . . . . . . . . . . 313Preparing Db2 internal format input records that are not generated by UNLOAD for LOAD . . . . . . . 315

When to use SORTKEYS NO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315Loading variable-length data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316How LOAD orders loaded records . . . . . . . . . . . . . . . . . . . . . . . . . . . 316Replacing data with LOAD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316Loading tables with special column types by using generated LOAD statements . . . . . . . . . . . . 319Adding more data to a table or partition . . . . . . . . . . . . . . . . . . . . . . . . . 321Deleting all the data in a table space . . . . . . . . . . . . . . . . . . . . . . . . . . 321Loading partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322Loading partition-by-growth table spaces . . . . . . . . . . . . . . . . . . . . . . . . . 325Loading data containing XML columns . . . . . . . . . . . . . . . . . . . . . . . . . . 325Loading delimited files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326Loading data with referential constraints . . . . . . . . . . . . . . . . . . . . . . . . . 329Referential constraint violations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331Compressing data by using the LOAD utility. . . . . . . . . . . . . . . . . . . . . . . . 331How to load data from DL/I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333Loading data by using the cross-loader function. . . . . . . . . . . . . . . . . . . . . . . 334How to use inline COPY with LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . 335Creating a FlashCopy image copy with LOAD . . . . . . . . . . . . . . . . . . . . . . . 336Improving LOAD performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337Conversion of input data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341Specifying input fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342Specifying the TRUNCATE and STRIP options . . . . . . . . . . . . . . . . . . . . . . . 343How LOAD builds indexes while loading data . . . . . . . . . . . . . . . . . . . . . . . 343Building indexes in parallel for LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . 344How LOAD leaves free space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347Loading with RECOVER-pending, REBUILD-pending, or REORG-pending status . . . . . . . . . . . 347Exit procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348Loading ROWID columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348Loading a LOB column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349LOAD LOG on a LOB table space . . . . . . . . . . . . . . . . . . . . . . . . . . . 350Loading an XML column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350LOAD LOG on an XML table space . . . . . . . . . . . . . . . . . . . . . . . . . . . 351Running LOAD RESUME YES SHRLEVEL CHANGE without logging . . . . . . . . . . . . . . . 351Collecting inline statistics while loading a table . . . . . . . . . . . . . . . . . . . . . . . 352Inline COPY for a base table space . . . . . . . . . . . . . . . . . . . . . . . . . . . 353Termination of LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353Restart of LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354After running LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

Copying the loaded table space or partition . . . . . . . . . . . . . . . . . . . . . . . 356Resetting restricted status after running the LOAD utility . . . . . . . . . . . . . . . . . . 356Running CHECK INDEX after loading a table that has indexes. . . . . . . . . . . . . . . . . 360Recovering data after a failed LOAD job . . . . . . . . . . . . . . . . . . . . . . . . 360Reorganization of an auxiliary index after LOAD . . . . . . . . . . . . . . . . . . . . . 361

Effects of running LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361Sample LOAD control statements. . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

Chapter 19. MERGECOPY . . . . . . . . . . . . . . . . . . . . . . . . . . . 377Syntax and options of the MERGECOPY control statement . . . . . . . . . . . . . . . . . . . 378Data sets that MERGECOPY uses . . . . . . . . . . . . . . . . . . . . . . . . . . . 380Concurrency and compatibility for MERGECOPY . . . . . . . . . . . . . . . . . . . . . . 382Full or incremental image copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382How MERGECOPY determines which input copy to use . . . . . . . . . . . . . . . . . . . . 383

vi Utility Guide and Reference

Merging online copies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383Using MERGECOPY with individual data sets . . . . . . . . . . . . . . . . . . . . . . . 383Using MERGECOPY or COPY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384Avoiding MERGECOPY LOG RBA inconsistencies . . . . . . . . . . . . . . . . . . . . . . 384Termination or restart of MERGECOPY. . . . . . . . . . . . . . . . . . . . . . . . . . 384Sample MERGECOPY control statements . . . . . . . . . . . . . . . . . . . . . . . . . 385

Chapter 20. MODIFY RECOVERY . . . . . . . . . . . . . . . . . . . . . . . . 387How MODIFY RECOVERY deletes rows . . . . . . . . . . . . . . . . . . . . . . . . . 393Reclaiming space in the DBD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395Improving REORG performance after adding a column . . . . . . . . . . . . . . . . . . . . 396The effect of MODIFY RECOVERY on version numbers . . . . . . . . . . . . . . . . . . . . 396Sample MODIFY RECOVERY control statements . . . . . . . . . . . . . . . . . . . . . . 397

Chapter 21. MODIFY STATISTICS . . . . . . . . . . . . . . . . . . . . . . . . 401Syntax and options of the MODIFY STATISTICS control statement . . . . . . . . . . . . . . . . 402Data sets that MODIFY STATISTICS uses . . . . . . . . . . . . . . . . . . . . . . . . . 404Concurrency and compatibility for MODIFY STATISTICS. . . . . . . . . . . . . . . . . . . . 404Guidelines for deciding which statistics history rows to delete . . . . . . . . . . . . . . . . . . 405Deletion of specific statistics history rows . . . . . . . . . . . . . . . . . . . . . . . . . 405Termination or restart of MODIFY STATISTICS . . . . . . . . . . . . . . . . . . . . . . . 405Sample MODIFY STATISTICS control statements . . . . . . . . . . . . . . . . . . . . . . 406

Chapter 22. OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409Syntax and options of the OPTIONS control statement . . . . . . . . . . . . . . . . . . . . 409Concurrency and compatibility for OPTIONS. . . . . . . . . . . . . . . . . . . . . . . . 412Executing statements in preview mode . . . . . . . . . . . . . . . . . . . . . . . . . . 413Specifying LISTDEF and TEMPLATE libraries . . . . . . . . . . . . . . . . . . . . . . . 413Overriding standard utility processing behavior . . . . . . . . . . . . . . . . . . . . . . . 413Termination or restart of OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . 414Sample OPTIONS control statements . . . . . . . . . . . . . . . . . . . . . . . . . . 414

Chapter 23. QUIESCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417Syntax and options of the QUIESCE control statement. . . . . . . . . . . . . . . . . . . . . 418Before running QUIESCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

Data sets that QUIESCE uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420Concurrency and compatibility for QUIESCE . . . . . . . . . . . . . . . . . . . . . . . 421

Use of QUIESCE on catalog and directory objects . . . . . . . . . . . . . . . . . . . . . . 422Common quiesce points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423Running QUIESCE on a table space in pending status . . . . . . . . . . . . . . . . . . . . . 424Reasons why QUIESCE fails to write to disk . . . . . . . . . . . . . . . . . . . . . . . . 424Termination and restart of QUIESCE . . . . . . . . . . . . . . . . . . . . . . . . . . 424Sample QUIESCE control statements . . . . . . . . . . . . . . . . . . . . . . . . . . 425

Chapter 24. REBUILD INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . 429Syntax and options of the REBUILD INDEX control statement . . . . . . . . . . . . . . . . . . 430Before running REBUILD INDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . 442

Data sets that REBUILD INDEX uses . . . . . . . . . . . . . . . . . . . . . . . . . 443Concurrency and compatibility for REBUILD INDEX . . . . . . . . . . . . . . . . . . . . 445

Access with REBUILD INDEX SHRLEVEL . . . . . . . . . . . . . . . . . . . . . . . . 447Rebuilding index partitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448Rebuilding indexes on partition-by-growth table spaces . . . . . . . . . . . . . . . . . . . . 448How to improve performance when rebuilding index partitions . . . . . . . . . . . . . . . . . 448Rebuilding multiple indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450Resetting the REBUILD-pending status . . . . . . . . . . . . . . . . . . . . . . . . . . 454Rebuilding critical catalog indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . 455Recoverability of a rebuilt index . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455Creating a FlashCopy image copy with REBUILD INDEX . . . . . . . . . . . . . . . . . . . 455Termination or restart of REBUILD INDEX . . . . . . . . . . . . . . . . . . . . . . . . 456The effect of REBUILD INDEX on index version numbers . . . . . . . . . . . . . . . . . . . 456

Contents vii

Sample REBUILD INDEX control statements . . . . . . . . . . . . . . . . . . . . . . . . 457

Chapter 25. RECOVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461Syntax and options of the RECOVER control statement . . . . . . . . . . . . . . . . . . . . 463Before running RECOVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476

Data sets that RECOVER uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476Concurrency and compatibility for RECOVER . . . . . . . . . . . . . . . . . . . . . . 477

Recovering with a system-level backup. . . . . . . . . . . . . . . . . . . . . . . . . . 479How to determine which system-level backups Db2 recovers . . . . . . . . . . . . . . . . . . 480Determining which recovery base Db2 uses . . . . . . . . . . . . . . . . . . . . . . . . 481Determining whether the system-level backups reside on disk or tape . . . . . . . . . . . . . . . 481Recovering a table space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482Recovering a list of objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482Recovering a data set or partition . . . . . . . . . . . . . . . . . . . . . . . . . . . 483Recovering with incremental copies . . . . . . . . . . . . . . . . . . . . . . . . . . . 484Recovering with FlashCopy image copies . . . . . . . . . . . . . . . . . . . . . . . . . 484Recovering a page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486Recovering an error range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487Effect on RECOVER of the NOT LOGGED or LOGGED table space attributes . . . . . . . . . . . . . 487Recovering with a data set copy that is not made by Db2 . . . . . . . . . . . . . . . . . . . 488Recovering catalog and directory objects . . . . . . . . . . . . . . . . . . . . . . . . . 489

Objects that contain recovery information . . . . . . . . . . . . . . . . . . . . . . . . 493Point-in-time recovery of the catalog, directory, and all user objects . . . . . . . . . . . . . . . 495

Reinitializing DSNDB01.SYSUTILX . . . . . . . . . . . . . . . . . . . . . . . . . . . 496Recovering a table space that contains LOB or XML data . . . . . . . . . . . . . . . . . . . . 497Recovering a table space that contains clone objects . . . . . . . . . . . . . . . . . . . . . 498Point-in-time recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498Avoiding specific image copy data sets during a recovery . . . . . . . . . . . . . . . . . . . 507How to improve RECOVER performance . . . . . . . . . . . . . . . . . . . . . . . . . 508Optimizing the LOGAPPLY phase . . . . . . . . . . . . . . . . . . . . . . . . . . . 509Recovering image copies in a JES3 environment . . . . . . . . . . . . . . . . . . . . . . . 510Resetting RECOVER-pending or REBUILD-pending status . . . . . . . . . . . . . . . . . . . 510How the RECOVER utility allocates incremental image copies . . . . . . . . . . . . . . . . . . 511How the RECOVER utility performs fallback recovery. . . . . . . . . . . . . . . . . . . . . 511How the RECOVER utility retains tape mounts . . . . . . . . . . . . . . . . . . . . . . . 512Avoiding damaged media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512Termination or restart of RECOVER . . . . . . . . . . . . . . . . . . . . . . . . . . . 513Effects of running RECOVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514Sample RECOVER control statements . . . . . . . . . . . . . . . . . . . . . . . . . . 514

Chapter 26. REORG INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . 519Syntax and options of the REORG INDEX control statement . . . . . . . . . . . . . . . . . . 520Before running REORG INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538

Data sets that REORG INDEX uses . . . . . . . . . . . . . . . . . . . . . . . . . . 540Concurrency and compatibility for REORG INDEX . . . . . . . . . . . . . . . . . . . . . 544

Determining which indexes require reorganization . . . . . . . . . . . . . . . . . . . . . . 545Using the LEAFDISTLIMIT and REPORTONLY options to determine when reorganization is needed . . . . . 546Access with REORG INDEX SHRLEVEL . . . . . . . . . . . . . . . . . . . . . . . . . 547Creating a FlashCopy image copy with REORG INDEX . . . . . . . . . . . . . . . . . . . . 549Temporarily interrupting REORG. . . . . . . . . . . . . . . . . . . . . . . . . . . . 549Improving performance with REORG INDEX . . . . . . . . . . . . . . . . . . . . . . . 550Termination of REORG INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551Restart of REORG INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552Review of REORG INDEX output . . . . . . . . . . . . . . . . . . . . . . . . . . . 553Effect of REORG INDEX on index version numbers . . . . . . . . . . . . . . . . . . . . . 553Sample REORG INDEX control statements . . . . . . . . . . . . . . . . . . . . . . . . 554

Chapter 27. REORG TABLESPACE . . . . . . . . . . . . . . . . . . . . . . . 557Syntax and options of the REORG TABLESPACE control statement . . . . . . . . . . . . . . . . 561Before running REORG TABLESPACE . . . . . . . . . . . . . . . . . . . . . . . . . . 607

viii Utility Guide and Reference

Data sets that REORG TABLESPACE uses . . . . . . . . . . . . . . . . . . . . . . . . 613Concurrency and compatibility for REORG TABLESPACE . . . . . . . . . . . . . . . . . . 621

Determining whether an object requires reorganization . . . . . . . . . . . . . . . . . . . . 626Access with REORG TABLESPACE SHRLEVEL . . . . . . . . . . . . . . . . . . . . . . . 628Unloading without reloading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631Reclaiming space from dropped tables . . . . . . . . . . . . . . . . . . . . . . . . . . 632Reorganizing the catalog and directory . . . . . . . . . . . . . . . . . . . . . . . . . . 632Changing data set definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635Temporarily interrupting REORG. . . . . . . . . . . . . . . . . . . . . . . . . . . . 636How to override dynamic sort work data set allocation . . . . . . . . . . . . . . . . . . . . 636Redistributing data across partitions by using REORG. . . . . . . . . . . . . . . . . . . . . 637How partitions can be unloaded and reloaded in parallel. . . . . . . . . . . . . . . . . . . . 638How to use inline copy with REORG TABLESPACE . . . . . . . . . . . . . . . . . . . . . 638Creating a FlashCopy image copy with REORG TABLESPACE . . . . . . . . . . . . . . . . . . 639Improving REORG TABLESPACE performance . . . . . . . . . . . . . . . . . . . . . . . 640Parallel index building for REORG TABLESPACE . . . . . . . . . . . . . . . . . . . . . . 642How Db2 unloads data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646Failure during the RELOAD phase . . . . . . . . . . . . . . . . . . . . . . . . . . . 646Reorganization of partitioned table spaces . . . . . . . . . . . . . . . . . . . . . . . . . 646Reorganization of partition-by-growth table spaces . . . . . . . . . . . . . . . . . . . . . . 646Reorganization of segmented table spaces . . . . . . . . . . . . . . . . . . . . . . . . . 647Comparison of the numbers of loaded and unloaded records . . . . . . . . . . . . . . . . . . 648Reorganization of a LOB table space. . . . . . . . . . . . . . . . . . . . . . . . . . . 648Reorganization of an XML table space . . . . . . . . . . . . . . . . . . . . . . . . . . 650Reorganization with pending definition changes. . . . . . . . . . . . . . . . . . . . . . . 651Compression after materialization of inline LOB changes . . . . . . . . . . . . . . . . . . . . 652Termination of REORG TABLESPACE . . . . . . . . . . . . . . . . . . . . . . . . . . 652Restart of REORG TABLESPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654Review of REORG TABLESPACE output . . . . . . . . . . . . . . . . . . . . . . . . . 656After running REORG TABLESPACE . . . . . . . . . . . . . . . . . . . . . . . . . . 657Effects of running REORG TABLESPACE . . . . . . . . . . . . . . . . . . . . . . . . . 657Sample REORG TABLESPACE control statements . . . . . . . . . . . . . . . . . . . . . . 659

Chapter 28. REPAIR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673Syntax and options of the REPAIR control statement . . . . . . . . . . . . . . . . . . . . . 674Before running REPAIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693

Data sets that REPAIR uses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694Concurrency and compatibility for REPAIR . . . . . . . . . . . . . . . . . . . . . . . 694

Resetting table space status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697Resetting index space status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698Repairing a damaged page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698Repairing DBDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698Locating rows by key. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700Using VERIFY with REPLACE and DELETE operations . . . . . . . . . . . . . . . . . . . . 700Repairing critical catalog table spaces and indexes . . . . . . . . . . . . . . . . . . . . . . 700Termination or restart of REPAIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701Review of REPAIR output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701After running REPAIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701Sample REPAIR control statements . . . . . . . . . . . . . . . . . . . . . . . . . . . 702

Chapter 29. REPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 705Syntax and options of the REPORT control statement . . . . . . . . . . . . . . . . . . . . . 706Data sets that REPORT uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711Concurrency and compatibility for REPORT . . . . . . . . . . . . . . . . . . . . . . . . 711Running REPORT on the catalog and directory . . . . . . . . . . . . . . . . . . . . . . . 711Termination or restart of REPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . 712REPORT output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712Sample REPORT control statements . . . . . . . . . . . . . . . . . . . . . . . . . . . 718

Contents ix

||

Chapter 30. RESTORE SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . 735Syntax and options of the RESTORE SYSTEM control statement . . . . . . . . . . . . . . . . . 736Before running RESTORE SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . 739While running RESTORE SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . 741After running RESTORE SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . 743Sample RESTORE SYSTEM control statements . . . . . . . . . . . . . . . . . . . . . . . 744

Chapter 31. RUNSTATS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747RUNSTATS TABLESPACE syntax and options . . . . . . . . . . . . . . . . . . . . . . . 749RUNSTATS INDEX syntax and options. . . . . . . . . . . . . . . . . . . . . . . . . . 765Statistics profile syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772Data sets that RUNSTATS uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774Concurrency and compatibility for RUNSTATS . . . . . . . . . . . . . . . . . . . . . . . 777Collecting distribution statistics for column groups . . . . . . . . . . . . . . . . . . . . . . 778Updating statistics for a partitioned table space . . . . . . . . . . . . . . . . . . . . . . . 779Collection of statistics on the Db2 catalog and directory . . . . . . . . . . . . . . . . . . . . 779Collecting frequency statistics for data-partitioned secondary indexes . . . . . . . . . . . . . . . 780Collecting statistics history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780Collection of statistics on LOB table spaces . . . . . . . . . . . . . . . . . . . . . . . . 781Collection of statistics on XML objects . . . . . . . . . . . . . . . . . . . . . . . . . . 781Review of RUNSTATS output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 783Resetting access path statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 788Sample RUNSTATS control statements . . . . . . . . . . . . . . . . . . . . . . . . . . 790

Chapter 32. STOSPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 795Syntax and options of the STOSPACE control statement . . . . . . . . . . . . . . . . . . . . 796Data sets that STOSPACE uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . 796Concurrency and compatibility for STOSPACE . . . . . . . . . . . . . . . . . . . . . . . 797How STOSPACE ensures availability of objects it STOSPACE requires . . . . . . . . . . . . . . . 797Obtaining statistical information with STOSPACE . . . . . . . . . . . . . . . . . . . . . . 797Analysis of the values in a SPACE or SPACEF column . . . . . . . . . . . . . . . . . . . . 798Termination or restart of STOSPACE. . . . . . . . . . . . . . . . . . . . . . . . . . . 799Sample STOSPACE control statement . . . . . . . . . . . . . . . . . . . . . . . . . . 799

Chapter 33. TEMPLATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 801Syntax and options of the TEMPLATE control statement . . . . . . . . . . . . . . . . . . . . 801Before running TEMPLATE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 818

Concurrency and compatibility for TEMPLATE . . . . . . . . . . . . . . . . . . . . . . 818Key TEMPLATE operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 818Choosing data set names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 819Default space calculations for data set templates. . . . . . . . . . . . . . . . . . . . . . . 820Guidelines for templates and tape data sets . . . . . . . . . . . . . . . . . . . . . . . . 821How TEMPLATE supports GDG data sets. . . . . . . . . . . . . . . . . . . . . . . . . 823Template switching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 823Termination or restart of TEMPLATE . . . . . . . . . . . . . . . . . . . . . . . . . . 823Sample TEMPLATE control statements . . . . . . . . . . . . . . . . . . . . . . . . . . 823

Chapter 34. UNLOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 829Syntax and options of the UNLOAD control statement . . . . . . . . . . . . . . . . . . . . 833Unloading partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 873Unloading XML data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 873Unloading LOB data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 874Unloading data in spanned record format . . . . . . . . . . . . . . . . . . . . . . . . . 875Selecting tables and rows to unload . . . . . . . . . . . . . . . . . . . . . . . . . . . 876Selecting and ordering columns to unload . . . . . . . . . . . . . . . . . . . . . . . . . 877Unloading data from image copy data sets . . . . . . . . . . . . . . . . . . . . . . . . 877Data conversion with the UNLOAD utility . . . . . . . . . . . . . . . . . . . . . . . . 879Output field types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 880Output field positioning and size. . . . . . . . . . . . . . . . . . . . . . . . . . . . 882Layout of output fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 882

x Utility Guide and Reference

Output for special values Infinity, sNaN, or NaN . . . . . . . . . . . . . . . . . . . . . . 885Unloading delimited files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 885Specifying TRUNCATE and STRIP options for output data . . . . . . . . . . . . . . . . . . . 888LOAD statements that are generated by UNLOAD . . . . . . . . . . . . . . . . . . . . . . 889Unloading compressed data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 890Field specification errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 890Sample UNLOAD control statements . . . . . . . . . . . . . . . . . . . . . . . . . . 890

Part 3. Db2 stand-alone utilities . . . . . . . . . . . . . . . . . . . . . . . 897

Chapter 35. Invoking stand-alone utilities . . . . . . . . . . . . . . . . . . . . 899Specifying options for stand-alone utilities by using the JCL EXEC PARM parameter . . . . . . . . . . 900Stand-alone utility control statements . . . . . . . . . . . . . . . . . . . . . . . . . . 900

Chapter 36. DSNJCNVB . . . . . . . . . . . . . . . . . . . . . . . . . . . . 903

Chapter 37. DSNJCNVT . . . . . . . . . . . . . . . . . . . . . . . . . . . . 905

Chapter 38. DSNJLOGF (preformat active log) . . . . . . . . . . . . . . . . . . 909

Chapter 39. DSNJU003 (change log inventory) . . . . . . . . . . . . . . . . . . 911Making changes for active logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 926Making changes for archive logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 928A conditional restart control record . . . . . . . . . . . . . . . . . . . . . . . . . . . 929Deleting log data sets with errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . 929Altering references to log data sets in the BSDS . . . . . . . . . . . . . . . . . . . . . . . 930Defining the high-level qualifier for catalog and directory objects . . . . . . . . . . . . . . . . . 931Renaming Db2 system data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . 931Renaming Db2 active log data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . 932Renaming Db2 archive log data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . 932Sample DSNJU003 control statements . . . . . . . . . . . . . . . . . . . . . . . . . . 932

Chapter 40. DSNJU004 (print log map) . . . . . . . . . . . . . . . . . . . . . 935Syntax and options of the DSNJU004 control statement . . . . . . . . . . . . . . . . . . . . 936Sample DSNJU004 control statement . . . . . . . . . . . . . . . . . . . . . . . . . . 937DSNJU004 (print log map) output . . . . . . . . . . . . . . . . . . . . . . . . . . . 937

Chapter 41. DSN1COMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 953Syntax and options of the DSN1COMP control statement. . . . . . . . . . . . . . . . . . . . 955Before running DSN1COMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 958How to estimate compression savings achieved with option REORG . . . . . . . . . . . . . . . . 959Free space in compression calculations on table space . . . . . . . . . . . . . . . . . . . . . 959Sample DSN1COMP control statements . . . . . . . . . . . . . . . . . . . . . . . . . 960DSN1COMP output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 963

Chapter 42. DSN1COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . 967Syntax and options of the DSN1COPY control statement . . . . . . . . . . . . . . . . . . . . 970Before running DSN1COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976

Data sets that DSN1COPY uses . . . . . . . . . . . . . . . . . . . . . . . . . . . 978Inconsistent data checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 983The effects of not specifying the OBIDXLAT option. . . . . . . . . . . . . . . . . . . . . . 983Requirements for using an image copy as input to DSN1COPY. . . . . . . . . . . . . . . . . . 984Copying from an image copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 984Restoring indexes with DSN1COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . 985Restoring table spaces with DSN1COPY . . . . . . . . . . . . . . . . . . . . . . . . . 985Printing with DSN1COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 987Copying tables from one subsystem to another . . . . . . . . . . . . . . . . . . . . . . . 987Sample DSN1COPY control statements . . . . . . . . . . . . . . . . . . . . . . . . . . 989

Contents xi

Chapter 43. DSN1LOGP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 995Syntax and options of the DSN1LOGP control statement . . . . . . . . . . . . . . . . . . . . 997Determining the PSID for base and clone objects . . . . . . . . . . . . . . . . . . . . . . 1005Archive log data sets on tape. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1005Sample DSN1LOGP control statements . . . . . . . . . . . . . . . . . . . . . . . . . 1006DSN1LOGP output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1009

Chapter 44. DSN1PRNT . . . . . . . . . . . . . . . . . . . . . . . . . . . 1015Syntax and options of the DSN1PRNT control statement . . . . . . . . . . . . . . . . . . . 1016Printing with DSN1PRNT instead of DSN1COPY . . . . . . . . . . . . . . . . . . . . . . 1022Determining the page size and data set size for DSN1PRNT . . . . . . . . . . . . . . . . . . 1022Sample DSN1PRNT control statements . . . . . . . . . . . . . . . . . . . . . . . . . 1023

Chapter 45. DSN1SDMP . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027Syntax and options of the DSN1SDMP control statement . . . . . . . . . . . . . . . . . . . 1028Assigning buffers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1033Conditions for generating a dump . . . . . . . . . . . . . . . . . . . . . . . . . . . 1034Stopping or modifying DSN1SDMP traces . . . . . . . . . . . . . . . . . . . . . . . . 1034Sample DSN1SDMP control statements . . . . . . . . . . . . . . . . . . . . . . . . . 1035

Part 4. Appendixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1039

Appendix A. Limits in Db2 for z/OS . . . . . . . . . . . . . . . . . . . . . . 1041

Appendix B. Supplied stored procedures for utility operations. . . . . . . . . . . 1049

Appendix C. Advisory or restrictive states . . . . . . . . . . . . . . . . . . . 1051Auxiliary CHECK-pending status . . . . . . . . . . . . . . . . . . . . . . . . . . . 1051Auxiliary warning status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1052CHECK-pending status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1053COPY-pending status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1054DBETE status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1055Group buffer pool RECOVER-pending status . . . . . . . . . . . . . . . . . . . . . . . 1056Informational COPY-pending status . . . . . . . . . . . . . . . . . . . . . . . . . . 1057PRO restricted status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1057REBUILD-pending status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1058RECOVER-pending status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1059REFRESH-pending status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1060REORG-pending status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1060Restart-pending status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1063

Appendix D. Productivity-aid sample programs . . . . . . . . . . . . . . . . . 1065DSNTIAUL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1066DSNTIAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1072DSNTEP2 and DSNTEP4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1074

Appendix E. DSN1SMFP . . . . . . . . . . . . . . . . . . . . . . . . . . . 1081Before running DSN1SMFP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1083Running DSN1SMFP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1083Sample DSN1SMFP control statement . . . . . . . . . . . . . . . . . . . . . . . . . . 1084DSN1SMFP output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1084DSN1SMFP output record structure . . . . . . . . . . . . . . . . . . . . . . . . . . 1086

Standard report header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1086IFCID003: DDF Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1087IFCID004: Trace Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1089IFCID005: Trace Stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1089IFCID023: Utility Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1090IFCID024: Utility Change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1093

xii Utility Guide and Reference

IFCID025: Utility End . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1094IFCID083: Identify End . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1095IFCID106: System Parameters (security-relevant fields only) . . . . . . . . . . . . . . . . . 1096IFCID140: Audit Authorization Failures . . . . . . . . . . . . . . . . . . . . . . . . 1105IFCID141: Audit DDL Grant/Revoke . . . . . . . . . . . . . . . . . . . . . . . . . 1111IFCID142: Audit DDL Create/Alter/Drop . . . . . . . . . . . . . . . . . . . . . . . 1112IFCID143: Audit First Write . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1114IFCID144: Audit First Read . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1115IFCID145: Audit DML Statement . . . . . . . . . . . . . . . . . . . . . . . . . . 1116IFCID269: Trusted Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . 1117IFCID270: Trusted Context. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1119IFCID350: SQL Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1120IFCID361: Audit Administrative Authorities . . . . . . . . . . . . . . . . . . . . . . . 1121IFCID362: Trace Start and Stop with AUDITPOLICY . . . . . . . . . . . . . . . . . . . . 1125SYSPRINT: Runtime messages and end-of-job summary . . . . . . . . . . . . . . . . . . . 1127

Appendix F. DSNADMSB . . . . . . . . . . . . . . . . . . . . . . . . . . . 1129Parameters of the DSNADMSB program . . . . . . . . . . . . . . . . . . . . . . . . . 1130Before running DSNADMSB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1138Data sets that DSNADMSB uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1139Copying the data that DSNADMSB and ADMIN_INFO_SQL collect to another subsystem . . . . . . . . 1139Examples of DSNADMSB invocation . . . . . . . . . . . . . . . . . . . . . . . . . . 1140

Appendix G. DSNTSMFD . . . . . . . . . . . . . . . . . . . . . . . . . . . 1149Before running DSNTSMFD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1149Data sets that DSNTSMFD uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1150Examples of DSNTSMFD invocation . . . . . . . . . . . . . . . . . . . . . . . . . . 1150

Appendix H. How real-time statistics are used by Db2 utilities . . . . . . . . . . . 1153

Appendix I. Delimited file format. . . . . . . . . . . . . . . . . . . . . . . . 1155Data types in delimited files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1156Examples of delimited files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1157

Information resources for Db2 12 for z/OS and related products . . . . . . . . . . 1159

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1161Programming interface information. . . . . . . . . . . . . . . . . . . . . . . . . . . 1162Trademarks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1163Terms and conditions for product documentation . . . . . . . . . . . . . . . . . . . . . . 1164Privacy policy considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1164

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1167

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1169

Contents xiii

xiv Utility Guide and Reference

About this information

This information contains usage information for the tasks of system administration,database administration, and operation. It presents detailed information aboutusing utilities, specifying syntax (including keyword and parameter descriptions),and starting, stopping, and restarting utilities. This book also includes job controllanguage (JCL) and control statements for each utility.

Throughout this information, Db2 means Db2 12 for z/OS. References toother Db2 products use complete names or specific abbreviations.

Important: To find the most up to date content, always use IBM KnowledgeCenter, which is continually updated as soon as changes are ready. PDF manualsare updated only when new editions are published, on an infrequent basis.

This information assumes that function level 502 is activated in your Db2subsystem, and that your applications run with the equivalent V12R1M502application compatibility value.

Overview of Db2 12 new function availabilityThe availability of new function depends on the type of enhancement, theactivated function level, and the application compatibility levels ofapplications. In the initial Db2 12 release, most new capabilities areenabled only after the activation of function level 500 or higher.

Virtual storage enhancementsVirtual storage enhancements become available at the activation ofthe function level that introduces them or higher. Activation offunction level 100 introduces all virtual storage enhancements inthe initial Db2 12 release. That is, activation of function level 500introduces no virtual storage enhancements.

Subsystem parametersNew subsystem parameter settings are in effect only when thefunction level that introduced them or a higher function level isactivated. Most subsystem parameter changes in the initial Db2 12release take effect in function level 500. For a list of these changes,see Subsystem parameter changes in Db2 12 (Db2 for z/OS What'sNew?).

Optimization enhancementsOptimization enhancements become available after the activationof the function level that introduces them or higher, and fullprepare of the SQL statements. When a full prepare occursdepends on the statement type:v For static SQL statements, after bind or rebind of the packagev For non-stabilized dynamic SQL statements, immediately, unless

the statement is in the dynamic statement cachev For stabilized dynamic SQL statements, after invalidation, free,

or changed application compatibility level

Activation of function level 100 introduces all optimizationenhancements in the initial Db2 12 release. That is, function level500 introduces no optimization enhancements.

Copyright IBM Corp. 1983, 2017 xv

http://www.ibm.com/support/knowledgecenter/SSEPEK/db2z_prodhome.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK/db2z_prodhome.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/wnew/src/tpc/db2z_12_subsysparmchanges.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/wnew/src/tpc/db2z_12_subsysparmchanges.html

SQL capabilitiesNew SQL capabilities become available after the activation of thefunction level that introduces them or higher, for applications thatrun at the equivalent application compatibility level or higher. NewSQL capabilities in the initial Db2 12 release become available infunction level 500 for applications that run at the equivalentapplication compatibility level or higher. You can continue to runSQL statements compatibly with lower function levels, or previousDb2 releases, including Db2 11 and DB2 10. For details, seeApplication compatibility levels in Db2 (Db2 Applicationprogramming and SQL)

Who should read this informationThis information is intended for system administrators, database administrators,system operators, and application programmers of Db2 online and stand-aloneutilities.

Recommendation: Familiarize yourself with Db2 for z/OS prior to using this book.

Db2 Utilities Suite for z/OS

Important: In this Db2 12, Db2 Utilities Suite for z/OS is available as an optionalproduct. You must separately order and purchase a license to such utilities, anddiscussion of those utility functions in this publication is not intended to otherwiseimply that you have a license to them.

Db2 12 utilities can use the DFSORT program regardless of whether you purchaseda license for DFSORT on your system. For more information, see the followinginformational APARs:v II14047v II14213v II13495

Db2 utilities can use IBM Db2 Sort for z/OS (5655-W42) as an alternative toDFSORT for utility SORT and MERGE functions. Use of Db2 Sort for z/OSrequires the purchase of a Db2 Sort for z/OS license. For more information aboutDb2 Sort for z/OS, see Db2 Sort for z/OS.Related concepts:Db2 utilities packaging

Terminology and citationsWhen referring to a Db2 product other than Db2 for z/OS, this information usesthe product's full name to avoid ambiguity.

About the Db2 brand change: IBM is rebranding DB2 to Db2. As such, there willbe changes to all the Db2 offerings. For example, DB2 for z/OS is now referredto as Db2 for z/OS, beginning with Db2 11. While IBM implements the changeacross the Db2 family of products, you might see references to the original nameDB2 for z/OS or DB2 in different IBM web pages and documents. DB2 forz/OS and Db2 for z/OS refer to the same product, when the PID, EntitlementEntity, version, modification, and release information match. For more information,see Revised naming for IBM Db2 family products.

xvi Utility Guide and Reference

||||||||

http://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/apsg/src/tpc/db2z_applicationcompatibility.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/apsg/src/tpc/db2z_applicationcompatibility.htmlhttp://www.ibm.com/software/data/db2imstools/db2tools/db2-sort/http://ibm.biz/Rebrand4Db2

The following terms are used as indicated:

Db2 Represents either the Db2 licensed program or a particular Db2 subsystem.

Tivoli OMEGAMON XE for Db2 Performance Expert on z/OSRefers to any of the following products:v IBM Tivoli OMEGAMON XE for Db2 Performance Expert on z/OSv IBM Db2 Performance Monitor on z/OSv IBM Db2 Performance Expert for Multiplatforms and Workgroupsv IBM Db2 Buffer Pool Analyzer for z/OS

C, C++, and C languageRepresent the C or C++ programming language.

CICS Represents CICS Transaction Server for z/OS.

IMS Represents the IMS Database Manager or IMS Transaction Manager.

MVS Represents the MVS element of the z/OS operating system, which isequivalent to the Base Control Program (BCP) component of the z/OSoperating system.

RACF

Represents the functions that are provided by the RACF component of thez/OS Security Server.

Accessibility features for Db2 12 for z/OSAccessibility features help a user who has a physical disability, such as restrictedmobility or limited vision, to use information technology products successfully.

Accessibility features

The following list includes the major accessibility features in z/OS products,including Db2 12 for z/OS. These features support:v Keyboard-only operation.v Interfaces that are commonly used by screen readers and screen magnifiers.v Customization of display attributes such as color, contrast, and font size

Tip: The IBM Knowledge Center (which includes information for Db2 for z/OS)and its related publications are accessibility-enabled for the IBM Home PageReader. You can operate all features using the keyboard instead of the mouse.

Keyboard navigation

For information about navigating the Db2 for z/OS ISPF panels using TSO/E orISPF, refer to the z/OS TSO/E Primer, the z/OS TSO/E User's Guide, and the z/OSISPF User's Guide. These guides describe how to navigate each interface, includingthe use of keyboard shortcuts or function keys (PF keys). Each guide includes thedefault settings for the PF keys and explains how to modify their functions.

Related accessibility information

IBM and accessibility

See the IBM Accessibility Center at http://www.ibm.com/able for more informationabout the commitment that IBM has to accessibility.

About this information xvii

http://www.ibm.com/able

How to send your commentsYour feedback helps IBM to provide quality information. Please send anycomments that you have about this book or other Db2 for z/OS documentation.

Send your comments by email to [email protected] and include the name ofthe product, the version number of the product, and the number of the book. Ifyou are commenting on specific text, please list the location of the text (forexample, a chapter and section title or a help topic title).

Naming conventions used in this informationWhen you use Db2 commands and utilities, be aware of the applicable namingconventions

When you use a parameter for an object that is created by SQL statements (forexample, tables, table spaces, and indexes), identify the object by following theSQL syntactical naming conventions.

In this information, characters are classified as letters, digits, or special characters.v A letter is any one of the uppercase characters A through Z (including the three

characters that are reserved in the United States as alphabetic extenders fornational languages, #, @, and $.).

v A digit is any one of the characters 0 through 9.v A special character is any character other than a letter or a digit.

authorization-idA short identifier of one to eight letters, digits, or the underscore that identifiesa set of privileges. An authorization ID must begin with a letter.

connection-nameAn identifier of one to eight characters that identifies an address spaceconnection to Db2. A connection identifier is one of the following values:v TSO (for DSN processes that run in TSO foreground).v BATCH (for DSN processes that run in TSO batch).v DB2CALL (for the call attachment facility (CAF)).v The system identification name (for IMS and CICS processes).

Related information:

Managing connection requests from local applications (Managing Security)

correlation-idAn identifier of 1 to 12 characters that identifies a process within an addressspace connection. A correlation ID must begin with a letter.

A correlation ID can be one of the following values:v The TSO logon identifier (for DSN processes that run in TSO foreground

and for CAF processes).v The job name (for DSN processes that run in TSO batch).v The PST#.PSBNAME (for IMS processes).v The entry identifier.thread_number.transaction_identifier (for CICS

processes).

xviii Utility Guide and Reference

mailto:[email protected]://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/seca/src/tpc/db2z_localrequest.html

cursor-nameAn identifier that designates a result set. Cursor names that are specified withthe EXEC SQL and LOAD utilities cannot be longer than eight characters.

database-nameA short identifier that identifies a database. The identifier must start with aletter and must not include special characters.

data-set-nameAn identifier of 1 to 44 characters that identifies a data set.

dbrm-member-nameAn identifier of one to eight letters or digits that identifies a member of apartitioned data set.

A DBRM member name should not begin with DSN because of a potentialconflict with Db2-provided DBRM member names. If you specify a DBRMmember name that begins with DSN, Db2 issues a warning message.

dbrm-pds-nameAn identifier of 1 to 44 characters that identifies a partitioned data set.

ddnameAn identifier of one to eight characters that identifies the name of a DDstatement.

hexadecimal-constantA sequence of digits or any of the letters from A to F (uppercase or lowercase).

hexadecimal-stringAn X followed by a sequence of characters that begins and ends with thestring delimiter, an apostrophe. The characters between the string delimitersmust be a hexadecimal number.

index-nameA qualified or unqualified name that identifies an index.

A qualified index name is a schema name followed by a period and anidentifier.

An unqualified index name is an identifier with an implicit schema namequalifier. The implicit schema is determined by the SQL rules for unqualifiedtypes, functions, procedures, global variables, and specific names.

If the index name contains a blank character, the name must be enclosed inquotation marks when specified in a utility control statement.


Unqualified type, function, procedure, global variable, and specific names(Db2 SQL)

location-nameA location identifier of 1 to 16 letters (but excluding the alphabetic extenders),digits, or the underscore that identifies an instance of a database managementsystem. A location name must begin with a letter.

lunameAn SQL short identifier of one to eight characters that identifies a logical unitname. A LU name must begin with a letter.

member-nameAn identifier of one to eight letters (including the three alphabetic extenders)or digits that identifies a member of a partitioned data set.

About this information xix

http://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/sqlref/src/tpc/db2z_unqualifiedroutinenames.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/sqlref/src/tpc/db2z_unqualifiedroutinenames.html

A member name should not begin with DSN because of a potential conflictwith Db2-provided member names. If you specify a member name that beginswith DSN, Db2 issues a warning message.

qualifier-nameAn SQL short identifier of one to eight letters, digits, or the underscore thatidentifies the implicit qualifier for unqualified table names, views, indexes, andaliases.

stringA sequence of characters that begins and ends with an apostrophe.

subsystem-nameAn identifier that specifies the Db2 subsystem as it is known to the operatingsystem.

table-nameA qualified or unqualified name that designates a table.

A fully qualified table name is a three-part name. The first part is a locationname that designates the DBMS at which the table is stored. The second part isa schema name. The third part is an SQL identifier. A period must separateeach of the parts.

A two-part table name is implicitly qualified by the location name of thecurrent server. The first part is a schema name. The second part is an SQLidentifier. A period must separate the two parts.

A one-part or unqualified table name is an SQL identifier with two implicitqualifiers. The first implicit qualifier is the location name of the current server.The second is a schema name, which is determined by the SQL rules forunqualified types, functions, procedures, global variables, and specific names.

If the table name contains a blank, the name must be enclosed in quotationmarks when specified in a utility control statement.


Unqualified type, function, procedure, global variable, and specific names(Db2 SQL)

table-space-nameA short identifier that identifies a table space of an identified database. Theidentifier must start with a letter and must not include special characters. If adatabase is not identified, a table space name specifies a table space ofdatabase DSNDB04.

utility-idAn identifier of 1 to 16 characters that uniquely identifies a utility processwithin Db2. A utility ID must begin with a letter. The remaining characters canbe uppercase and lowercase letters, numbers 0 through 9, and the followingcharacters: #, $, ., , !, , and @.

Related concepts:

Naming conventions (Db2 SQL)

SQL identifiers (Db2 SQL)

How to read syntax diagramsCertain conventions apply to the syntax diagrams that are used in IBMdocumentation.

xx Utility Guide and Reference

http://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/sqlref/src/tpc/db2z_unqualifiedroutinenames.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/sqlref/src/tpc/db2z_unqualifiedroutinenames.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/sqlref/src/tpc/db2z_namingconventions.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/sqlref/src/tpc/db2z_sqlidentifiers.html

Apply the following rules when reading the syntax diagrams that are used in Db2for z/OS documentation:v Read the syntax diagrams from left to right, from top to bottom, following the

path of the line.The symbol indicates the beginning of a statement.The symbol indicates that the statement syntax is continued on the nextline.The symbol indicates that a statement is continued from the previous line.The symbol indicates the end of a statement.

v Required items appear on the horizontal line (the main path).

required_item

v Optional items appear below the main path.

required_itemoptional_item

If an optional item appears above the main path, that item has no effect on theexecution of the statement and is used only for readability.

optional_item

required_item

v If you can choose from two or more items, they appear vertically, in a stack.If you must choose one of the items, one item of the stack appears on the mainpath.

required_item required_choice1required_choice2

If choosing one of the items is optional, the entire stack appears below the mainpath.

required_itemoptional_choice1optional_choice2

If one of the items is the default, it appears above the main path and theremaining choices are shown below.

required_itemdefault_choice

optional_choiceoptional_choice

v An arrow returning to the left, above the main line, indicates an item that can berepeated.

required_item repeatable_item

About this information xxi

If the repeat arrow contains a comma, you must separate repeated items with acomma.

required_item

,

repeatable_item

A repeat arrow above a stack indicates that you can repeat the items in thestack.

v Sometimes a diagram must be split into fragments. The syntax fragment isshown separately from the main syntax diagram, but the contents of thefragment should be read as if they are on the main path of the diagram.

required_item fragment-name

fragment-name:

required_itemoptional_name

v With the exception of XPath keywords, keywords appear in uppercase (forexample, FROM). Keywords must be spelled exactly as shown. XPath keywordsare defined as lowercase names, and must be spelled exactly as shown. Variablesappear in all lowercase letters (for example, column-name). They representuser-supplied names or values.

v If punctuation marks, parentheses, arithmetic operators, or other such symbolsare shown, you must enter them as part of the syntax.

Related concepts:

Commands in Db2 (Db2 Commands)Db2 online utilitiesDb2 stand-alone utilities

xxii Utility Guide and Reference

http://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/comref/src/tpc/db2z_aboutcommands.html

Part 1. Basic information about the Db2 utilities

Use IBM Db2 utilities to help maintain data in your Db2 for z/OS databases.

Syntax diagrams for utilities

For information about the conventions for syntax diagrams in IBM documentation,see How to read syntax diagrams ().

Online and stand-alone utilities

Most of the basic utilities, such as LOAD and COPY, are online utilities; they requireDb2 to be up and running. Db2 online utilities run as standard batch jobs or storedprocedures. They do not run under control of the terminal monitor program(TMP); they have their own attachment mechanism and they invoke Db2 controlfacility services directly. For more information about online utilities, see Db2 onlineutilities and Invoking Db2 online utilities.

The other type of utilities is stand-alone utilities. These utilities run independently ofDb2. They work directly on the data sets. You can use stand-alone utilities to dotasks such as format logs, modify the bootstrap data set (BSDS), and copy andprint data sets. The stand-alone utilities run as batch jobs. The only way to runthese utilities is to use JCL. For more information about stand-alone utilities, seeDb2 stand-alone utilities and Invoking stand-alone utilities.

Exception: Some Db2 for z/OS users use the term online utilities to meansomething other than what IBM means when it uses this term in thedocumentation. Some users use this term to refer to utilities that leave the dataavailable while they are running. For example, when you use the REORGTABLESPACE utility to reorganize data, you can specify the level of access thatother applications and processes have to that same data. If you specify theSHRLEVEL CHANGE option, the data can be changed while the utility runs.Therefore, REORG TABLESPACE SHRLEVEL CHANGE is considered by someusers to be an "online utility" because the data is never taken offline. However,IBM does not use the term this way.Related concepts:

Db2 utilities (Introduction to Db2 for z/OS)

Copyright IBM Corp. 1983, 2017 1

http://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/home/src/cmn/db2z_cmn_how2readsyntax.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/intro/src/tpc/db2z_controlwithutilities.html

2 Utility Guide and Reference

Chapter 1. Db2 utilities packaging

Several utilities are included with Db2 at no extra charge. Other utilities areavailable as a separate product.

The following utilities are core utilities, which are included (at no extra charge)with Db2 12 for z/OS:v CATMAINTv DIAGNOSEv LISTDEFv OPTIONSv QUIESCEv REPAIRv REPORTv TEMPLATEv All DSN stand-alone utilities

All other utilities are available as a separate product called the Db2 Utilities Suitefor z/OS (FMID HDBCC1K).v BACKUP SYSTEMv CHECK DATAv CHECK INDEXv CHECK LOBv COPYv COPYTOCOPYv EXEC SQLv LOADv MERGECOPYv MODIFY RECOVERYv MODIFY STATISTICSv REBUILD INDEXv RECOVERv REORG INDEXv REORG TABLESPACEv RESTORE SYSTEMv RUNSTATSv STOSPACEv UNLOAD

All Db2 utilities operate on catalog, directory, and sample objects, withoutrequiring purchase of the Db2 Utilities Suite for z/OS.

SMP/E jobs for the Db2 Utilities Suite for z/OS productTo load the Db2 utility products, use System Modification Program Extended(SMP/E). SMP/E processes the installation cartridges and creates Db2 distributiontarget libraries.

The Db2 Utilities Suite for z/OS product provides several jobs that invoke SMP/E:

SMP/E RECEIVE job, DSNRECVKJob DSNRECVK loads the Db2 Utilities Suite for z/OS Db2 12 procedures


||

|

||

and samples into temporary data sets (SMPTLIBs). If these jobs fail orabnormally terminate, correct the problem and rerun the jobs.

SMP/E APPLY job, DSNAPPLKJob DSNAPPLK copies and link-edits the procedures and samples for theDb2 Utilities Suite for z/OS Db2 12 into the Db2 Utilities Suite targetlibraries.

SMP/E ACCEPT job, DSNACCPKJob DSNACCPK copies the procedures and samples for the Db2 UtilitiesSuite Db2 12 into the Db2 Utilities Suite distributed libraries.

The prologue for each job contains directions for tailoring the job for your site.Follow the instructions carefully to ensure that your SMP/E process for Db2Utilities Suite for z/OS works correctly.

For detailed instructions for installing the Db2 Utilities Suite for z/OS product, seethe Db2 Utilities Suite for z/OS Program Directory.Related concepts:

System installation and maintenance using SMP/E (z/OS basic skills)Related information:

Db2 for z/OS Program Directories

Operation of Db2 utilities in a mixed-release data sharing environmentThe utilities batch module, DSNUTILB, is split into multiple parts: arelease-independent module called DSNUTILB, a release-dependent moduleDSNUT121, and, for Db2 11, utility-dependent load modules.

To operate in a mixed-release data sharing environment, you must have thefollowing modules available to the utility jobs that operate across the data sharinggroup:v The release-dependent modules from both releasesv All applicable utility-dependent modules

Important: In data sharing release coexistence, you must restart a utility on amember on the same Db2 release as the member where the utility job wasoriginally submitted. The same utility ID (UID) must be used to restart the utility.That UID is unique within a data sharing group. However, if Db2 fails, you mustrestart Db2 on either the same or another z/OS system before you restart theutility.Related information:

Enabling the Db2 Utilities Suite for z/OS productBefore you can run any Db2 Utilities Suite for z/OS applications or functions inDb2 12, you must enable and register Db2 Utilities Suite for z/OS in ProductRegistration Services component of z/OS.

About this task

The required product enablement policy is contained in the DSNUPREG memberin thehlq.SDSNBASU data set.


||

||||

|||

|||

||

|||

||||||

|

|||

|

||

http://www-01.ibm.com/support/knowledgecenter/zosbasics/com.ibm.zos.zsysprog/zsysprogc_whatissmpe.htmhttp://www-01.ibm.com/support/docview.wss?uid=swg27047206#db2-pd

For more information about completing this task, see Enable/Register Db2Utilities Suite for z/OS in Db2 Utilities Suite for z/OS Program Directory.

Procedure

To enable Db2 Utilities Suite for z/OS, take the following actions:1. Update IFAPRDxx.2. issue the SET PROD=(xx) operator command. Db2 Utilities Suite for z/OS is

enabled in your environment.Related reference:

IBM product enablement ( MVS Product Management)

Registering a product (MVS Programming: Product Registration)Related information:

IFAPRDxx (product enablement policy) (MVS Initialization and TuningReference)

Db2 for z/OS Program Directories

Chapter 1. Db2 utilities packaging 5

||

|

|

|

||

|

|

|

|

||

|

http://www-01.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.ieaq200/greg.htmhttp://www-01.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.ieaq200/greg.htmhttp://www-01.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.ieae200/ifaprd.htmhttp://www-01.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.ieae200/ifaprd.htmhttp://www-01.ibm.com/support/docview.wss?uid=swg27047206#db2-pd

Chapter 2. Privileges and authorization IDs for Db2 utilities

A utility job can be issued by an individual user, by a program that runs in batchmode, or by an IMS or CICS transaction. The term process describes any of theseinitiators.

Db2 processes are represented by a set of identifiers (IDs), which are calledauthorization IDs. What the process can do with Db2 is determined by theprivileges and authorities that are held by its identifiers.

For Db2 online utilities, the process can be represented by the following identifiers:v A primary authorization ID.v Possibly one or more secondary IDs.v A role, if the process is running in a trusted connection with an associated role.

For example, a process can have a secondary authorization ID that is a ResourceAccess Control Facility (RACF) group ID. Suppose that RACF group holds theLOAD privilege on a particular database. Any member of the group can run theLOAD utility to load table spaces in the database.

The privileges that are required for each utility are listed in the documentation forthe utility.

Required authorizations for invoking utilities on tables that havemultilevel security with row-level granularity

If you use RACF access control with multilevel security, you need additionalauthorizations to run the following utilities on tables that have multilevel securitywith row-level granularity:v LOADv UNLOADv REORG TABLESPACE

The authorization requirements are listed in the documentation for each of theseutilities.

All other utilities, including all stand-alone utilities, ignore the row-levelgranularity. They check only for authorization to operate on the table space; theydo not check row-level authorization.

Db2 online utilities in a trusted connection

The Db2 online utilities can run in a trusted connection if both of the followingconditions are true:v A matching trusted context is defined where the primary authorization ID

matches the trusted context SYSTEM AUTHID.v The job name matches the JOBNAME attribute that is defined for the identified

trusted context.

The primary authorization ID can acquire a special set of privileges in a trustedcontext, by roles.


Related concepts:

Authorization IDs (Managing Security)

Privileges and authorities (Managing Security)

Multilevel security (Managing Security)Related reference:

Processing of sign-on requests (Managing Security)Related information:

Managing access through trusted contexts (Managing Security)


http://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/seca/src/tpc/db2z_authorizationid.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/seca/src/tpc/db2z_privilegeauthority.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/seca/src/tpc/db2z_mls.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/seca/src/tpc/db2z_signonreqprocess.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/seca/src/tpc/db2z_usetrustedconnection.html

Chapter 3. Utilities that can be run on declared temporaryobjects

The REPAIR utility with the DBD option and the STOSPACE utility can be run ondeclared temporary objects.

You can use REPAIR DBD on declared temporary tables, which must be created ina database that is defined with the AS TEMP clause.

You can use STOSPACE on storage groups that have objects within temporarydatabases.

No other Db2 utilities can be used on a declared temporary table, its indexes, or itstable spaces.Related concepts:

Creation of temporary tables (Introduction to Db2 for z/OS)Related tasks:Repairing DBDs


http://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/intro/src/tpc/db2z_creationoftemporarytables.html

Chapter 4. Effect of utilities on objects that have the DEFINENO attribute

You can run certain online utilities on table spaces or index spaces that weredefined with the DEFINE NO attribute. When you specify this attribute, the tablespace or index space is defined; however, Db2 does not allocate the associated datasets until a row is inserted or loaded into a table in that table space.

You can populate table spaces whose data sets are not yet defined by using theLOAD utility with either the RESUME option or the REPLACE option. UsingLOAD to populate these table spaces results in the following actions:1. Db2 allocates the data sets.2. Db2 updates the SPACE column in the catalog table to indicate that data sets

exist.3. Db2 loads the specified table space.

For a partitioned table space, all partitions are allocated even if the LOAD utility isloading only one partition. Avoid attempting to populate a partitioned table spacewith concurrent LOAD PART jobs until after one of the jobs causes all the data setsto be created.

Online utilities that encounter an undefined target object might issue informationalmessage DSNU185I, but processing continues. The following online utilities issuethis message when a table space or index space with the DEFINE NO attribute isencountered. The object is not processed.v CHECK DATAv CHECK INDEXv COPYv MERGECOPYv MODIFY RECOVERYv QUIESCEv REBUILD INDEXv RECOVERv REORG INDEXv REORG TABLESPACE1v REPAIR, but not REPAIR DBDv RUNSTATS TABLESPACE INDEX(ALL) 2, 3v RUNSTATS INDEX 2, 3v UNLOAD

Note:

1. REORG TABLESPACE processes the object if ROWFORMAT RRF is explicitlyspecified and the specified target is an entire undefined table space in basic rowformat. In this case, Db2 updates the row format definition in the catalog anddirectory. No data sets are defined for the table space.

2. RUNSTATS recognizes DEFINE NO objects and updates the access pathstatistics in the Db2 catalog to reflect the empty objects.

3. The SYSIBM.SYSSTATFEEDBACK table might contain rows that recommendcollection of statistics for DEFINE NO objects, or empty table space partitions.However, statistics cannot be collected for such objects until after data isinserted and the underlying data sets are created.


You cannot use stand-alone utilities on objects whose data sets are not yet defined.Related tasks:

Deferring allocation of Db2-managed data sets (Db2 Administration Guide)Related information:

DSNU185I (Db2 Messages)


http://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/admin/src/tpc/db2z_deferdatasetallocation.htmlhttp://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/msgs/src/tpc/dsnu185i.html

Chapter 5. Effect of utilities on data that is encrypted throughbuilt-in functions

You can copy and recover encrypted data. You can also move encrypted databetween systems. Data remains encrypted throughout these processes.

However, running any of the following utilities on encrypted data might produceunexpected results:v CHECK DATAv LOADv REBUILD INDEXv REORG TABLESPACEv REPAIRv RUNSTATSv UNLOADv DSN1PRNTRelated concepts:

Encrypting your data through Db2 built-in functions (Managing Security)


http://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/seca/src/tpc/db2z_dataencryptthrubuiltin.html

Part 2. Db2 online utilities

Db2 online utilities run as standard batch jobs or stored procedures, and theyrequire Db2 to be running. They do not run under control of the terminal monitorprogram (TMP); they have their own attachment mechanism and they invoke Db2control facility services directly.


Chapter 6. Invoking Db2 online utilities

You can invoke Db2 online utilities by using any of a variety of methods.

Before you begin

Make sure that you are authorized to run the utility that you want to invoke. Youcan check the authorization that is required in the documentation for each utility.

If any of following situations apply, check for any additional authorizationrestrictions or requirements in Privileges and authorization IDs for Db2 utilities:v The target object is a table that has multilevel security with row-level

granularity.v You plan to run the utilities in a trusted context.

About this task

Some utilities can operate at the partition level. For those utilities, any reference toa partition number denotes the physical partition number unless otherwisespecified. Similarly, any partition numbers that are included in the utility outputare the physical partition numbers.

Procedure

To run Db2 online utilities:1. Prepare the necessary data sets. For more information about allocating data sets

for utilities and a l

utility guide and reference - ibm · utility guide and reference sc27-8860-02 ibm. db2 12 for z/os...

Documents