dbutlty reference guide for z/os - ca … datacom 14 0 public-enu...contact ca technologies contact...
TRANSCRIPT
-
DBUTLTY Reference Guide for z/OS Version 14.02
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 2015 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.
-
CA Technologies Product References
This document references the following CA products:
CA Datacom/DB
CA Datacom CICS Services
CA Datacom Datadictionary
CA Datacom DB2 Transparency
CA Datacom DL1 Transparency
CA Datacom Fast Restore
CA Datacom IMS/DC Services
CA Datacom Presspack
CA Datacom Server
CA Datacom SQL (SQL)
CA Datacom STAR
CA Datacom TOTAL Transparency
CA Datacom VSAM Transparency
CA Dataquery for CA Datacom (CA Dataquery)
CA Disk Backup and Restore (CA Disk)
CA Dynam/D Disk Management for z/VSE (CA Dynam/D for z/VSE)
CA Ideal for CA Datacom (CA Ideal)
CA IPC
CA Librarian
CA Roscoe Interactive Environment (CA Roscoe IE)
CA Scheduler Job Management (CA Scheduler JM)
CA SYSVIEW Performance Management (CA SYSVIEW)
CA Common Services for z/OS
CA Workload Automation Restart and Tracking for z/OS Schedulers (CA WA Restart and Tracking); formerly CA 11 Workload Automation Restart and Tracking
-
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
-
Contents 5
Contents
Chapter 1: Introduction 27
CA IPC and CA Ideal Utilities ....................................................................................................................................... 27
JCL Example Notation ................................................................................................................................................. 28
Sample Report Headers.............................................................................................................................................. 28
Reading Syntax Diagrams ........................................................................................................................................... 30
Statement Without Parameters .......................................................................................................................... 30
Statement with Required Parameters ................................................................................................................ 31
Delimiters Around Parameters ........................................................................................................................... 31
Choice of Required Parameters .......................................................................................................................... 31
Default Value for a Required Parameter ............................................................................................................. 32
Optional Parameter............................................................................................................................................. 32
Choice of Optional Parameters ........................................................................................................................... 32
Repeatable Variable Parameter .......................................................................................................................... 33
Separator with Repeatable Variable and Delimiter ............................................................................................ 33
Optional Repeatable Parameters ........................................................................................................................ 34
Default Value for a Parameter ............................................................................................................................ 34
Variables Representing Several Parameters ....................................................................................................... 34
Chapter 2: Using CA Datacom/DB Utility (DBUTLTY) 37
Overview .................................................................................................................................................................... 37
Multiple Commands ............................................................................................................................................ 37
Prerequisite Commands ...................................................................................................................................... 37
Syntax Check ....................................................................................................................................................... 38
Messages ............................................................................................................................................................. 38
JCL Requirements for z/OS .................................................................................................................................. 38
Requirement to Run APF-Authorized, z/OS ........................................................................................................ 39
Command Syntax ....................................................................................................................................................... 39
Command ............................................................................................................................................................ 39
Keyword Parameters ........................................................................................................................................... 39
Line Length .......................................................................................................................................................... 39
End of Command ................................................................................................................................................. 40
Comments ........................................................................................................................................................... 40
Console Commands .................................................................................................................................................... 41
DBUTLTY STATUS ................................................................................................................................................. 41
DBUTLTY Dynamic Extend Considerations ................................................................................................................. 43
Impact of Table Partitioning on DBUTLTY Functions .................................................................................................. 43
-
6 DBUTLTY Reference Guide for z/OS
Any Parent Table Name Restriction .................................................................................................................... 43
Area level DBUTLTY control ................................................................................................................................ 44
BACKUP Utility ..................................................................................................................................................... 44
EXTRACT Utility ................................................................................................................................................... 44
LOAD Utility ......................................................................................................................................................... 44
REORG Utility ...................................................................................................................................................... 46
Forward Recovery Utility..................................................................................................................................... 46
Area Level DBUTLTY Control ...................................................................................................................................... 46
MULTUSE= Keyword ........................................................................................................................................... 46
Database ACCESS ................................................................................................................................................ 49
Area Level ACCESS ............................................................................................................................................... 51
COMM CLOSE Function ....................................................................................................................................... 52
Dynamic System Table ........................................................................................................................................ 52
Summary of Restrictions and Requirements....................................................................................................... 53
Utility Function Summary ........................................................................................................................................... 53
Simplify Considerations .............................................................................................................................................. 57
Functions Requiring Inactive MUF ...................................................................................................................... 57
Functions Needing the CXX ................................................................................................................................. 62
JCL Requirements for the CXX Data Set ..................................................................................................................... 70
Chapter 3: ACCESS (Restricting Opens or Maintenance) 71
Length of Time to Process .......................................................................................................................................... 71
Buffer Writes .............................................................................................................................................................. 72
Area Level DBUTLTY Control ...................................................................................................................................... 72
How to Use the Console Command ........................................................................................................................... 73
How to Use the DBUTLTY Command .......................................................................................................................... 74
Example JCL ................................................................................................................................................................ 79
Sample Report ............................................................................................................................................................ 79
Chapter 4: ACCT (Accounting Facility) 81
Activating the Accounting Facility .............................................................................................................................. 81
ACCT CATALOG (Catalog Accounting Database) ........................................................................................................ 82
When to Use ....................................................................................................................................................... 82
How to Use .......................................................................................................................................................... 83
Example JCL ......................................................................................................................................................... 84
Sample Report ..................................................................................................................................................... 84
ACCT CLOSE (Close Accounting Tables) ...................................................................................................................... 87
When to Use ....................................................................................................................................................... 87
How to Use the Console Command .................................................................................................................... 88
How to Use the DBUTLTY Command .................................................................................................................. 88
Example JCL ......................................................................................................................................................... 89
-
Contents 7
Sample Report ..................................................................................................................................................... 89
ACCT EDIT (Edit Accounting Database Definitions) .................................................................................................... 90
When to Use ....................................................................................................................................................... 90
How to Use .......................................................................................................................................................... 91
Example JCL ......................................................................................................................................................... 93
Sample Report ..................................................................................................................................................... 93
ACCT OPEN (Open Accounting Tables) ....................................................................................................................... 95
When to Use ....................................................................................................................................................... 96
How to Use the Console Command .................................................................................................................... 96
How to Use the DBUTLTY Command .................................................................................................................. 97
Example JCL ......................................................................................................................................................... 98
Sample Report ..................................................................................................................................................... 98
ACCT SPILL (Force Accounting Data Recording) ......................................................................................................... 99
When to Use ....................................................................................................................................................... 99
How to Use the Console Command .................................................................................................................... 99
How to Use the DBUTLTY Command ................................................................................................................ 100
Example JCL ....................................................................................................................................................... 101
Sample Report ................................................................................................................................................... 101
Chapter 5: AUTOCOLL (Collect and Manage Snapshots) 103
Create a Snapshot .................................................................................................................................................... 103
How to Use ........................................................................................................................................................ 103
Example JCL ....................................................................................................................................................... 105
Sample Report ................................................................................................................................................... 105
Process a Snapshot Rowset into a Delta Rowset ..................................................................................................... 106
When to Use ..................................................................................................................................................... 106
How to Use ........................................................................................................................................................ 107
Example JCL ....................................................................................................................................................... 108
Sample Report ................................................................................................................................................... 108
User Created SUMMARY Delta Rowset .................................................................................................................... 109
When to Use ..................................................................................................................................................... 110
How to Use ........................................................................................................................................................ 110
Example JCL ....................................................................................................................................................... 113
Sample Report ................................................................................................................................................... 113
User Created BASELINE Delta Rowset ...................................................................................................................... 114
When to Use ..................................................................................................................................................... 115
How to Use ........................................................................................................................................................ 115
Example JCL ....................................................................................................................................................... 118
Sample Report ................................................................................................................................................... 118
User Created AVGPERF Delta Rowset ...................................................................................................................... 119
When to Use ..................................................................................................................................................... 120
-
8 DBUTLTY Reference Guide for z/OS
How to Use ........................................................................................................................................................ 120
Example JCL ....................................................................................................................................................... 123
Sample Report ................................................................................................................................................... 123
Create DSV Output Datasets .................................................................................................................................... 124
When to Use ..................................................................................................................................................... 125
How to Use ........................................................................................................................................................ 125
Example JCL ....................................................................................................................................................... 129
Sample Report ................................................................................................................................................... 130
Sample Report ................................................................................................................................................... 130
Reporting Snapshot Rowsets ................................................................................................................................... 131
When to Use ..................................................................................................................................................... 131
How to Use ........................................................................................................................................................ 131
Example JCL ....................................................................................................................................................... 133
Sample Report ................................................................................................................................................... 133
Reporting Delta Rowsets .......................................................................................................................................... 134
When to Use ..................................................................................................................................................... 135
How to Use ........................................................................................................................................................ 135
Example JCL ....................................................................................................................................................... 138
Sample Report ................................................................................................................................................... 138
Deleting Snapshot Rowsets ...................................................................................................................................... 139
When to Use ..................................................................................................................................................... 139
How to Use ........................................................................................................................................................ 140
Example JCL ....................................................................................................................................................... 142
Sample Report ................................................................................................................................................... 142
Deleting Delta Rowsets ............................................................................................................................................ 144
When to Use ..................................................................................................................................................... 144
How to Use ........................................................................................................................................................ 144
Example JCL ....................................................................................................................................................... 147
Sample Report ................................................................................................................................................... 147
Chapter 6: AUTOINFO (Collect Environmental MUF Information) 151
Overview .................................................................................................................................................................. 151
Using AUTOINFO in DBUTLTY ............................................................................................................................ 151
When to Use ..................................................................................................................................................... 152
How to Use ........................................................................................................................................................ 152
Example JCL ....................................................................................................................................................... 154
Sample Reports ................................................................................................................................................. 154
Chapter 7: AUTOSTAT (Report on MUF Information) 163
When to Use AUTOSTAT .......................................................................................................................................... 163
How to Use AUTOSTAT ............................................................................................................................................. 164
-
Contents 9
Console Commands .................................................................................................................................................. 166
MODIFY Command Format ............................................................................................................................... 167
Example JCL .............................................................................................................................................................. 169
Sample Report .......................................................................................................................................................... 170
Chapter 8: BACKUP (Create Backups) 171
BACKUP CXX (Back Up Directory) ............................................................................................................................. 171
When to Use ..................................................................................................................................................... 171
How to Use ........................................................................................................................................................ 172
Example JCL ....................................................................................................................................................... 174
Sample Report ................................................................................................................................................... 174
Back Up Data Area .................................................................................................................................................... 176
When to Use ..................................................................................................................................................... 176
How to Use ........................................................................................................................................................ 181
Example JCL - Native Key Sequence .................................................................................................................. 190
Sample Report ................................................................................................................................................... 190
Example JCL - Physical Sequence ..................................................................................................................... 192
Sample Report ................................................................................................................................................... 192
Chapter 9: COMM (Communicate with MUF) 195
Overview .................................................................................................................................................................. 195
Length of Time to Process a Request ................................................................................................................ 195
COMM ALTER (Modify Error Table) .......................................................................................................................... 196
When to Use ..................................................................................................................................................... 196
How to Use ........................................................................................................................................................ 196
Example JCL ....................................................................................................................................................... 203
Sample Report ................................................................................................................................................... 203
COMM CLOSE (Close Database or Area) .................................................................................................................. 204
When to Use ..................................................................................................................................................... 204
How to Use the Console Command .................................................................................................................. 204
How to Use the DBUTLTY Command ................................................................................................................ 205
Example JCL ....................................................................................................................................................... 208
Sample Report ................................................................................................................................................... 208
COMM CLRnnn (Reset Alternate Output Data Sets) ................................................................................................ 209
When to Use ..................................................................................................................................................... 209
How to Use the Console Command .................................................................................................................. 210
How to Use the DBUTLTY Command ................................................................................................................ 210
Example JCL ....................................................................................................................................................... 212
Sample Report ................................................................................................................................................... 212
COMM CLRPXX (Clear Statistics and Diagnostics Area (PXX)) .................................................................................. 213
When to Use ..................................................................................................................................................... 213
-
10 DBUTLTY Reference Guide for z/OS
How to Use the Console Command .................................................................................................................. 213
How to Use the DBUTLTY Command ................................................................................................................ 214
Example JCL ....................................................................................................................................................... 215
Sample Report ................................................................................................................................................... 215
COMM CONSOLE (Simulate Console Command) ..................................................................................................... 216
When to Use ..................................................................................................................................................... 216
How to Use the DBUTLTY Command ................................................................................................................ 216
Example JCL ....................................................................................................................................................... 218
COMM EOJ (End MUF Processing) ........................................................................................................................... 219
When to Use ..................................................................................................................................................... 219
How to Use the Console Command .................................................................................................................. 221
How to Use the DBUTLTY Command ................................................................................................................ 221
Example JCL ....................................................................................................................................................... 223
Sample Report ................................................................................................................................................... 223
MUF Startup Options Echoed............................................................................................................................ 224
Summary Reports Produced by the MUF During its EOJ Process ..................................................................... 224
COMM NEWRXX (Request New Recovery File) ........................................................................................................ 259
When to Use ..................................................................................................................................................... 260
How to Use the Console Command .................................................................................................................. 261
How to Use the DBUTLTY Command ................................................................................................................ 262
Example JCL ....................................................................................................................................................... 263
Sample Report ................................................................................................................................................... 263
COMM REQABORT (Abort a Request) ...................................................................................................................... 264
When to Use ..................................................................................................................................................... 265
How to Use the Console Command .................................................................................................................. 265
How to Use the DBUTLTY Command ................................................................................................................ 266
Example JCL ....................................................................................................................................................... 268
Sample Report ................................................................................................................................................... 268
COMM SNAP (Write Dump of Master List) .............................................................................................................. 269
When to Use ..................................................................................................................................................... 269
How to Use the Console Command .................................................................................................................. 269
How to Use the DBUTLTY Command ................................................................................................................ 270
Example JCL ....................................................................................................................................................... 272
Sample Report ................................................................................................................................................... 272
Master List Dump Example ............................................................................................................................... 273
COMM SNAPCSA (Print Dump of Common Storage Area) ....................................................................................... 273
When to Use ..................................................................................................................................................... 274
How to Use ........................................................................................................................................................ 274
Example JCL ....................................................................................................................................................... 275
Sample Report ................................................................................................................................................... 275
COMM SNAPSVC (Print Dump of the SVC) ............................................................................................................... 276
When to Use ..................................................................................................................................................... 276
-
Contents 11
How to Use ........................................................................................................................................................ 276
Example JCL ....................................................................................................................................................... 278
Sample Report ................................................................................................................................................... 278
Sample Report: COMM SNAPSVC .................................................................................................................... 278
COMM STATS (Write Current Statistics) .................................................................................................................. 278
When to Use ..................................................................................................................................................... 279
How to Use the Console Command .................................................................................................................. 279
How to Use the DBUTLTY Command ................................................................................................................ 280
Example JCL ....................................................................................................................................................... 282
Sample Report ................................................................................................................................................... 282
COMM STATUS (Print Status of MUF Jobs) .............................................................................................................. 283
When to Use ..................................................................................................................................................... 283
How to Use the Console Command .................................................................................................................. 284
How to Use the DBUTLTY Command ................................................................................................................ 284
Example JCL ....................................................................................................................................................... 286
Sample Report ................................................................................................................................................... 286
Sample COMM STATUS Online ......................................................................................................................... 303
COMM TASK_ABORT (Abort a Task)......................................................................................................................... 304
When to Use ..................................................................................................................................................... 304
How to Use ........................................................................................................................................................ 304
How to Use the DBUTLTY Command ................................................................................................................ 305
Chapter 10: CONFIRM (Verify Constraint Integrity) 307
When to Use ............................................................................................................................................................. 307
Determining Constraints In Effect ..................................................................................................................... 308
How to Use ............................................................................................................................................................... 308
Example JCL .............................................................................................................................................................. 310
Sample Report .......................................................................................................................................................... 310
Chapter 11: CXXCLONE (Clone Environment) 313
When to Use ............................................................................................................................................................. 313
How to Use ............................................................................................................................................................... 315
Examples .................................................................................................................................................................. 319
Example JCL .............................................................................................................................................................. 320
Sample Report .......................................................................................................................................................... 320
Chapter 12: CXXMAINT (Maintain Directory) 325
CXXMAINT ALTER CBSUSE (Trial Delete a Key from CBS Use) .................................................................................. 326
When to Use ..................................................................................................................................................... 326
How to Use ........................................................................................................................................................ 326
-
12 DBUTLTY Reference Guide for z/OS
Example JCL ....................................................................................................................................................... 328
Sample Report ................................................................................................................................................... 328
CXXMAINT ALTER CXXENQ (Controlling ENQ) .......................................................................................................... 329
When to Use ..................................................................................................................................................... 329
How to Use ........................................................................................................................................................ 329
CXXMAINT ALTER DBCS (Activating DBCS Support) ................................................................................................. 331
When to Use ..................................................................................................................................................... 331
How to Use ........................................................................................................................................................ 331
Example JCL ....................................................................................................................................................... 332
Sample Report ................................................................................................................................................... 333
CXXMAINT ALTER DSN (Modify Data Set Name) ...................................................................................................... 333
When to Use ..................................................................................................................................................... 333
How to Use ........................................................................................................................................................ 334
Example JCL ....................................................................................................................................................... 336
Sample Report ................................................................................................................................................... 336
CXXMAINT ALTER DSOP (Modify Space Reclamation Option) ................................................................................. 337
When to Use ..................................................................................................................................................... 337
How to Use ........................................................................................................................................................ 337
Example JCL ....................................................................................................................................................... 339
Sample Report ................................................................................................................................................... 339
CXXMAINT ALTER LANGUAGE (Activating LANGUAGE Support) .............................................................................. 340
When to Use ..................................................................................................................................................... 340
How to Use ........................................................................................................................................................ 340
Example JCL ....................................................................................................................................................... 341
Sample Report ................................................................................................................................................... 341
CXXMAINT ALTER LINK (Disable CXX Name Edit) ..................................................................................................... 342
When to Use ..................................................................................................................................................... 342
How to Use ........................................................................................................................................................ 343
Example JCL ....................................................................................................................................................... 344
Sample Report ................................................................................................................................................... 345
CXXMAINT ALTER LOGGING (Start/Stop Logging by Table) ..................................................................................... 345
When to Use ..................................................................................................................................................... 345
How to Use ........................................................................................................................................................ 346
Example JCL ....................................................................................................................................................... 347
Sample Report ................................................................................................................................................... 348
CXXMAINT ALTER OPTION2= (Activating Other Features) ....................................................................................... 348
CXXMAINT ALTER OPTION2=datafs (DATAFS Support) ..................................................................................... 349
CXXMAINT ALTER OPTION2=datahu (High Used Mark) .................................................................................... 350
CXXMAINT ALTER OPTION2=areaev (Data Area Extent Validation) .................................................................. 353
CXXMAINT ALTER OPTION2=sumode (Single User Mode) ................................................................................ 354
CXXMAINT ALTER OPTION2=MATCHSID ........................................................................................................... 355
CXXMAINT ALTER SINGLE (Run in a Single User Environment) ................................................................................ 357
-
Contents 13
When to Use ..................................................................................................................................................... 357
How to Use ........................................................................................................................................................ 357
Example JCL ....................................................................................................................................................... 358
Sample Report ................................................................................................................................................... 358
CXXMAINT CONVERT1214 (Upgrade CXX to Current Version) ................................................................................. 359
When to Use ..................................................................................................................................................... 359
How to Use ........................................................................................................................................................ 359
Example JCL ....................................................................................................................................................... 361
Sample Report ................................................................................................................................................... 361
CXXMAINT CONVERT1412 (Downgrade CXX to Prior Version) ................................................................................ 362
When to Use ..................................................................................................................................................... 362
How to Use ........................................................................................................................................................ 363
Example JCL ....................................................................................................................................................... 364
Sample Report ................................................................................................................................................... 364
CXXMAINT DDPROD (Update Directory) .................................................................................................................. 365
When to Use ..................................................................................................................................................... 366
How to Use ........................................................................................................................................................ 369
Example JCL ....................................................................................................................................................... 371
Sample Report ................................................................................................................................................... 371
CXXMAINT DELETE (Delete CXX Definitions) ............................................................................................................ 373
Deleting a Database .......................................................................................................................................... 373
Deleting Tables .................................................................................................................................................. 373
How to Use ........................................................................................................................................................ 374
Example JCL ....................................................................................................................................................... 375
Sample Report ................................................................................................................................................... 375
Example JCL ....................................................................................................................................................... 376
Sample Report ................................................................................................................................................... 376
CXXMAINT FORMAT0102 (Base Level Full Features) ............................................................................................... 377
When to Use ..................................................................................................................................................... 377
How to Use ........................................................................................................................................................ 377
Example JCL ....................................................................................................................................................... 378
Sample Report ................................................................................................................................................... 378
CXXMAINT FORMAT0201 (Base Level Restrict to r11 Compatible Features) ........................................................... 379
When to Use ..................................................................................................................................................... 379
Considerations for Using FORMAT0201 ............................................................................................................ 380
How to Use ........................................................................................................................................................ 380
Example JCL ....................................................................................................................................................... 381
Sample Report ................................................................................................................................................... 381
CXXMAINT PURGE (Remove Database from Directory) ........................................................................................... 382
When to Use ..................................................................................................................................................... 382
How to Use ........................................................................................................................................................ 383
Example JCL ....................................................................................................................................................... 383
-
14 DBUTLTY Reference Guide for z/OS
Sample Report ................................................................................................................................................... 383
Chapter 13: DBTEST (Execute Test/Analysis Programs) 385
DBTEST Command 1 (DBURSTR) .............................................................................................................................. 386
How to Use ........................................................................................................................................................ 386
DBTEST Command 2 (DBURTBL) ............................................................................................................................... 388
DBTEST Command 3 (DBUREND) ............................................................................................................................. 391
DBTEST Command 4 (DBTEST) ................................................................................................................................. 392
DBTEST DBTSTPR (Test Program) ............................................................................................................................. 393
When to Use ..................................................................................................................................................... 393
Control Statements ........................................................................................................................................... 394
Example DBTSTPR JCL ....................................................................................................................................... 396
Sample Report ................................................................................................................................................... 396
DBTEST DBIDCPR (Index Analysis Program) ............................................................................................................. 398
When to Use ..................................................................................................................................................... 398
How to Use ........................................................................................................................................................ 399
Example DBIDCPR JCL........................................................................................................................................ 399
Sample Report ................................................................................................................................................... 399
DBTEST DBIDPPR (Index Population Analysis Program) ........................................................................................... 400
When to Use ..................................................................................................................................................... 400
How to Use ........................................................................................................................................................ 401
Example DBIDPPR JCL ........................................................................................................................................ 401
Sample Report ................................................................................................................................................... 402
Chapter 14: DEFAULT (Control Defaults) 405
When to Use ............................................................................................................................................................. 405
How to Use ............................................................................................................................................................... 405
Sample Report .......................................................................................................................................................... 406
Chapter 15: DEFRAG (Defragment Index) 409
Overview .................................................................................................................................................................. 409
Locking .............................................................................................................................................................. 410
Processing ......................................................................................................................................................... 410
Restrictions ....................................................................................................................................................... 411
Stopping DEFRAG .............................................................................................................................................. 411
Security Considerations .................................................................................................................................... 411
DEFRAG .................................................................................................................................................................... 411
When to Use ..................................................................................................................................................... 411
How to Use ........................................................................................................................................................ 411
Example JCL ....................................................................................................................................................... 414
-
Contents 15
Sample Report ................................................................................................................................................... 414
Chapter 16: EDIT (Validate Syntax) 417
When to Use ............................................................................................................................................................. 417
How to Use ............................................................................................................................................................... 417
Example JCL .............................................................................................................................................................. 418
Sample Report .......................................................................................................................................................... 418
Chapter 17: ENCRYPT (Facilitate Data Encryption) 421
When to Use ............................................................................................................................................................. 421
Opening and Backing Up Encrypted Tables .............................................................................................................. 422
DBUTLTY LOAD and REORG BASIC Encryption Functions ......................................................................................... 422
How to Use ............................................................................................................................................................... 423
SET_BASIC_KEY_n Option ................................................................................................................................. 423
Example JCL .............................................................................................................................................................. 424
Sample Report .......................................................................................................................................................... 424
Chapter 18: EXTBKUP (Extract from Backup File) 427
When to Use ............................................................................................................................................................. 428
How to Use ............................................................................................................................................................... 428
Example JCL .............................................................................................................................................................. 430
Sample Report .......................................................................................................................................................... 431
Chapter 19: EXTEND (Extend Data or Index Areas) 433
When to Use ............................................................................................................................................................. 433
How Space Is Allocated for an EXTEND ............................................................................................................. 434
Verifying the Extend .......................................................................................................................................... 435
Successful Execution Requirements and Controls ............................................................................................ 435
How to Use ............................................................................................................................................................... 436
Example JCL .............................................................................................................................................................. 438
Sample Report .......................................................................................................................................................... 438
Chapter 20: EXTRACT (Extract Data Table) 441
When to Use ............................................................................................................................................................. 441
Extracting in Native Key Sequence .................................................................................................................... 442
Extracting in Physical Key Sequence ................................................................................................................. 442
EXTRACT Output ................................................................................................................................................ 443
Master List Requirements ................................................................................................................................. 443
Successful Execution Requirements and Controls ............................................................................................ 444
-
16 DBUTLTY Reference Guide for z/OS
How to Use ............................................................................................................................................................... 445
Parallel Extract ......................................................................................................................................................... 451
FIRSTKEY= and LASTKEY= Keywords in Parallel Extract ..................................................................................... 452
Restrictions ....................................................................................................................................................... 453
Example JCL .............................................................................................................................................................. 453
Sample Report .......................................................................................................................................................... 454
Chapter 21: FILEOUT (Define Output Data Sets) 455
When to Use ............................................................................................................................................................. 455
How to Use ............................................................................................................................................................... 455
Examples .................................................................................................................................................................. 457
Chapter 22: FLEXPOOL (Dynamic Buffers) 459
When to Use ............................................................................................................................................................. 459
How to Use the Console Command ......................................................................................................................... 460
How to Use the DBUTLTY Command ........................................................................................................................ 461
Example JCL .............................................................................................................................................................. 462
Sample Report .......................................................................................................................................................... 462
Chapter 23: FORCE (Force Keyword Values) 465
When to Use ............................................................................................................................................................. 465
How to Use ............................................................................................................................................................... 465
Sample Report .......................................................................................................................................................... 466
Chapter 24: GAPFIX (Fix CDC Gaps) 467
When to Use ............................................................................................................................................................. 467
How to Use ............................................................................................................................................................... 469
GAPFIX Reports ........................................................................................................................................................ 471
Sample Report .......................................................................................................................................................... 471
GAPFIX Detail Report Sample ............................................................................................................................ 473
Chapter 25: INIT CXX/FXX/IXX/LXX/WXX/Data Area 475
Restrictions ............................................................................................................................................................... 475
Multivolume INITs ............................................................................................................................................. 475
INIT CXX (Format Directory) ..................................................................................................................................... 475
When to Use ..................................................................................................................................................... 475
How to Use ........................................................................................................................................................ 477
Example JCL ....................................................................................................................................................... 478
Sample Report ................................................................................................................................................... 478
-
Contents 17
INIT Data Area (Format Data Area) .......................................................................................................................... 479
When to Use ..................................................................................................................................................... 480
How to Use ........................................................................................................................................................ 482
Example JCL ....................................................................................................................................................... 485
Sample Report ................................................................................................................................................... 485
INIT IXX (Format Index Area) .................................................................................................................................... 486
When to Use ..................................................................................................................................................... 487
How to Use ........................................................................................................................................................ 490
Example JCL ....................................................................................................................................................... 493
Sample Report ................................................................................................................................................... 494
INIT LXX (Format Log Area) ...................................................................................................................................... 494
When to Use ..................................................................................................................................................... 495
How to Use ........................................................................................................................................................ 497
Example JCL for Single Log Area ........................................................................................................................ 498
Sample Report ................................................................................................................................................... 498
INIT FXX (Format Force Area) ................................................................................................................................... 499
When to Use ..................................................................................................................................................... 500
How to Use ........................................................................................................................................................ 501
Example JCL for Force Area ............................................................................................................................... 502
Sample Report ................................................................................................................................................... 502
INIT WXX (Format RRM Log) .................................................................................................................................... 503
When to Use ..................................................................................................................................................... 503
How to Use ........................................................................................................................................................ 504
Chapter 26: LINK (Link to the CXX) 505
When to Use ............................................................................................................................................................. 506
How to Use ............................................................................................................................................................... 507
Example JCL .............................................................................................................................................................. 507
Sample Report .......................................................................................................................................................... 508
Chapter 27: LOAD (Build CXX or Data Area) 511
Overview .................................................................................................................................................................. 511
LOAD CXX (Build CXX) ............................................................................................................................................... 512
When to Use ..................................................................................................................................................... 512
How to Use ........................................................................................................................................................ 515
Example JCL ....................................................................................................................................................... 517
Sample Report ................................................................................................................................................... 518
LOAD (Build a Data Area) ......................................................................................................................................... 519
When to Use ..................................................................................................................................................... 519
Loading Multiple Tables Into a Data Area ......................................................................................................... 523
Adding a Table to a Data Area Not Using REPLACE ........................................................................................... 524
-
18 DBUTLTY Reference Guide for z/OS
How to Use ........................................................................................................................................................ 527
Example JCL ....................................................................................................................................................... 544
Sample Report ................................................................................................................................................... 544
SORTDFLT=YES Report Section for LOAD .......................................................................................................... 551
Chapter 28: LOCK (Lock a Data Area) 555
When to Use ............................................................................................................................................................. 555
How to Use ............................................................................................................................................................... 555
Example JCL .............................................................................................................................................................. 556
Sample Report .......................................................................................................................................................... 557
Chapter 29: MASSADD (Add Records to Table) 559
When to Use ............................................................................................................................................................. 559
Use of Pipeline .................................................................................................................................................. 559
Log Check Points and Backout .......................................................................................................................... 559
Unique Keys ...................................................................................................................................................... 560
Integrity Constraints.......................................................................................................................................... 560
Use of the MUF ............................................................................