20-Jul-2018Date:

CA Datacom Core - 15.0CA Datacom/DB Database and System Administration

CA Datacom Core - 15.0

20-Jul-2018 3/879

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 is proprietary information of CA and may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA.

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 2018 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

CA Datacom/DB Database and System Administration 4

Table of Contents

Add and Delete Keys Faster ..................................................................... 39

Securing CA Datacom/DB and CA Datacom Datadictionary .................... 41Securing Data ............................................................................................................................................ 41

Securing Data Definitions .......................................................................................................................... 42

Security Provided by Other CA Products .................................................................................................. 42

Data Encryption ......................................................................................... 43DBUTLTY Encryption ................................................................................................................................ 45

Opening and Backing Up Encrypted Tables ............................................................................................. 46

DBUTLTY LOAD and REORG BASIC Encryption Functions .................................................................... 46

CA Datacom Datadictionary Data Encryption Considerations ............................................................ 47

Dynamic System Tables Data Encryption Considerations ........................................................................ 47

Defining the Information Base ................................................................... 47CA Datacom Datadictionary ................................................................................................................ 48

CA Datacom/DB ..................................................................................................................................... 48

SQL DDL Statements in an Application .................................................................................................... 48

CA Dataquery for CA Datacom SQL Mode ......................................................................................... 48

Storing Definitions in CA Datacom Datadictionary .............................................................................. 49

Maintenance using Console Commands ................................................... 49Common Component ................................................................................................................................ 50

MUF Startup and Console-like Commands ......................................................................................... 50

Console-Only Commands ................................................................................................................... 60

Related Messages .............................................................................................................................. 60

SQL_CONSOLE (SQX) Table ................................................................................................................... 62

Return Codes for SQL_CONSOLE (SQX) Table ................................................................................ 63

SQL Error Handling ............................................................................................................................. 63

Generic Messages .............................................................................................................................. 63

CA Datacom/DB Database and System Administration 5

MUF Startup Options and Console/Console-Like Commands .................................................................. 63

Accessing and Updating CA Datacom/DB Databases ............................ 106Accessing CA Datacom/DB Databases from Applications ................................................................... 106

Accessing CA Datacom/DB Databases Using Other CA Products ...................................................... 107

Large Page Support ................................................................................ 108

64-bit Memory and MUF Data Buffers ..................................................... 108

Simplify Feature ...................................................................................... 109Simplify Environment ............................................................................................................................... 109

Benefits of the Simplify Feature .............................................................................................................. 110

Simplify and the MUF .............................................................................................................................. 111

Update Considerations ............................................................................................................................ 111

CXX, DBSIDPR, and DBUTLTY .............................................................................................................. 112

DBUTLTY SET OPTION1= Options ........................................................................................................ 112

Sysplex Execution ................................................................................................................................... 113

MUF Execution with SIMPLIFY ............................................................................................................... 114

SIMPLIFY Mode and Directory CXX Identity ........................................................................................... 117

DBSIDPR Considerations ....................................................................................................................... 117

Special Actions Prior to Opening Areas .................................................................................................. 118

SIMPLIFY Protection for Data Sets ......................................................................................................... 119

ACCESS OPTIMIZE ......................................................................................................................... 119

Data Set Protection in a Datacom Environment ................................................................................ 120

Layer 1 ..................................................................................................................................... 120

Layer 2 ..................................................................................................................................... 120

DBUTLTY Functions with MUF Not Enabled .......................................................................................... 122

INIT AREA=CXX ............................................................................................................................... 123

LOAD AREA=CXX(no DBID= keyword) ............................................................................................ 123

CXXCLONE (no DBID=keyword) ...................................................................................................... 124

CXXMAINT OPTION=ALTER,OPTION2=MATCHSID ...................................................................... 124

INIT AREA=LXX ................................................................................................................................ 125

INIT AREA=FXX ................................................................................................................................ 125

RESET AREA=LXX and AREA=CXX ............................................................................................... 126

SET OPTION1=MUF_NOT_ENABLED (all functions that follow) ..................................................... 127

CA Datacom/DB Database and System Administration 6

DBUTLTY Functions with or without MUF Enabled ................................................................................ 127

CXXCLONE AREA=CXX,DBID=n .................................................................................................... 128

BACKUP AREA=CXX ....................................................................................................................... 128

BACKUP and EXTRACT data area .................................................................................................. 128

EXTEND index area or data area ..................................................................................................... 129

EXTRACT data area ......................................................................................................................... 129

INIT index area or data area ............................................................................................................. 129

LOAD AREA=CXX,DBID=n .............................................................................................................. 130

LOAD data area ................................................................................................................................ 130

