DBUTLTY Reference Guide for z/OS - CA Technologies Datacom V15 0 Public-ENU... · Contact CA...

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



Example JCL ......................................................................................................................................................... 96

Sample Report ..................................................................................................................................................... 96

ACCT SPILL (Force Accounting Data Recording) ......................................................................................................... 97

When to Use ....................................................................................................................................................... 97



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


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



Example JCL ....................................................................................................................................................... 210

Sample Report ................................................................................................................................................... 210

COMM CLRPXX (Clear Statistics and Diagnostics Area (PXX)) .................................................................................. 211

When to Use ..................................................................................................................................................... 211




Example JCL ....................................................................................................................................................... 213

Sample Report ................................................................................................................................................... 213

COMM CONSOLE (Simulate Console Command) ..................................................................................................... 214

When to Use ..................................................................................................................................................... 214


Example JCL ....................................................................................................................................................... 216

COMM EOJ (End MUF Processing) ........................................................................................................................... 217

When to Use ..................................................................................................................................................... 217



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



Example JCL ....................................................................................................................................................... 262

Sample Report ................................................................................................................................................... 262

COMM REQABORT (Abort a Request) ...................................................................................................................... 263

When to Use ..................................................................................................................................................... 263



Example JCL ....................................................................................................................................................... 266

Sample Report ................................................................................................................................................... 266

COMM SNAP (Write Dump of Master List) .............................................................................................................. 267

When to Use ..................................................................................................................................................... 267



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



Example JCL ....................................................................................................................................................... 280

Sample Report ................................................................................................................................................... 280

COMM STATUS (Print Status of MUF Jobs) .............................................................................................................. 281

When to Use ..................................................................................................................................................... 281



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


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


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


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


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


How to Use ............................................................................................................................................................... 548

Example JCL .............................................................................................................................................................. 551


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



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


Successful Execution Requirements and Controls ........................

DBUTLTY Reference Guide for z/OS - CA Technologies Datacom V15 0 Public-ENU... · Contact CA...

Documents

Transcript of DBUTLTY Reference Guide for z/OS - CA Technologies Datacom V15 0 Public-ENU... · Contact CA...