DBUTLTY Reference Guide for z/OS Version 15.00
CA Datacom/DB
This Documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred to as the Documentation) is for your informational purposes only and is subject to change or withdrawal by CA at any time.
This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA. This Documentation is confidential and proprietary information of CA and may not be disclosed by you or used for any purpose other than as may be permitted in (i) a separate agreement between you and CA governing your use of the CA software to which the Documentation relates; or (ii) a separate confidentiality agreement between you and CA.
Notwithstanding the foregoing, if you are a licensed user of the software product(s) addressed in the Documentation, you may print or otherwise make available a reasonable number of copies of the Documentation for internal use by you and your employees in connection with that software, provided that all CA copyright notices and legends are affixed to each reproduced copy.
The right to print or otherwise make available copies of the Documentation is limited to the period during which the applicable license for such software remains in full force and effect. Should the license terminate for any reason, it is your responsibility to certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed.
TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION AS IS WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE.
The use of any software product referenced in the Documentation is governed by the applicable license agreement and such license agreement is not modified in any way by the terms of this notice.
The manufacturer of this Documentation is CA.
Provided with Restricted Rights. Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or their successors.
Copyright 2014 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.
Contact CA Technologies
Contact CA Support
For your convenience, CA Technologies provides one site where you can access the information that you need for your Home Office, Small Business, and Enterprise CA Technologies products. At http://ca.com/support, you can access the following resources:
Online and telephone contact information for technical assistance and customer services
Information about user communities and forums
Product and documentation downloads
CA Support policies and guidelines
Other helpful resources appropriate for your product
Providing Feedback About Product Documentation
If you have comments or questions about CA Technologies product documentation, you can send a message to [email protected].
To provide feedback about CA Technologies product documentation, complete our short customer survey which is available on the CA Support website at http://ca.com/docs.
http://www.ca.com/supportmailto:[email protected]://ca.com/docshttp://ca.com/docs
Documentation Changes
The following documentation updates have been made since the last release of this documentation:
updated SNAP console command (see page 267)
updated COMM SNAP DBUTLTY command (see page 268)
updated Memory Use Summary Information report (see page 246)
added PREINIT function (see page 561)
added a Type P CXX Report (see page 671)
updated Log Block Size (in INIT LXX) (see page 479)
updated How to Use (in INIT LXX) (see page 481)
updated Example 5 (TYPE=U Debugging Report) (see page 797)
updated How to Use (RXXFIX) (see page 832)
updated INIT Data Area (Format Data Area) (see page 462)
updated REPORT MEMORY=MVS (see page 721)
updated REPORT TYPE=DATASP (see page 780)
removed both CXXMAINT CONVERT functions
removed both of the CXXMAINT FORMAT functions
updated GAPFIX Detail Report to include the PLUS SLOT column supporting additional PLUS output bases
updated BACKUP and EXTRACT functions to remove the restriction prohibiting the use of SEQ=PHYSICAL when MULTUSE=YES is specified for DBUTLTY functions BACKUP and EXTRACT.
Contents 5
Contents
Chapter 1: Introduction 25
CA IPC and CA Ideal Utilities ....................................................................................................................................... 25
JCL Example Notation ................................................................................................................................................. 26
Sample Report Headers .............................................................................................................................................. 26
Reading Syntax Diagrams ........................................................................................................................................... 28
Statement Without Parameters .......................................................................................................................... 28
Statement with Required Parameters ................................................................................................................ 29
Delimiters Around Parameters ........................................................................................................................... 29
Choice of Required Parameters .......................................................................................................................... 29
Default Value for a Required Parameter ............................................................................................................. 30
Optional Parameter............................................................................................................................................. 30
Choice of Optional Parameters ........................................................................................................................... 30
Repeatable Variable Parameter .......................................................................................................................... 31
Separator with Repeatable Variable and Delimiter ............................................................................................ 31
Optional Repeatable Parameters ........................................................................................................................ 32
Default Value for a Parameter ............................................................................................................................ 32
Variables Representing Several Parameters ....................................................................................................... 32
Chapter 2: Using CA Datacom/DB Utility (DBUTLTY) 35
Overview .................................................................................................................................................................... 35
Multiple Commands ............................................................................................................................................ 35
Prerequisite Commands ...................................................................................................................................... 35
Syntax Check ....................................................................................................................................................... 36
Messages ............................................................................................................................................................. 36
JCL Requirements for z/OS .................................................................................................................................. 36
Requirement to Run APF-Authorized, z/OS ........................................................................................................ 37
Command Syntax ....................................................................................................................................................... 37
Command ............................................................................................................................................................ 37
Keyword Parameters ........................................................................................................................................... 37
Line Length .......................................................................................................................................................... 37
End of Command ................................................................................................................................................. 38
Comments ........................................................................................................................................................... 38
Console Commands .................................................................................................................................................... 39
DBUTLTY STATUS ................................................................................................................................................. 39
DBUTLTY Dynamic Extend Considerations ................................................................................................................. 41
Impact of Table Partitioning on DBUTLTY Functions .................................................................................................. 41
6 DBUTLTY Reference Guide for z/OS
Any Parent Table Name Restriction .................................................................................................................... 41
Area level DBUTLTY control ................................................................................................................................ 42
BACKUP Utility ..................................................................................................................................................... 42
EXTRACT Utility ................................................................................................................................................... 42
LOAD Utility ......................................................................................................................................................... 42
REORG Utility ...................................................................................................................................................... 44
Forward Recovery Utility ..................................................................................................................................... 44
Area Level DBUTLTY Control ...................................................................................................................................... 44
MULTUSE= Keyword ........................................................................................................................................... 44
Database ACCESS ................................................................................................................................................ 47
Area Level ACCESS ............................................................................................................................................... 49
COMM CLOSE Function ....................................................................................................................................... 50
Dynamic System Table ........................................................................................................................................ 50
Summary of Restrictions and Requirements....................................................................................................... 51
Utility Function Summary ........................................................................................................................................... 51
Simplify Considerations .............................................................................................................................................. 55
Functions Requiring Inactive MUF ...................................................................................................................... 55
Functions Needing the CXX ................................................................................................................................. 60
JCL Requirements for the CXX Data Set ..................................................................................................................... 68
Chapter 3: ACCESS (Restricting Opens or Maintenance) 69
Length of Time to Process .......................................................................................................................................... 69
Buffer Writes .............................................................................................................................................................. 70
Area Level DBUTLTY Control ...................................................................................................................................... 70
How to Use the Console Command ........................................................................................................................... 71
How to Use the DBUTLTY Command .......................................................................................................................... 72
Example JCL ................................................................................................................................................................ 77
Sample Report ............................................................................................................................................................ 77
Chapter 4: ACCT (Accounting Facility) 79
Activating the Accounting Facility .............................................................................................................................. 79
ACCT CATALOG (Catalog Accounting Database) ........................................................................................................ 80
When to Use ....................................................................................................................................................... 80
How to Use .......................................................................................................................................................... 81
Example JCL ......................................................................................................................................................... 82
Sample Report ..................................................................................................................................................... 82
ACCT CLOSE (Close Accounting Tables) ...................................................................................................................... 85
When to Use ....................................................................................................................................................... 85
How to Use the Console Command .................................................................................................................... 86
How to Use the DBUTLTY Command .................................................................................................................. 86
Example JCL ......................................................................................................................................................... 87
Contents 7
Sample Report ..................................................................................................................................................... 87
ACCT EDIT (Edit Accounting Database Definitions) .................................................................................................... 88
When to Use ....................................................................................................................................................... 88
How to Use .......................................................................................................................................................... 89
Example JCL ......................................................................................................................................................... 91
Sample Report ..................................................................................................................................................... 91
ACCT OPEN (Open Accounting Tables) ....................................................................................................................... 93
When to Use ....................................................................................................................................................... 94
How to Use the Console Command .................................................................................................................... 94
How to Use the DBUTLTY Command .................................................................................................................. 95
Example JCL ......................................................................................................................................................... 96
Sample Report ..................................................................................................................................................... 96
ACCT SPILL (Force Accounting Data Recording) ......................................................................................................... 97
When to Use ....................................................................................................................................................... 97
How to Use the Console Command .................................................................................................................... 97
How to Use the DBUTLTY Command .................................................................................................................. 98
Example JCL ......................................................................................................................................................... 99
Sample Report ..................................................................................................................................................... 99
Chapter 5: AUTOCOLL (Collect and Manage Snapshots) 101
Create a Snapshot .................................................................................................................................................... 101
How to Use ........................................................................................................................................................ 101
Example JCL ....................................................................................................................................................... 103
Sample Report ................................................................................................................................................... 103
Process a Snapshot Rowset into a Delta Rowset ..................................................................................................... 104
When to Use ..................................................................................................................................................... 104
How to Use ........................................................................................................................................................ 105
Example JCL ....................................................................................................................................................... 106
Sample Report ................................................................................................................................................... 106
User Created SUMMARY Delta Rowset .................................................................................................................... 107
When to Use ..................................................................................................................................................... 108
How to Use ........................................................................................................................................................ 108
Example JCL ....................................................................................................................................................... 111
Sample Report ................................................................................................................................................... 111
User Created BASELINE Delta Rowset ...................................................................................................................... 112
When to Use ..................................................................................................................................................... 113
How to Use ........................................................................................................................................................ 113
Example JCL ....................................................................................................................................................... 116
Sample Report ................................................................................................................................................... 116
User Created AVGPERF Delta Rowset ...................................................................................................................... 117
When to Use ..................................................................................................................................................... 118
8 DBUTLTY Reference Guide for z/OS
How to Use ........................................................................................................................................................ 118
Example JCL ....................................................................................................................................................... 121
Sample Report ................................................................................................................................................... 121
Create DSV Output Datasets .................................................................................................................................... 122
When to Use ..................................................................................................................................................... 123
How to Use ........................................................................................................................................................ 123
Example JCL ....................................................................................................................................................... 127
Sample Report ................................................................................................................................................... 128
Sample Report ................................................................................................................................................... 128
Reporting Snapshot Rowsets ................................................................................................................................... 129
When to Use ..................................................................................................................................................... 129
How to Use ........................................................................................................................................................ 129
Example JCL ....................................................................................................................................................... 131
Sample Report ................................................................................................................................................... 131
Reporting Delta Rowsets .......................................................................................................................................... 132
When to Use ..................................................................................................................................................... 133
How to Use ........................................................................................................................................................ 133
Example JCL ....................................................................................................................................................... 136
Sample Report ................................................................................................................................................... 136
Deleting Snapshot Rowsets ...................................................................................................................................... 137
When to Use ..................................................................................................................................................... 137
How to Use ........................................................................................................................................................ 138
Example JCL ....................................................................................................................................................... 140
Sample Report ................................................................................................................................................... 140
Deleting Delta Rowsets ............................................................................................................................................ 142
When to Use ..................................................................................................................................................... 142
How to Use ........................................................................................................................................................ 142
Example JCL ....................................................................................................................................................... 145
Sample Report ................................................................................................................................................... 145
Chapter 6: AUTOINFO (Collect Environmental MUF Information) 149
Overview .................................................................................................................................................................. 149
Using AUTOINFO in DBUTLTY ............................................................................................................................ 149
When to Use ..................................................................................................................................................... 150
How to Use ........................................................................................................................................................ 150
Example JCL ....................................................................................................................................................... 152
Sample Reports ................................................................................................................................................. 152
Chapter 7: AUTOSTAT (Report on MUF Information) 161
When to Use AUTOSTAT .......................................................................................................................................... 161
How to Use AUTOSTAT ............................................................................................................................................. 162
Contents 9
Console Commands .................................................................................................................................................. 164
MODIFY Command Format ............................................................................................................................... 165
Example JCL .............................................................................................................................................................. 167
Sample Report .......................................................................................................................................................... 168
Chapter 8: BACKUP (Create Backups) 169
BACKUP CXX (Back Up Directory) ............................................................................................................................. 169
When to Use ..................................................................................................................................................... 169
How to Use ........................................................................................................................................................ 170
Example JCL ....................................................................................................................................................... 172
Sample Report ................................................................................................................................................... 172
Back Up Data Area .................................................................................................................................................... 174
When to Use ..................................................................................................................................................... 174
How to Use ........................................................................................................................................................ 179
Example JCL - Native Key Sequence .................................................................................................................. 188
Sample Report ................................................................................................................................................... 188
Example JCL - Physical Sequence ..................................................................................................................... 190
Sample Report ................................................................................................................................................... 190
Chapter 9: COMM (Communicate with MUF) 193
Overview .................................................................................................................................................................. 193
Length of Time to Process a Request ................................................................................................................ 193
COMM ALTER (Modify Error Table) .......................................................................................................................... 194
When to Use ..................................................................................................................................................... 194
How to Use ........................................................................................................................................................ 194
Example JCL ....................................................................................................................................................... 201
Sample Report ................................................................................................................................................... 201
COMM CLOSE (Close Database or Area) .................................................................................................................. 202
When to Use ..................................................................................................................................................... 202
How to Use the Console Command .................................................................................................................. 202
How to Use the DBUTLTY Command ................................................................................................................ 203
Example JCL ....................................................................................................................................................... 206
Sample Report ................................................................................................................................................... 206
COMM CLRnnn (Reset Alternate Output Data Sets) ................................................................................................ 207
When to Use ..................................................................................................................................................... 207
How to Use the Console Command .................................................................................................................. 208
How to Use the DBUTLTY Command ................................................................................................................ 208
Example JCL ....................................................................................................................................................... 210
Sample Report ................................................................................................................................................... 210
COMM CLRPXX (Clear Statistics and Diagnostics Area (PXX)) .................................................................................. 211
When to Use ..................................................................................................................................................... 211
10 DBUTLTY Reference Guide for z/OS
How to Use the Console Command .................................................................................................................. 211
How to Use the DBUTLTY Command ................................................................................................................ 212
Example JCL ....................................................................................................................................................... 213
Sample Report ................................................................................................................................................... 213
COMM CONSOLE (Simulate Console Command) ..................................................................................................... 214
When to Use ..................................................................................................................................................... 214
How to Use the DBUTLTY Command ................................................................................................................ 214
Example JCL ....................................................................................................................................................... 216
COMM EOJ (End MUF Processing) ........................................................................................................................... 217
When to Use ..................................................................................................................................................... 217
How to Use the Console Command .................................................................................................................. 219
How to Use the DBUTLTY Command ................................................................................................................ 219
Example JCL ....................................................................................................................................................... 221
Sample Report ................................................................................................................................................... 221
MUF Startup Options Echoed............................................................................................................................ 222
Summary Reports Produced by the MUF During its EOJ Process ..................................................................... 222
COMM NEWRXX (Request New Recovery File) ........................................................................................................ 258
When to Use ..................................................................................................................................................... 258
How to Use the Console Command .................................................................................................................. 260
How to Use the DBUTLTY Command ................................................................................................................ 260
Example JCL ....................................................................................................................................................... 262
Sample Report ................................................................................................................................................... 262
COMM REQABORT (Abort a Request) ...................................................................................................................... 263
When to Use ..................................................................................................................................................... 263
How to Use the Console Command .................................................................................................................. 264
How to Use the DBUTLTY Command ................................................................................................................ 264
Example JCL ....................................................................................................................................................... 266
Sample Report ................................................................................................................................................... 266
COMM SNAP (Write Dump of Master List) .............................................................................................................. 267
When to Use ..................................................................................................................................................... 267
How to Use the Console Command .................................................................................................................. 267
How to Use the DBUTLTY Command ................................................................................................................ 268
Example JCL ....................................................................................................................................................... 270
Sample Report ................................................................................................................................................... 270
Master List Dump Example ............................................................................................................................... 271
COMM SNAPCSA (Print Dump of Common Storage Area) ....................................................................................... 271
When to Use ..................................................................................................................................................... 272
How to Use ........................................................................................................................................................ 272
Example JCL ....................................................................................................................................................... 273
Sample Report ................................................................................................................................................... 273
COMM SNAPSVC (Print Dump of the SVC) ............................................................................................................... 274
When to Use ..................................................................................................................................................... 274
Contents 11
How to Use ........................................................................................................................................................ 274
Example JCL ....................................................................................................................................................... 276
Sample Report ................................................................................................................................................... 276
Sample Report: COMM SNAPSVC .................................................................................................................... 276
COMM STATS (Write Current Statistics) .................................................................................................................. 276
When to Use ..................................................................................................................................................... 277
How to Use the Console Command .................................................................................................................. 277
How to Use the DBUTLTY Command ................................................................................................................ 278
Example JCL ....................................................................................................................................................... 280
Sample Report ................................................................................................................................................... 280
COMM STATUS (Print Status of MUF Jobs) .............................................................................................................. 281
When to Use ..................................................................................................................................................... 281
How to Use the Console Command .................................................................................................................. 282
How to Use the DBUTLTY Command ................................................................................................................ 282
Example JCL ....................................................................................................................................................... 284
Sample Report ................................................................................................................................................... 284
Sample COMM STATUS Online ......................................................................................................................... 300
Chapter 10: CONFIRM (Verify Constraint Integrity) 301
When to Use ............................................................................................................................................................. 301
Determining Constraints In Effect ..................................................................................................................... 302
How to Use ............................................................................................................................................................... 302
Example JCL .............................................................................................................................................................. 304
Sample Report .......................................................................................................................................................... 304
Chapter 11: CXXCLONE (Clone Environment) 307
When to Use ............................................................................................................................................................. 307
How to Use ............................................................................................................................................................... 309
Examples .................................................................................................................................................................. 313
Example JCL .............................................................................................................................................................. 314
Sample Report .......................................................................................................................................................... 314
Chapter 12: CXXMAINT (Maintain Directory) 319
CXXMAINT ALTER CBSUSE (Trial Delete a Key from CBS Use) .................................................................................. 320
When to Use ..................................................................................................................................................... 320
How to Use ........................................................................................................................................................ 320
Example JCL ....................................................................................................................................................... 322
Sample Report ................................................................................................................................................... 322
CXXMAINT ALTER CXXENQ (Controlling ENQ) .......................................................................................................... 323
When to Use ..................................................................................................................................................... 323
12 DBUTLTY Reference Guide for z/OS
How to Use ........................................................................................................................................................ 323
CXXMAINT ALTER DBCS (Activating DBCS Support) ................................................................................................. 325
When to Use ..................................................................................................................................................... 325
How to Use ........................................................................................................................................................ 325
Example JCL ....................................................................................................................................................... 326
Sample Report ................................................................................................................................................... 327
CXXMAINT ALTER DSN (Modify Data Set Name) ...................................................................................................... 327
When to Use ..................................................................................................................................................... 327
How to Use ........................................................................................................................................................ 328
Example JCL ....................................................................................................................................................... 330
Sample Report ................................................................................................................................................... 330
CXXMAINT ALTER DSOP (Modify Space Reclamation Option) ................................................................................. 331
When to Use ..................................................................................................................................................... 331
How to Use ........................................................................................................................................................ 331
Example JCL ....................................................................................................................................................... 333
Sample Report ................................................................................................................................................... 333
CXXMAINT ALTER LANGUAGE (Activating LANGUAGE Support) .............................................................................. 334
When to Use ..................................................................................................................................................... 334
How to Use ........................................................................................................................................................ 334
Example JCL ....................................................................................................................................................... 335
Sample Report ................................................................................................................................................... 335
CXXMAINT ALTER LINK (Disable CXX Name Edit) ..................................................................................................... 336
When to Use ..................................................................................................................................................... 336
How to Use ........................................................................................................................................................ 337
Example JCL ....................................................................................................................................................... 338
Sample Report ................................................................................................................................................... 339
CXXMAINT ALTER LOGGING (Start/Stop Logging by Table) ..................................................................................... 339
When to Use ..................................................................................................................................................... 339
How to Use ........................................................................................................................................................ 340
Example JCL ....................................................................................................................................................... 341
Sample Report ................................................................................................................................................... 342
CXXMAINT ALTER OPTION2= (Activating Other Features) ....................................................................................... 342
CXXMAINT ALTER OPTION2=datafs (DATAFS Support) ..................................................................................... 343
CXXMAINT ALTER OPTION2=datahu (High Used Mark) .................................................................................... 344
CXXMAINT ALTER OPTION2=areaev (Data Area Extent Validation) .................................................................. 347
CXXMAINT ALTER OPTION2=sumode (Single User Mode) ................................................................................ 348
CXXMAINT ALTER OPTION2=MATCHSID ........................................................................................................... 349
CXXMAINT ALTER SINGLE (Run in a Single User Environment) ................................................................................ 351
When to Use ..................................................................................................................................................... 351
How to Use ........................................................................................................................................................ 351
Example JCL ....................................................................................................................................................... 352
Sample Report ................................................................................................................................................... 352
Contents 13
CXXMAINT DDPROD (Update Directory) .................................................................................................................. 353
When to Use ..................................................................................................................................................... 353
How to Use ........................................................................................................................................................ 356
Example JCL ....................................................................................................................................................... 358
Sample Report ................................................................................................................................................... 358
CXXMAINT DELETE (Delete CXX Definitions) ............................................................................................................ 360
Deleting a Database .......................................................................................................................................... 360
Deleting Tables .................................................................................................................................................. 360
How to Use ........................................................................................................................................................ 361
Example JCL ....................................................................................................................................................... 362
Sample Report ................................................................................................................................................... 362
Example JCL ....................................................................................................................................................... 363
Sample Report ................................................................................................................................................... 363
CXXMAINT PURGE (Remove Database from Directory) ........................................................................................... 363
When to Use ..................................................................................................................................................... 364
How to Use ........................................................................................................................................................ 364
Example JCL ....................................................................................................................................................... 365
Sample Report ................................................................................................................................................... 365
Chapter 13: DBTEST (Execute Test/Analysis Programs) 367
DBTEST Command 1 (DBURSTR) .............................................................................................................................. 368
How to Use ........................................................................................................................................................ 368
DBTEST Command 2 (DBURTBL) ............................................................................................................................... 370
DBTEST Command 3 (DBUREND) ............................................................................................................................. 373
DBTEST Command 4 (DBTEST) ................................................................................................................................. 374
DBTEST DBTSTPR (Test Program) ............................................................................................................................. 375
When to Use ..................................................................................................................................................... 375
Control Statements ........................................................................................................................................... 376
Example DBTSTPR JCL ....................................................................................................................................... 378
Sample Report ................................................................................................................................................... 378
DBTEST DBIDCPR (Index Analysis Program) ............................................................................................................. 380
When to Use ..................................................................................................................................................... 380
How to Use ........................................................................................................................................................ 381
Example DBIDCPR JCL........................................................................................................................................ 381
Sample Report ................................................................................................................................................... 381
DBTEST DBIDPPR (Index Population Analysis Program) ........................................................................................... 382
When to Use ..................................................................................................................................................... 382
How to Use ........................................................................................................................................................ 383
Example DBIDPPR JCL ........................................................................................................................................ 383
Sample Report ................................................................................................................................................... 384
14 DBUTLTY Reference Guide for z/OS
Chapter 14: DEFAULT (Control Defaults) 387
When to Use ............................................................................................................................................................. 387
How to Use ............................................................................................................................................................... 387
Sample Report .......................................................................................................................................................... 388
Chapter 15: DEFRAG (Defragment Index) 391
Overview .................................................................................................................................................................. 391
Locking .............................................................................................................................................................. 392
Processing ......................................................................................................................................................... 392
Restrictions ....................................................................................................................................................... 393
Stopping DEFRAG .............................................................................................................................................. 393
Security Considerations .................................................................................................................................... 393
DEFRAG .................................................................................................................................................................... 393
When to Use ..................................................................................................................................................... 393
How to Use ........................................................................................................................................................ 393
Example JCL ....................................................................................................................................................... 396
Sample Report ................................................................................................................................................... 396
Chapter 16: EDIT (Validate Syntax) 399
When to Use ............................................................................................................................................................. 399
How to Use ............................................................................................................................................................... 399
Example JCL .............................................................................................................................................................. 400
Sample Report .......................................................................................................................................................... 400
Chapter 17: ENCRYPT (Facilitate Data Encryption) 403
When to Use ............................................................................................................................................................. 403
Opening and Backing Up Encrypted Tables .............................................................................................................. 404
DBUTLTY LOAD and REORG BASIC Encryption Functions ......................................................................................... 404
How to Use ............................................................................................................................................................... 405
SET_BASIC_KEY_n Option ................................................................................................................................. 405
Example JCL .............................................................................................................................................................. 406
Sample Report .......................................................................................................................................................... 406
Chapter 18: EXTBKUP (Extract from Backup File) 409
When to Use ............................................................................................................................................................. 410
How to Use ............................................................................................................................................................... 410
Example JCL .............................................................................................................................................................. 412
Sample Report .......................................................................................................................................................... 413
Contents 15
Chapter 19: EXTEND (Extend Data or Index Areas) 415
When to Use ............................................................................................................................................................. 415
How Space Is Allocated for an EXTEND ............................................................................................................. 416
Verifying the Extend .......................................................................................................................................... 417
Successful Execution Requirements and Controls ............................................................................................ 417
How to Use ............................................................................................................................................................... 418
Example JCL .............................................................................................................................................................. 420
Sample Report .......................................................................................................................................................... 420
Chapter 20: EXTRACT (Extract Data Table) 423
When to Use ............................................................................................................................................................. 423
Extracting in Native Key Sequence .................................................................................................................... 424
Extracting in Physical Key Sequence ................................................................................................................. 424
EXTRACT Output ................................................................................................................................................ 424
Master List Requirements ................................................................................................................................. 425
Successful Execution Requirements and Controls ............................................................................................ 426
How to Use ............................................................................................................................................................... 427
Parallel Extract ......................................................................................................................................................... 433
FIRSTKEY= and LASTKEY= Keywords in Parallel Extract ..................................................................................... 434
Restrictions ....................................................................................................................................................... 435
Example JCL .............................................................................................................................................................. 435
Sample Report .......................................................................................................................................................... 436
Chapter 21: FILEOUT (Define Output Data Sets) 437
When to Use ............................................................................................................................................................. 437
How to Use ............................................................................................................................................................... 437
Examples .................................................................................................................................................................. 439
Chapter 22: FLEXPOOL (Dynamic Buffers) 441
When to Use ............................................................................................................................................................. 441
How to Use the Console Command ......................................................................................................................... 442
How to Use the DBUTLTY Command ........................................................................................................................ 443
Example JCL .............................................................................................................................................................. 444
Sample Report .......................................................................................................................................................... 444
Chapter 23: FORCE (Force Keyword Values) 447
When to Use ............................................................................................................................................................. 447
How to Use ............................................................................................................................................................... 447
Sample Report .......................................................................................................................................................... 448
16 DBUTLTY Reference Guide for z/OS
Chapter 24: GAPFIX (Fix CDC Gaps) 449
When to Use ............................................................................................................................................................. 449
How to Use ............................................................................................................................................................... 451
GAPFIX Reports ........................................................................................................................................................ 453
Sample Report .......................................................................................................................................................... 453
GAPFIX Detail Report Sample ............................................................................................................................ 455
Chapter 25: INIT CXX/FXX/IXX/LXX/WXX/Data Area 457
Restrictions ............................................................................................................................................................... 457
Multivolume INITs ............................................................................................................................................. 457
INIT CXX (Format Directory) ..................................................................................................................................... 457
When to Use ..................................................................................................................................................... 458
How to Use ........................................................................................................................................................ 459
Example JCL ....................................................................................................................................................... 461
Sample Report ................................................................................................................................................... 461
INIT Data Area (Format Data Area) .......................................................................................................................... 462
When to Use ..................................................................................................................................................... 462
How to Use ........................................................................................................................................................ 465
Sample Report ................................................................................................................................................... 468
INIT IXX (Format Index Area) .................................................................................................................................... 469
When to Use ..................................................................................................................................................... 470
How to Use ........................................................................................................................................................ 473
Example JCL ....................................................................................................................................................... 477
Sample Report ................................................................................................................................................... 477
INIT LXX (Format Log Area) ...................................................................................................................................... 478
When to Use ..................................................................................................................................................... 479
How to Use ........................................................................................................................................................ 481
Example JCL for Single Log Area ........................................................................................................................ 483
Sample Report ................................................................................................................................................... 483
INIT FXX (Format Force Area) ................................................................................................................................... 484
When to Use ..................................................................................................................................................... 484
How to Use ........................................................................................................................................................ 485
How to Use ........................................................................................................................................................ 487
Example JCL for Force Area ............................................................................................................................... 488
Sample Report ................................................................................................................................................... 488
INIT WXX (Format RRM Log) .................................................................................................................................... 489
When to Use ..................................................................................................................................................... 489
How to Use ........................................................................................................................................................ 490
Contents 17
Chapter 26: LINK (Link to the CXX) 491
When to Use ............................................................................................................................................................. 492
How to Use ............................................................................................................................................................... 493
Example JCL .............................................................................................................................................................. 493
Sample Report .......................................................................................................................................................... 494
Chapter 27: LOAD (Build CXX or Data Area) 497
Overview .................................................................................................................................................................. 497
LOAD CXX (Build CXX) ............................................................................................................................................... 498
When to Use ..................................................................................................................................................... 498
How to Use ........................................................................................................................................................ 501
Example JCL ....................................................................................................................................................... 503
Sample Report ................................................................................................................................................... 504
LOAD (Build a Data Area) ......................................................................................................................................... 505
When to Use ..................................................................................................................................................... 505
Loading Multiple Tables Into a Data Area ......................................................................................................... 509
Adding a Table to a Data Area Not Using REPLACE ........................................................................................... 510
How to Use ........................................................................................................................................................ 513
Example JCL ....................................................................................................................................................... 530
Sample Report ................................................................................................................................................... 530
SORTDFLT=YES Report Section for LOAD .......................................................................................................... 537
Chapter 28: LOCK (Lock a Data Area) 541
When to Use ............................................................................................................................................................. 541
How to Use ............................................................................................................................................................... 541
Example JCL .............................................................................................................................................................. 542
Sample Report .......................................................................................................................................................... 543
Chapter 29: MASSADD (Add Records to Table) 545
When to Use ............................................................................................................................................................. 545
Use of Pipeline .................................................................................................................................................. 545
Log Check Points and Backout .......................................................................................................................... 545
Unique Keys ...................................................................................................................................................... 546
Integrity Constraints.......................................................................................................................................... 546
Use of the MUF ................................................................................................................................................. 546
Tables Using DBVVRPR ...................................................................................................................................... 546
Successful Execution Requirements and Controls ............................................................................................ 547
How to Use ............................................................................................................................................................... 548
Example JCL .............................................................................................................................................................. 551
18 DBUTLTY Reference Guide for z/OS
Sample Report .......................................................................................................................................................... 551
Chapter 30: OLREORG (Reorganize a Database Online) 553
Restrictions ............................................................................................................................................................... 554
Security Considerations .................................................................................................................................... 554
When to Use ............................................................................................................................................................. 554
Using Empty Blocks in OLREORG .............................................................................................................................. 555
How to Use ............................................................................................................................................................... 556
Example JCL .............................................................................................................................................................. 559
Sample Report .......................................................................................................................................................... 559
Chapter 31: PREINIT (Pre-Format Index and Data Areas) 561
When to Use PREINIT index area ............................................................................................................................. 564
Successful Execution Requirements and Controls ............................................................................................ 564
Multivolume INITs ............................................................................................................................................. 564
Controlling the Index Block Size ........................................................................................................................ 565
How to Use ............................................................................................................................................................... 565
Examples .................................................................................................................................................................. 569
Example JCL .............................................................................................................................................................. 570
Sample Report .......................................................................................................................................................... 570
When to Use PREINIT data area ............................................................................................................................... 571
Multivolume INITs ............................................................................................................................................. 571
Successful Execution Requirements and Controls ........................
Top Related