MASSADD with MULTUSE=NO ....................................................................................................... 131

RECOVERY forward without MULTUSE=YES ................................................................................. 131

REMOVE ........................................................................................................................................... 131

REORG ............................................................................................................................................. 132

REPORT AREA=CXX ....................................................................................................................... 132

REPORT AREA=LXX ........................................................................................................................ 133

RETIX ................................................................................................................................................ 133

DBUTLTY Functions Needing the CXX ................................................................................................... 134

BACKUP ........................................................................................................................................... 135

CXXMAINT ........................................................................................................................................ 136

EXTBKUP ......................................................................................................................................... 136

EXTEND ............................................................................................................................................ 136

EXTRACT ......................................................................................................................................... 137

INIT ................................................................................................................................................... 137

LOAD ................................................................................................................................................ 138

RECOVERY forward ......................................................................................................................... 139

REORG load portion ......................................................................................................................... 139

REPORT ........................................................................................................................................... 140

RESET .............................................................................................................................................. 140

RETIX ................................................................................................................................................ 140

Establishing Communication with z/OS ................................................... 141Installation and Use of the CA Datacom/DB Program Call PC Routine ............................................... 141

Production and Test Subsystem and Subroutine Support ................................................................ 142

CAIRIM Installation ........................................................................................................................... 142

REPORT MEMORY=MVS Changes Reflecting Version 15.1 Modules ............................................ 142

Task Communications ............................................................................................................................. 143

Installing the Monitoring Interface for CA SYSVIEW ............................................................................... 143

Connecting to z/OS Using Cross-System Coupling Facility (XCF) ......................................................... 143

Using the Cross-System Coupling Facility (XCF) .............................................................................. 144

Dynamic XCF Implementation for CA Datacom/DB ....................................................................... 144

Dynamic System Table Access ......................................................................................................... 145

CA Datacom/DB Database and System Administration 7

CA Datacom/DB Utility (DBUTLTY) Processing ............................................................................. 145

XCF Usage Reporting ....................................................................................................................... 145

Implications of XCF Processing ........................................................................................................ 146

Connecting to z/OS Using CAICCI (CCI) ................................................................................................ 147

MUF Startup Options ........................................................................................................................ 147

DBSIDPR Parameters ....................................................................................................................... 148

Choosing a Multi-User Facility .......................................................................................................... 148

Evaluating XCF and CAICCI Protocols Using DBPNGPR ...................................................................... 149

Using the Multi-User Facility .................................................................... 151How the Multi-User Facility Works .......................................................................................................... 153

SQL Requirements .................................................................................................................................. 153

Authorized Libraries (z/OS) ..................................................................................................................... 153

IPL in a z/VSE Environment .................................................................................................................... 154

CBS Heuristic Index ................................................................................................................................ 154

Processing ........................................................................................................................................ 154

Running without the CBS Heuristic Database ................................................................................... 155

Implementation .................................................................................................................................. 155

Connecting Users with the MUF .............................................................................................................. 155

z/OS Systems ................................................................................................................................... 155

z/VSE Systems ................................................................................................................................. 155

VM Systems ...................................................................................................................................... 156

Multiple MUF Environments Sharing One CXX ....................................................................................... 156

Using Multiple MUFs in One Batch Application ....................................................................................... 156

Record-/Set-at-a-Time Application Programs ................................................................................... 157

SQL Applications ............................................................................................................................... 157

Two-Phase Commit ........................................................................................................................... 157

User Requirements Table (URT) Support ......................................................................................... 157

Multiple MUF Interface ...................................................................................................................... 158

Using Multiple MUFs in CICS Application ............................................................................................... 159

24-bit and NORENT in User Address Space .......................................................................................... 160

DBINRPR Module ............................................................................................................................. 160

DBMODS= parameter in DBURINF Macro ....................................................................................... 160

Version Independence ...................................................................................................................... 160

DBSYSID 31-Bit Considerations ....................................................................................................... 160

DBDUMPR Dump Module ................................................................................................................. 161

Other Considerations ........................................................................................................................ 161

Protect CXX to Single MUF or MUFplex ................................................................................................. 161

Features having Problems ................................................................................................................ 162

Modifying MUF Startup Options .............................................................................................................. 162

CA Datacom/DB Database and System Administration 8

ACCESS ........................................................................................................................................... 162

Example ................................................................................................................................... 166

ACCT ................................................................................................................................................ 166

ACCTPRM ........................................................................................................................................ 167

ALL_INFO_REPORT ........................................................................................................................ 168

ALTER_SHADOW_TO_MUFPLEX ................................................................................................... 169

ALTER_SHADOW_TO_TAKE_OVER .............................................................................................. 169

