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