ARM .................................................................................................................................................. 170

BREAK .............................................................................................................................................. 171

BUFF_DUMP_OUTPUT_SVC .......................................................................................................... 172

BUFFER_POOL_CONTENT ............................................................................................................. 172

BUFFER_POOL_COUNT ................................................................................................................. 173

BUFFER_POOL_DEF ....................................................................................................................... 173

CBS ................................................................................................................................................... 175

CBS_DBID_TEMP ............................................................................................................................ 178

CDC .................................................................................................................................................. 179

CDC_BASE ....................................................................................................................................... 179

CDC_BASE_PLUS ............................................................................................................................ 180

CDC_EXCLUDE_JOBNAME ............................................................................................................ 181

CDC_TABLE ..................................................................................................................................... 182

CDC_TABLE_PLUS .......................................................................................................................... 183

CDCL ................................................................................................................................................ 184

CDCL_CLOSE .................................................................................................................................. 185

CDCL_DBID ...................................................................................................................................... 185

CDCL_DBID_PLUS ........................................................................................................................... 185

CDCL_DS ......................................................................................................................................... 186

CDCL_OPEN .................................................................................................................................... 187

CDCL_POLL ..................................................................................................................................... 187

CDCL_RESET .................................................................................................................................. 188

CDCM_CLOSE ................................................................................................................................. 188

CDCM_CNTTB .................................................................................................................................. 189

CDCM_DBID ..................................................................................................................................... 189

CDCM_DBID_PLUS .......................................................................................................................... 190

CDCM_ID .......................................................................................................................................... 190

CDCM_OPEN ................................................................................................................................... 191

CDCM_POLL .................................................................................................................................... 191

CDCM_SIDNAME ............................................................................................................................. 191

CDCM_WARN ................................................................................................................................... 192

COVERED ........................................................................................................................................ 192

z/OS 64-Bit Support ................................................................................................................. 193

CONFIRM_SHADOW_TAKE_OVER_nnn ........................................................................................ 195

CPU_TSN_READ_DELAY_SEC ...................................................................................................... 196

DATACOM ........................................................................................................................................ 197

CA Datacom/DB Database and System Administration 9

DATAPOOL ....................................................................................................................................... 198

DATASPACE .................................................................................................................................... 200

z/OS Multi-User Facility Local Connections ............................................................................. 201

DATETIME ........................................................................................................................................ 201

DICTIONARY .................................................................................................................................... 202

DORESTART .................................................................................................................................... 202

DUMP_OUTPUT ............................................................................................................................... 204

DYNAMIC_EXTEND ......................................................................................................................... 205

DYNAMIC_EXTEND_MSGS ............................................................................................................. 208

ECHO ................................................................................................................................................ 209

EXCTLNO ......................................................................................................................................... 210

FLEXPOOL ....................................................................................................................................... 210

FORCE_ABEND_FULL_SNAPER .................................................................................................... 212

FORCE_NO_64BIT ........................................................................................................................... 212

HISTORY .......................................................................................................................................... 213

HISTORY_END_HOUR .................................................................................................................... 213

IOTASK ............................................................................................................................................. 214

LIMITED_INSTALL_MUF .................................................................................................................. 215

LOG_RECORD_ENCRYPT .............................................................................................................. 216

LOG_RECORD_FORMAT ................................................................................................................ 216

LOG_RECORD_UPDAT_SIZE ......................................................................................................... 218

LOG_RECORD_USER_CMPRS ...................................................................................................... 218

LOG_ROLLBACK_MINUTES ........................................................................................................... 218

LOG_ROLLBACK_RECORDS .......................................................................................................... 219

LOGOPTION ..................................................................................................................................... 220

LOGPEND ......................................................................................................................................... 220

LOGPOOL ......................................................................................................................................... 221

LOGRCV ........................................................................................................................................... 221

LOGRSYS ......................................................................................................................................... 223

LOGSPILL ......................................................................................................................................... 223

LUW_STATEMENT_LIMIT ............................................................................................................... 225

MAXELRQ ......................................................................................................................................... 226

?MEM ................................................................................................................................................ 227

MESSAGE ........................................................................................................................................ 228

MUF .................................................................................................................................................. 231

Copy of DDB--MUF part 2 (14.0) ............................................................................................. 232

Copy of DDB--MUF part 3 (14.0) ............................................................................................. 232

MUFMSG .......................................................................................................................................... 233

MUFMSG part 2 (14.0) ............................................................................................................. 233

MUFMSG part 3 (14.0) ............................................................................................................. 233

MUFPLEX ......................................................................................................................................... 234

NEWCOPY ........................................................................................................................................ 238

NONSWAP ........................................................................................................................................ 239

CA Datacom/DB Database and System Administration 10

NORESTART .................................................................................................................................... 239

OPEN_BASE .................................................................................................................................... 241

PLANSEC ......................................................................................................................................... 241

PROCEDURE ................................................................................................................................... 242

Number of Procedure TCBs ..................................................................................................... 243

Performance Considerations .................................................................................................... 244

PXXSTATS ....................................................................................................................................... 244

QUIESCE .......................................................................................................................................... 245

RCERROR ........................................................................................................................................ 247

READAHD ......................................................................................................................................... 249

REPORT_COMPRESS_PAD ........................................................................................................... 250

REQCOMIT ....................................................................................................................................... 251

REQROLBK ...................................................................................................................................... 252

RESTART ......................................................................................................................................... 253

ROLLBACK_ABORT ......................................................................................................................... 255

RRS ................................................................................................................................................... 255

RXX ................................................................................................................................................... 256

RXX_VARIABLE_BLK ...................................................................................................................... 257

RXXROLLBACK ................................................................................................................................ 257

SDI_ABEND_1 .................................................................................................................................. 259

Contents of the Service Desk Issue ......................................................................................... 259

SECURITY ........................................................................................................................................ 260

SMPTASK ......................................................................................................................................... 261

DBSMAPR Subtasks for zIIP ................................................................................................... 263

Dynamic Systems Table for zIIP .............................................................................................. 264

MUF EOJ Report for zIIP ......................................................................................................... 264

Messages Related to SRB Mode Execution ............................................................................ 265

SQL_ALLOW_TIME_240000 ............................................................................................................ 265

SQL_COND_INFO_AREAS .............................................................................................................. 266

SQL_COUNT_OPT_OFF ......................................................................................................... 266

SQL_COUNT_OPT_OFF .................................................................................................................. 266

SQL_COUNT_OPT_OFF ......................................................................................................... 267

SQL_DATACOM_LOOPLIMIT .......................................................................................................... 267

SQL_KATAKANA_CODE_PAGE ...................................................................................................... 267

SQL_OPTIMIZATION_LEVEL .......................................................................................................... 268

SQL_SOURCE_CACHE_SIZE ......................................................................................................... 268

SQL_SOURCE_CACHE_STMTS ..................................................................................................... 269

SQLDEFAULT ................................................................................................................................... 270

SQLOPTION ..................................................................................................................................... 271

SQLOPTION_TTMID ........................................................................................................................ 273

STAR ................................................................................................................................................. 274

STARSYN ......................................................................................................................................... 276

STATUS_BASE dbid ......................................................................................................................... 277

CA Datacom/DB Database and System Administration 11

STATUS_CDC .................................................................................................................................. 278

SUBTASK ......................................................................................................................................... 280

SYSOUT ........................................................................................................................................... 280

SYSPOOL ......................................................................................................................................... 283

SYSTEMDBID ................................................................................................................................... 286

TASKS .............................................................................................................................................. 286

VIRTUAL ........................................................................................................................................... 289

z/OS 64-Bit Support ................................................................................................................. 290

X_COVERED_MAX_SIZE ................................................................................................................ 292

X_CXX_ALLOW_SHARING .............................................................................................................. 293

X_DATA_SPACE_TRACE ................................................................................................................ 294

X_DEFRAG_DELAY_QUEUE .......................................................................................................... 294

X_DUMP_NUMBER_BLKS ............................................................................................................... 295

X_DUMP_SIP_ERROR ..................................................................................................................... 295

X_IO_24BIT_SIZE ............................................................................................................................ 296

X_IO_HIGH_THRESHOLD ............................................................................................................... 296

X_IO_LOW_THRESHOLD ................................................................................................................ 297

X_IO_MSG_THRESHOLD ................................................................................................................ 297

X_LOAD_NO_QUEUE_WAIT ........................................................................................................... 298

X_LOG_AHEAD_BLKS ..................................................................................................................... 298

X_LOG_CONTROL_BLKS ................................................................................................................ 299

X_LOG_DELAY_BATCH .................................................................................................................. 299

X_LOG_DELAY_BLK ........................................................................................................................ 300

X_LOG_DELAY_SEC ....................................................................................................................... 301

X_LOG_DELAY_TIME ...................................................................................................................... 302

X_LOG_FULL_BLK ........................................................................................................................... 302

X_LOG_MINIMUM_BLK ................................................................................................................... 303

X_LOG_SPILL_BLKS ....................................................................................................................... 303

X_LOG_STABLE_BLKS ................................................................................................................... 304

X_LOG_WRITE_OLD_BLKS ............................................................................................................ 304

X_MSB_MSGS .................................................................................................................................. 305

X_OPEN_CLOSE_MSGS ................................................................................................................. 306

X_OPEN_CLOSE_SUBTASKS n ..................................................................................................... 306

X_PEND_WRITE_BLKS ................................................................................................................... 307

X_RESTART_DETAIL ....................................................................................................................... 307

X_SQL_CLOSE_WITH_HOLD ......................................................................................................... 308

XCF_FROM ...................................................................................................................................... 308

ZIIP_USER_LIMIT ............................................................................................................................. 310

Initiating the MUF .................................................................................................................................... 311

Diagnosing Initiation Problems in z/OS ............................................................................................. 312

Sample z/OS JCL .............................................................................................................................. 312

Sample z/VSE JCL ............................................................................................................................ 313

CA Datacom/DB Database and System Administration 12

Running MUF as a Started Task (z/OS) .................................................................................................. 314

Job Priority ........................................................................................................................................ 314

CICS Processing ............................................................................................................................... 314

IMS/DC Processing ........................................................................................................................... 314

Batch Processing .............................................................................................................................. 315

Priority and Forced Checkpointing .................................................................................................... 315

Special Priorities ............................................................................................................................... 315

Terminating the MUF ............................................................................................................................... 316

Print the Statistics and Diagnostics Area Report .............................................................................. 316

Using the COMM EOJ Option ........................................................................................................... 316

Canceling an EOJ Request ............................................................................................................... 317

Using Operating System Cancel ....................................................................................................... 317

Abnormal Termination ....................................................................................................................... 317

Using SNAPCSA (z/OS) .......................................................................................................... 317

Using SNAPSVC (z/OS) .......................................................................................................... 318

Shadow MUF Environment ..................................................................................................................... 318

Overview of the Shadow MUF Environment ..................................................................................... 319

How to Run in a Shadow MUF Environment ..................................................................................... 319

Console Commands ................................................................................................................. 320

Return Codes ........................................................................................................................... 320

Other Considerations ............................................................................................................... 320

Physical MUF Operations ................................................................................................................. 320

How to Use for Unplanned Outages ................................................................................................. 321

How to Use ALTER_SHADOW_TO_TAKE_OVER Command ................................................ 321

How to Use for Planned Outages ...................................................................................................... 323

MUF Termination Considerations ............................................................................................ 324

How to Use for a Planned 'Unplanned' Outage ................................................................................. 326

Physical MUF Differences ................................................................................................................. 326

Mode S MUF Startup Dynamics ........................................................................................................ 328

User Connectivity .............................................................................................................................. 328

How to Speed Activation ................................................................................................................... 329

Using MVS Memory Report .............................................................................................................. 330

DBUTLTY Considerations ................................................................................................................. 330

How to Prevent Return Code 68 ....................................................................................................... 330

How to Prevent Return Code 85 ....................................................................................................... 330

How to Handle Return Code 86 ........................................................................................................ 330

Symmetric Multi-Processing (z/OS Only) ................................................................................................ 331

How it Works ..................................................................................................................................... 331

MUF Startup Options ........................................................................................................................ 332

Modifying DBSIDPR Parameters ............................................................................................................ 333

MUFplex and CA Datacom CICS Services .................................................................................... 335

Not Using MUFplex .................................................................................................................. 335

CA Datacom/DB Database and System Administration 13

Using MUFplex ......................................................................................................................... 335

MUFplex, Alternate DBSIDPR, and DBUTLTY ........................................................................ 336

CA Datacom CICS Services Special Requirement ............................................................... 337

Debugging Using an Additional SYSIN with the DBUTLTY SET Function ....................................... 338

DBIN1PR Module ..................................................................................................................... 338

DBUTLTY DEFAULT Function ................................................................................................. 340

DBUTLTY FORCE Function .................................................................................................... 341

DBSYSID parameters ....................................................................................................................... 341

ABEND= ................................................................................................................................... 341

CASEC= ................................................................................................................................... 342

CCISYS= .................................................................................................................................. 342

CONNECT_ALLOW_PRIORITY= ............................................................................................ 342

CONSOLE_MINUTES= ........................................................................................................... 343

CXXNAME= ............................................................................................................................. 343

DBUTLTY_EDIT_DDNAME= ................................................................................................... 344

DEBUG_TRACE= .................................................................................................................... 344

DELAY_DBUTLTY_SECURITY= ............................................................................................. 345

DELAY_RETRY_SECONDS= ................................................................................................. 345

DELAY_WAITING_MESSAGE= .............................................................................................. 345

DELAY68= ............................................................................................................................... 346

DELAY85= ............................................................................................................................... 346

DSN_XXX= .............................................................................................................................. 346

ENVIRONMENT_TYPE= ......................................................................................................... 347

FORCE_DSN_CXXNAME= ..................................................................................................... 347

FORCE_SVC_TEST= .............................................................................................................. 348

LINE= ....................................................................................................................................... 348

LINES= ..................................................................................................................................... 349

NO522= .................................................................................................................................... 349

PC= .......................................................................................................................................... 349

PREVENT_522= ...................................................................................................................... 350

PRTEXIT= ................................................................................................................................ 350

RRMNAME= ............................................................................................................................ 350

SIMPLIFY_MODE= .................................................................................................................. 351

SVC= ........................................................................................................................................ 352

TARGET_MUF_LIST= ............................................................................................................. 352

TOGROUP= ............................................................................................................................. 353

VMID= ...................................................................................................................................... 353

VMSUBID= ............................................................................................................................... 353

Change Data Capture ............................................................................................................................. 354

CDCL, CDCU, and CDCM Programs ................................................................................................ 355

Console Command Considerations ................................................................................................... 356

CDC_BASE and CDC_TABLE ................................................................................................. 356

CA Datacom/DB Database and System Administration 14

Other Considerations ............................................................................................................... 356

User-Written Programs to Process the CDC Database .................................................................... 357

GAP Processing ................................................................................................................................ 357

Change Data Capture Tasks in a MUFplex ...................................................................................... 357

Restart Processing ............................................................................................................................ 358

Recovery File (RXX) Processing ....................................................................................................... 358

MUF EOJ Report ............................................................................................................................... 358

Dynamic System Tables ................................................................................................................... 358

RXXROLLBACK, Aborted Rollbacks, and Partial Backouts ............................................................. 359

LXX RESET or INIT .......................................................................................................................... 359

CA Datacom Datadictionary CDC System Database ................................................................. 360

Maintenance Commands with CDC when TXNUNDO=NO .............................................................. 360

Accounting Facility Considerations ................................................................................................... 360

Rules when Testing CDC .................................................................................................................. 360

Source MUF Setup and Use ............................................................................................................. 361

CDCM Subtask Definition in Source MUF ............................................................................... 361

Other CDCM Subtask Considerations ..................................................................................... 362

Excluding Updates From a Job From CDC Processing ........................................................... 363

Source MUF Normal Operational Details ................................................................................. 363

Target MUF Setup and Use .............................................................................................................. 364

CDCL Task Definition in Target MUF ....................................................................................... 364

CDCL-Related Options ............................................................................................................ 364

Messages Returned by CDCL Task ......................................................................................... 366

Modes of Operation for a Target MUF ..................................................................................... 366

Target MUF Normal Operational Details for Remote Mode ..................................................... 367

Target MUF Normal Operational Details for Local Mode ......................................................... 368

CDC1 Test Program (Load Member DBCP1PR) .............................................................................. 369

SYSIN Options ......................................................................................................................... 369

Program Logic and Sample Report .......................................................................................... 371

CDC1 Program Messages ....................................................................................................... 372

CDCU Sample Program (Source CDC3) .......................................................................................... 373

Using EXCEPTION_FOR_JOBNAME for Sites Using the CDC Facility ........................................... 376

zIIP Processors ....................................................................................... 378

Memory Resident Data Facility ............................................................... 378Covered Areas ........................................................................................................................................ 379

Virtual Areas ............................................................................................................................................ 380

How to Define Memory Resident Areas .................................................................................................. 380

COVERED FIRST and COVERED ACTIVE ..................................................................................... 380

CA Datacom/DB Database and System Administration 15

Covered Generic versus Specific Areas ........................................................................................... 381

Defining Virtual Areas ....................................................................................................................... 381

Virtual Generic versus Specific Areas ............................................................................................... 381

Summary of Virtual Processing ............................................................................................................... 381

Block Size ......................................................................................................................................... 382

Memory Use ...................................................................................................................................... 382

Reporting on Use of Memory Resident Areas ......................................................................................... 382

Implementing and Maintaining Virtual Library System Files .................... 382VLS Files ................................................................................................................................................. 382

Defining the Files to VPE ........................................................................................................................ 383

Maintaining the VLS Files ........................................................................................................................ 384

Extending a VLS File ............................................................................................................................... 384

Modifying Datadictionary Signon Transactions ....................................... 385CA Datacom Datadictionary Express Signon Considerations ........................................................... 385

Adding CA Datacom Datadictionary Express Signon to SC00TRAN ................................................ 385

Using CA Datacom CICS Services ......................................................... 386Interfacing with Application Programs ..................................................................................................... 387

Maintenance ............................................................................................................................................ 387

User Exits ................................................................................................................................................ 387

Displays System Resources upon Request ............................................................................................ 387

Controls System Resources upon Request ............................................................................................ 388

Facilitates Application Development ....................................................................................................... 389

Using CA Datacom IMS/DC Services ..................................................... 389Control Database Definition/ Maintenance Utility .................................................................................... 390

Control Database Reporting Utility .......................................................................................................... 390

Interface Features ................................................................................................................................... 391

Performance Governor Features ............................................................................................................. 391

Online Services Features ........................................................................................................................ 391

Establishing a Development Environment ............................................... 392

CA Datacom/DB Database and System Administration 16

Development Environment Requirements ............................................................................................... 392

Using CA Datacom CICS Services for Testing and Debugging ..................................................... 393

Using CA Datacom Datadictionary Interactive SQL Service Facility .......................................... 393

One CA Datacom Datadictionary System per Directory (CXX) ......................................................... 393

Implementation .................................................................................................................................. 393

Transporting Definitions Between Systems ...................................................................................... 394

Databases with Non-SQL Accessible Tables ........................................................................... 395

Databases with SQL Accessible Tables .................................................................................. 395

Tables with Constraints ............................................................................................................ 395

Testing Changes to Definitions ......................................................................................................... 396

Databases with Non-SQL Accessible Tables ........................................................................... 396

Databases Containing SQL Accessible Tables ........................................................................ 396

Parallel Sysplex, Data Sharing (MUFplex) .............................................. 397Variable Logging Considerations ............................................................................................................ 398

Major Data Sharing (MUFplex) Features .......................................................................................... 399

Workload Balancing .......................................................................................................................... 400

Data Sharing Objectives, Restrictions, Limitations .................................................................................. 400

Data Sharing Restrictions ................................................................................................................. 401

Data Sharing Limitations ................................................................................................................... 401

MUF Startup Options Relating to MUFplex ............................................................................................. 402

Other Options to Consider ................................................................................................................ 402

Multi-User Facility Parameters ................................................................................................................ 403

MUF DBSIDPR (DBSYSID Macro) Considerations ................................................................................ 403

MUFplex Tuning ...................................................................................................................................... 403

Hardware Related Tuning ................................................................................................................. 403

Coupling Facility Related Tuning ...................................................................................................... 403

Coupling Facility Strategies for MUFplex ................................................................................................ 404

Coupling Facility Usage Levels ......................................................................................................... 404

Coupling Facility Structures ............................................................................................................... 406

Calculating Structure Sizes ............................................................................................................... 406

DBMXMPR and DMBXEPR Example JCL ............................................................................... 407

Example Structure Definitions .................................................................................................. 408

Directory (CXX) Processing in a Data Sharing Environment (MUFplex) ........................................... 408

Statistics and Diagnostics Area (PXX) Processing in a MUFplex ..................................................... 409

User Exit, Open ................................................................................................................................. 409

Accounting Processing in a MUFplex ............................................................................................... 409

Logging Processing in a MUFplex .................................................................................................... 409

Logging Issues in a MUFplex ............................................................................................................ 410

Transaction Boundary Processing in a MUFplex .............................................................................. 410

CA Datacom/DB Database and System Administration 17

User Databases (DBID) Processing in a MUFplex ............................................................................ 410

SQL Temporary Table (TTM) Processing in a MUFplex ................................................................... 411

Compound Boolean Selection Index Processing in a MUFplex ........................................................ 411

Security Processing in a MUFplex .................................................................................................... 411

Restart Processing in a MUFplex ...................................................................................................... 411

Restart Issues in a MUFplex ............................................................................................................. 412

Abnormal Termination Processing in a MUFplex .............................................................................. 412

Special MUFplex Handling for Master List Dumps/Snaps ................................................................ 413

Dynamic System Tables in a MUFplex ............................................................................................. 413

Performance Optimization Information .............................................................................................. 413

DBUTLTY Functions with MUFplex ................................................................................................... 413

Area Level Control Restrictions within a MUFplex ............................................................................ 414

DBMXMPR Macro Parameters ............................................................................................................... 414

MUFPLEXNO= .................................................................................................................................. 414

DBMXEPR Macro Parameters ................................................................................................................ 416

Coupling Facility Report/Dump ................................................................................................................ 417

Example MUFplex List Structure Detail Statistics ............................................................................. 418

LIST USAGE Values ................................................................................................................ 419

Example of Row and Lock Activity ........................................................................................... 420

Creating and Maintaining the Directory (CXX) ........................................ 421Directory (CXX) Maintenance .................................................................................................................. 421

Maintenance with the Multi-User Facility Active ................................................................................ 422

Creating the Directory (CXX) ................................................................................................................... 422

Multi-User Facility Parameters .......................................................................................................... 423

Estimate Space Requirements .......................................................................................................... 423

Allocate the Directory ........................................................................................................................ 423

z/OS Systems .......................................................................................................................... 423

z/VSE Systems ........................................................................................................................ 424

Initialize the Directory ........................................................................................................................ 424

Re-create the Directory ............................................................................................................ 424

Link Data and Index Areas to Directory (CXX) .................................................................................. 425

DBUTLTY LINK Function ......................................................................................................... 426

Backing Up and Restoring the Directory ................................................................................................. 427

Restoring the Complete Directory ..................................................................................................... 427

Restoring a Single Database ............................................................................................................ 427

Copying a Single Database to a New Database ID .......................................................................... 428

Restoring Index and Data Areas ....................................................................................................... 428

Upgrading the Directory (CXX) ................................................................................................................ 428

Reporting on the Directory (CXX) ............................................................................................................ 429

CA Datacom/DB Database and System Administration 18

Directory Report (Type A) ................................................................................................................. 429

Directory Report (Type B) ................................................................................................................. 429

Maintaining Definitions ............................................................................................................................ 429

Modifying Selected Options .............................................................................................................. 430

Logging .................................................................................................................................... 430

Key Use .................................................................................................................................... 430

Directory Information ................................................................................................................ 430

Data Area Space Management ................................................................................................ 430

Deleting Databases ................................................................................................................................. 431

Delete a Database ............................................................................................................................ 431

Delete a Table ................................................................................................................................... 431

SQL Procedure to Delete a Table ............................................................................................ 431

Purging a Database .......................................................................................................................... 432

Extending the Directory (CXX) ................................................................................................................ 432

Resetting Exclusive Control .................................................................................................................... 433

When to Reset Exclusive Control ...................................................................................................... 433

How to Reset Exclusive Control ........................................................................................................ 433

Resetting Table Indicators ....................................................................................................................... 433

When to Reset Table Indicators ........................................................................................................ 433

How to Reset Table Indicators With Logging Active ......................................................................... 433

How to Reset Table Indicators Without Logging Active .................................................................... 434

Index Swapping ....................................................................................................................................... 434

Creating and Maintaining the Statistics and Diagnostics Area (PXX) ..... 436Types of Statistics ................................................................................................................................... 436

Allocating ................................................................................................................................................. 437

Accumulating Statistics ........................................................................................................................... 437

Reporting ................................................................................................................................................. 438

SYSOUT Processing in z/OS ............................................................................................................ 438

Selecting the Option ................................................................................................................. 439

Clearing a SYSOUT Data Set .................................................................................................. 439

Redirecting SYSOUT ............................................................................................................... 440

Resetting (Clearing) ................................................................................................................................ 441

Creating and Maintaining the Log Area (LXX) ......................................... 441Allocating ................................................................................................................................................. 442

Initializing ................................................................................................................................................. 443

LXX Large Number LRSN LBSN ............................................................................................................. 443

CA Datacom/DB Database and System Administration 19

Reporting ................................................................................................................................................. 444

Resetting ................................................................................................................................................. 445

Creating and Maintaining the Force Area (FXX) ..................................... 445Allocating ................................................................................................................................................. 445

Initializing ................................................................................................................................................. 445

Creating and Maintaining the RRM Log (WXX) ....................................... 446

Creating and Maintaining the Temporary Table Manager Area .............. 447

Creating and Maintaining the Datadictionary Databases ........................ 449Estimating Space .................................................................................................................................... 450

Data Area Placement .............................................................................................................................. 450

Compression ........................................................................................................................................... 450

Availability During Maintenance .............................................................................................................. 450

Planning DATA-DICT Database Maintenance ........................................................................................ 450

Planning DDD Database Maintenance .................................................................................................... 451

Backing Up the Database Areas ............................................................................................................. 451

Extending the Database Areas ................................................................................................................ 451

Restoring the Databases ......................................................................................................................... 452

Reorganizing the Database Areas .......................................................................................................... 452

Modifying the Database ID for DATA-DICT ............................................................................................. 452

Modifying the Database ID for DDD ........................................................................................................ 454

Modifying DATA-DICT Database Attributes ............................................................................................ 455

Number of Entity HISTory Status Versions ....................................................................................... 455

Length of Names for Entity-Occurrences .......................................................................................... 455

Attribute-Types .................................................................................................................................. 456

Reporting ................................................................................................................................................. 456

Recovery ................................................................................................................................................. 456

Creating and Maintaining the