100% found this document useful (1 vote)

2K views

DBRC Guide and Reference

This edition replaces and makes obsolete the previous edition, SC26-9428-00. The technical changes for this edition are indicated by a vertical bar to the left of a change. DBRC Guide and Reference is a reference manual for DBRC products.

Uploaded by

api-3709524

Available Formats

Download as PDF, TXT or read online on Scribd

100% found this document useful (1 vote)

2K views

DBRC Guide and Reference

Uploaded by

api-3709524

Available Formats

Download as PDF, TXT or read online on Scribd

You are on page 1/ 507

IMS Version 7

DBRC Guide and Reference

SC26-9428-01
IMS Version 7

DBRC Guide and Reference

SC26-9428-01
Note

Before using this information and the product it supports, be sure to read the general information under “Notices” on
page xvii.

Second Edition (June 2001)

This edition replaces and makes obsolete the previous edition, SC26-9428-00. The technical changes for this version
are summarized under “Summary of Changes” on page xxiii. The technical changes for this edition are indicated by a
vertical bar to the left of a change.
© Copyright International Business Machines Corporation 1974, 2001. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Product Names. . . . . . . . . . . . . . . . . . . . . . . . . xix

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Prerequisite Knowledge . . . . . . . . . . . . . . . . . . . . . xxi
How to Use This Book . . . . . . . . . . . . . . . . . . . . . . xxi
How to Read the Syntax Diagrams . . . . . . . . . . . . . . . . . xxi
Related Reading . . . . . . . . . . . . . . . . . . . . . . . . xxi
How to Send Your Comments . . . . . . . . . . . . . . . . . . . xxii

Summary of Changes . . . . . . . . . . . . . . . . . . . . . xxiii

| Changes to The Current Edition of This Book for IMS Version 7 . . . . . . xxiii
Changes to This Book for IMS Version 7 . . . . . . . . . . . . . . . xxiii
Library Changes for IMS Version 7 . . . . . . . . . . . . . . . . . xxiii

Part 1. How to Use DBRC . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Chapter 1. DBRC in the IMS Database Recovery Process . . . . . . . . 5

What Is DBRC? . . . . . . . . . . . . . . . . . . . . . . . . . 5
DBRC Tasks . . . . . . . . . . . . . . . . . . . . . . . . . 6
DBRC Components . . . . . . . . . . . . . . . . . . . . . . 6
IMS Recovery utilities and functions . . . . . . . . . . . . . . . . 7
Recording Recovery-Related Information . . . . . . . . . . . . . . . 8
Generating JCL . . . . . . . . . . . . . . . . . . . . . . . . 8
When Should You Use DBRC? . . . . . . . . . . . . . . . . . . . 10
Initializing DBRC . . . . . . . . . . . . . . . . . . . . . . . . 10
Specifying When DBRC Is to Be Used . . . . . . . . . . . . . . . 10
Registering Databases and Database Data Sets . . . . . . . . . . . 12
Considerations for Using DBRC. . . . . . . . . . . . . . . . . . 12
DBRC Functions . . . . . . . . . . . . . . . . . . . . . . . 13
Data Set Naming Conventions . . . . . . . . . . . . . . . . . . 21
DBRC Support for Remote Site Recovery . . . . . . . . . . . . . . 22

Chapter 2. Considerations for a DBRC System . . . . . . . . . . . . 25

© Copyright IBM Corp. 1974, 2001 iii

Condensing the Accumulated SLDS or RLDS (Change Accumulation). . . . 33
When Is Change Accumulation Required? . . . . . . . . . . . . . . 35
Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
The Database Recovery Process . . . . . . . . . . . . . . . . . 38
How DBRC Helps in Recovery . . . . . . . . . . . . . . . . . . 39
Planning Recovery Procedures . . . . . . . . . . . . . . . . . . 39
Setting Up Recovery Mechanisms . . . . . . . . . . . . . . . . . 39
Recovery Facilities . . . . . . . . . . . . . . . . . . . . . . 40
Recovery without DBRC . . . . . . . . . . . . . . . . . . . . 42
Restart after IMS Failure . . . . . . . . . . . . . . . . . . . . 42
Restart after DBRC Failure . . . . . . . . . . . . . . . . . . . 42
Recovery Involving IRLM Configurations . . . . . . . . . . . . . . 42
Batch Backout . . . . . . . . . . . . . . . . . . . . . . . . 43
Archiving Log Records . . . . . . . . . . . . . . . . . . . . . 43

Chapter 3. Initializing and Maintaining the RECON . . . . . . . . . . 45

Planning Considerations for the RECON . . . . . . . . . . . . . . . 46
First-Time Users . . . . . . . . . . . . . . . . . . . . . . . 46
Avoiding RECON Contention Problems . . . . . . . . . . . . . . . 46
Initial RECON Access . . . . . . . . . . . . . . . . . . . . . 54
Records in the RECON . . . . . . . . . . . . . . . . . . . . . 55
Maintaining the RECONs . . . . . . . . . . . . . . . . . . . . 64

Chapter 4. RECON Upgrade Utility (DSPURU00) . . . . . . . . . . . 71

What Is the RECON Upgrade Utility?. . . . . . . . . . . . . . . . . 71
Before You Start . . . . . . . . . . . . . . . . . . . . . . . . 71
Upgrade Procedure . . . . . . . . . . . . . . . . . . . . . . . 71
Input and Output . . . . . . . . . . . . . . . . . . . . . . . . 73
JCL Requirements . . . . . . . . . . . . . . . . . . . . . . . 73
Upgrade Utility Return Codes and Message Information . . . . . . . . . . 73
Example of RECON Upgrade Utility JCL . . . . . . . . . . . . . . . 74

Chapter 5. Database Recovery Control Utility (DSPURX00) . . . . . . . 75

What Is the Database Recovery Control Utility (DSPURX00)? . . . . . . . 75
Input and Output . . . . . . . . . . . . . . . . . . . . . . . . 75
Example of DBRC Utility JCL . . . . . . . . . . . . . . . . . . . 76
JCL Requirements . . . . . . . . . . . . . . . . . . . . . . . 76

Chapter 6. Hints and Tips for DBRC . . . . . . . . . . . . . . . . 79

Locating the Last SLDS Stop Time in RECON . . . . . . . . . . . . . 79
Adjusting GENMAX When It Is Reached or It Is Too High . . . . . . . . . 80
Solutions for Situation #1 . . . . . . . . . . . . . . . . . . . . 81
Solution for Situation #2 . . . . . . . . . . . . . . . . . . . . 81
Getting PRILOG Compression to Work . . . . . . . . . . . . . . . . 82
PRILOG Record Sizes . . . . . . . . . . . . . . . . . . . . . . 82
Using NOTIFY.PRILOG to Close an Open Online PRILOG . . . . . . . . . 83
Deleting Log Records . . . . . . . . . . . . . . . . . . . . . . 84
Working with Subsystem Records (SSYS) . . . . . . . . . . . . . . . 84
Naming Conventions for SSIDs in RECON Subsystem Records . . . . . . 84
Batch Backout . . . . . . . . . . . . . . . . . . . . . . . . 85
Deleting a Subsystem Record . . . . . . . . . . . . . . . . . . 85
Subsystem Record Size . . . . . . . . . . . . . . . . . . . . 85
Removing Authorization Inconsistency between the SSYS from DB/AREA
Records . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Getting Change Accumulation to Start Processing Logs Again . . . . . . . 86
Getting Change Accumulation Working When It States Nothing to Process . . . 86

iv DBRC Guide & Reference

Moving Log Data Sets . . . . . . . . . . . . . . . . . . . . . . 87
Reorganizing RECON to Increase Maximum RECORDSIZE . . . . . . . . 87
Cataloging Data Sets . . . . . . . . . . . . . . . . . . . . . . 89
Performing Multiple Cold Starts in a Test Environment . . . . . . . . . . 90
Avoiding Some Causes of RECON Enqueue Problems . . . . . . . . . . 91
In a Shared DASD Environment . . . . . . . . . . . . . . . . . 92
In a Non-Shared DASD Environment . . . . . . . . . . . . . . . . 92

Part 2. Command Reference . . . . . . . . . . . . . . . . . . . . . . . . . 93

Chapter 7. DBRC Commands . . . . . . . . . . . . . . . . . . . 99

Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . 99
Separators . . . . . . . . . . . . . . . . . . . . . . . . . 100
Continuation Characters . . . . . . . . . . . . . . . . . . . . 100
Comments . . . . . . . . . . . . . . . . . . . . . . . . . 100
Commands . . . . . . . . . . . . . . . . . . . . . . . . . 100
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 100
DBRC Time Stamps . . . . . . . . . . . . . . . . . . . . . 101
Using the Commands in This Book . . . . . . . . . . . . . . . . 107
Notational Conventions . . . . . . . . . . . . . . . . . . . . 107
How to Read the Syntax Diagrams . . . . . . . . . . . . . . . . 107
DBRC Online Command Syntax . . . . . . . . . . . . . . . . . . 110

Chapter 8. BACKUP Command . . . . . . . . . . . . . . . . . . 111

BACKUP.RECON . . . . . . . . . . . . . . . . . . . . . . . 111
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 111
Example of Creating Backups of a RECON . . . . . . . . . . . . . 111

Chapter 9. CHANGE Commands . . . . . . . . . . . . . . . . . 113

CHANGE.ADS . . . . . . . . . . . . . . . . . . . . . . . . 113
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 113
Example of Changing an ADS Record . . . . . . . . . . . . . . . 113
CHANGE.BKOUT . . . . . . . . . . . . . . . . . . . . . . . 114
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 114
Example of Using the CHANGE.BKOUT Command . . . . . . . . . . 116
CHANGE.CA . . . . . . . . . . . . . . . . . . . . . . . . . 116
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 116
Example of Changing a Change Accumulation Run Record . . . . . . . 117
CHANGE.CAGRP . . . . . . . . . . . . . . . . . . . . . . . 118
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 118
Examples of Using the CHANGE.CAGRP Command . . . . . . . . . 119
CHANGE.DB . . . . . . . . . . . . . . . . . . . . . . . . . 120
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 121
Example of Changing a Record for a DB Identified with the DBD Parm 125
CHANGE.DBDS . . . . . . . . . . . . . . . . . . . . . . . . 126
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 127
Example of Changing a Record for a Fast Path DEDB . . . . . . . . . 132
CHANGE.DBDSGRP . . . . . . . . . . . . . . . . . . . . . . 132
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 133
Example of Changing a Group of DBDSs. . . . . . . . . . . . . . 134
CHANGE.IC . . . . . . . . . . . . . . . . . . . . . . . . . 134
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 135
Example of Changing an Image Copy Record . . . . . . . . . . . . 136
CHANGE.PRILOG (for OLDS) . . . . . . . . . . . . . . . . . . . 137
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 137
Example of Renaming an OLDS . . . . . . . . . . . . . . . . . 138

Contents v
CHANGE.PRILOG (for RLDS) . . . . . . . . . . . . . . . . . . . 139
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 140
Examples of Using the CHANGE.PRILOG (for RLDS) Command . . . . . 142
CHANGE.PRILOG (for SLDS and TSLDS) . . . . . . . . . . . . . . 143
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 144
Examples of Using CHANGE.PRILOG (for SLDS and TSLDS) . . . . . . 147
CHANGE.RECON . . . . . . . . . . . . . . . . . . . . . . . 147
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 148
Suggestions for Time Zone Label Table Management . . . . . . . . . 155
Example of Updating the RECON Header Record . . . . . . . . . . 155
CHANGE.RECON (for THT or REPTHT) . . . . . . . . . . . . . . . 156
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 156
Example of Specifying a Replacement THT Entry. . . . . . . . . . . 156
CHANGE.SECLOG (for OLDS) . . . . . . . . . . . . . . . . . . 156
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 157
Example Showing a SECOLDS Error . . . . . . . . . . . . . . . 158
CHANGE.SECLOG (for RLDS) . . . . . . . . . . . . . . . . . . 158
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 159
Examples of Using CHANGE.SECLOG (for RLDS) . . . . . . . . . . 161
CHANGE.SECLOG (for SLDS and TSLDS) . . . . . . . . . . . . . . 162
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 163
Examples of Using CHANGE.SECLOG (for SLDS and TSLDS) . . . . . 166
CHANGE.SG . . . . . . . . . . . . . . . . . . . . . . . . . 167
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 167
Example of Changing the Status of a Service Group . . . . . . . . . 167
CHANGE.SUBSYS . . . . . . . . . . . . . . . . . . . . . . . 168
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 168
Example of Identifying the IRLM . . . . . . . . . . . . . . . . . 169
CHANGE.UIC . . . . . . . . . . . . . . . . . . . . . . . . . 170
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 170
Example of Changing the Nonstandard ICDSN in RECON . . . . . . . 170

Chapter 10. DELETE Commands . . . . . . . . . . . . . . . . . 171

DELETE.ADS . . . . . . . . . . . . . . . . . . . . . . . . . 171
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 171
Example of Deleting an ADS Record . . . . . . . . . . . . . . . 171
DELETE.ALLOC . . . . . . . . . . . . . . . . . . . . . . . . 171
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 172
Example of Deleting an Allocation Record . . . . . . . . . . . . . 172
DELETE.BKOUT. . . . . . . . . . . . . . . . . . . . . . . . 172
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 172
Example of Using the DELETE.BKOUT Command . . . . . . . . . . 173
DELETE.CA . . . . . . . . . . . . . . . . . . . . . . . . . 173
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 173
Example of Deleting a Run Record . . . . . . . . . . . . . . . . 173
DELETE.CAGRP . . . . . . . . . . . . . . . . . . . . . . . 174
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 174
Example of Deleting CA Group Records . . . . . . . . . . . . . . 174
DELETE.DB . . . . . . . . . . . . . . . . . . . . . . . . . 174
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 174
Example of Deleting Records from RECON . . . . . . . . . . . . . 175
DELETE.DBDS . . . . . . . . . . . . . . . . . . . . . . . . 175
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 175
Example of Deleting Records for the DBDS . . . . . . . . . . . . . 175
DELETE.DBDSGRP . . . . . . . . . . . . . . . . . . . . . . 175
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 176

vi DBRC Guide & Reference

Example of Deleting a DBDS Group Record . . . . . . . . . . . . 176
DELETE.GSG . . . . . . . . . . . . . . . . . . . . . . . . . 176
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 176
Example of Deleting a Global Service Group Record . . . . . . . . . 176
DELETE.IC . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 177
Example of Deleting Information from an Image Copy Record . . . . . . 177
DELETE.LOG (for OLDS) . . . . . . . . . . . . . . . . . . . . 177
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 178
Example of Deleting an Interim OLDS Record . . . . . . . . . . . . 178
DELETE.LOG (for RLDS and SLDS) . . . . . . . . . . . . . . . . 178
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 179
Example of Deleting the Record of an RLDS and SLDS . . . . . . . . 180
DELETE.RECOV . . . . . . . . . . . . . . . . . . . . . . . 181
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 181
Example of Deleting a Recovery Record of the DBDS . . . . . . . . . 181
DELETE.REORG . . . . . . . . . . . . . . . . . . . . . . . 182
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 182
Example of Deleting a Reorganization Record of a DBDS . . . . . . . 182
DELETE.SG . . . . . . . . . . . . . . . . . . . . . . . . . 182
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 183
Example of Deleting a Global Service Group Record . . . . . . . . . 183
DELETE.SUBSYS . . . . . . . . . . . . . . . . . . . . . . . 183
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 183
Example of Deleting a Specified SUBSYS Record . . . . . . . . . . 183
DELETE.UIC . . . . . . . . . . . . . . . . . . . . . . . . . 184
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 184
Example of Deleting a Nonstandard Image Copy Data Set Record . . . . 184

Chapter 11. GENJCL Commands . . . . . . . . . . . . . . . . . 185

GENJCL.ARCHIVE . . . . . . . . . . . . . . . . . . . . . . . 185
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 185
Examples of Running the Log Archive Utility . . . . . . . . . . . . 188
GENJCL.CA . . . . . . . . . . . . . . . . . . . . . . . . . 189
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 189
Examples of Running the Change Accumulation Utility . . . . . . . . . 192
GENJCL.CLOSE. . . . . . . . . . . . . . . . . . . . . . . . 193
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 193
Examples of Running the Log Recovery Utility . . . . . . . . . . . . 195
GENJCL.IC. . . . . . . . . . . . . . . . . . . . . . . . . . 195
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 197
Examples of Running the Database Image Copy Utility. . . . . . . . . 200
GENJCL.OIC . . . . . . . . . . . . . . . . . . . . . . . . . 202
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 203
Examples of Running the Online Database Image Copy Utility . . . . . . 206
GENJCL.RECEIVE . . . . . . . . . . . . . . . . . . . . . . . 207
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 208
Examples of Running the Database Recovery Utility to Receive an Image
Copy . . . . . . . . . . . . . . . . . . . . . . . . . . 210
GENJCL.RECOV . . . . . . . . . . . . . . . . . . . . . . . 211
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 212
Examples of Running the Database Recovery Utility. . . . . . . . . . 215
GENJCL.USER . . . . . . . . . . . . . . . . . . . . . . . . 216
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 217
Example of Running DBRC . . . . . . . . . . . . . . . . . . . 220

Contents vii
Chapter 12. INIT Commands . . . . . . . . . . . . . . . . . . . 221
INIT.ADS . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 221
Example of Creating a Record That Defines an ADS . . . . . . . . . 222
INIT.CA . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 222
Example of Creating a Record That Defines a CA Data Set . . . . . . . 223
INIT.CAGRP . . . . . . . . . . . . . . . . . . . . . . . . . 223
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 223
Example of Creating a CA Group. . . . . . . . . . . . . . . . . 224
INIT.DB . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 225
Example of Creating a SHARELVL 1 DB Record . . . . . . . . . . . 226
INIT.DBDS . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 227
Example of Identifying the DBDS to Initiate DBRC’s Control Over Recovery 231
INIT.DBDSGRP . . . . . . . . . . . . . . . . . . . . . . . . 231
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 232
Example of Creating a Group of DBDSs . . . . . . . . . . . . . . 232
INIT.GSG . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 233
Example of Creating a Global Service Group . . . . . . . . . . . . 233
INIT.IC . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 234
Example of Creating a Record That Defines the ICDSN . . . . . . . . 235
| INIT.PART . . . . . . . . . . . . . . . . . . . . . . . . . . 235
| Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 236
INIT.RECON . . . . . . . . . . . . . . . . . . . . . . . . . 239
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 239
Example of Initializing the RECON . . . . . . . . . . . . . . . . 243
INIT.SG . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 243
Examples of Creating Service Groups . . . . . . . . . . . . . . . 244

Chapter 13. LIST Commands . . . . . . . . . . . . . . . . . . 245

viii DBRC Guide & Reference

LIST.LOG (for a PRILOG Family). . . . . . . . . . . . . . . . . . 254
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 255
Example of Listing a PRILOG Family of Records . . . . . . . . . . . 255
LIST.LOG (for a Category of Records) . . . . . . . . . . . . . . . . 255
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 257
Example of Displaying RECON Records Specified by STARTIME . . . . . 258
Example of Displaying a Subsystem’s OLDS Records . . . . . . . . . 258
LIST.RECON . . . . . . . . . . . . . . . . . . . . . . . . . 258
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 259
Examples of Displaying the RECONs . . . . . . . . . . . . . . . 259
LIST.SUBSYS . . . . . . . . . . . . . . . . . . . . . . . . . 260
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 260
Example of Displaying All Online Subsystem Records . . . . . . . . . 261

Chapter 14. NOTIFY Commands . . . . . . . . . . . . . . . . . 263

NOTIFY.ALLOC . . . . . . . . . . . . . . . . . . . . . . . . 263
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 263
Example of Adding Allocation Information to RECON . . . . . . . . . 264
NOTIFY.BKOUT . . . . . . . . . . . . . . . . . . . . . . . . 264
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 264
Example of Adding a Backout Record to RECON . . . . . . . . . . . 265
NOTIFY.CA. . . . . . . . . . . . . . . . . . . . . . . . . . 265
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 266
Example of Adding CADSN Information to RECON . . . . . . . . . . 268
NOTIFY.IC . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 269
Example of Notifying DBRC of Concurrent Image Copy Completion . . . . 270
NOTIFY.PRILOG (for OLDS) . . . . . . . . . . . . . . . . . . . 271
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 271
Examples of Using the NOTIFY.PRILOG (for OLDS) Command . . . . . 273
NOTIFY.PRILOG (for RLDS) . . . . . . . . . . . . . . . . . . . 274
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 275
Examples of Using the NOTIFY.PRILOG (for RLDS) Command . . . . . 278
NOTIFY.PRILOG (for SLDS and TSLDS) . . . . . . . . . . . . . . . 279
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 279
Example of Adding Primary SLDS Information to RECON. . . . . . . . 282
NOTIFY.RECOV . . . . . . . . . . . . . . . . . . . . . . . . 283
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 283
Example of Adding DBDS Recovery Information to RECON . . . . . . . 285
NOTIFY.REORG . . . . . . . . . . . . . . . . . . . . . . . . 285
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 286
Example Adding DBDS Reorganization Information to RECON . . . . . . 288
NOTIFY.SECLOG (for OLDS) . . . . . . . . . . . . . . . . . . . 288
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 288
Examples of Using the NOTIFY.SECLOG (for OLDS) Command . . . . . 290
NOTIFY.SECLOG (for RLDS) . . . . . . . . . . . . . . . . . . . 291
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 291
Examples of Using the NOTIFY.SECLOG (for RLDS) Command . . . . . 294
NOTIFY.SECLOG (for SLDS and TSLDS) . . . . . . . . . . . . . . 294
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 295
Example of Adding Secondary SLDS Information to RECON . . . . . . 298
NOTIFY.SUBSYS . . . . . . . . . . . . . . . . . . . . . . . 298
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 298
Example of Adding a New Subsystem Record to RECON. . . . . . . . 299
NOTIFY.UIC . . . . . . . . . . . . . . . . . . . . . . . . . 299
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 300

Contents ix
Example of Adding Nonstandard ICDSN Information to RECON . . . . . 301

Chapter 15. RESET Command . . . . . . . . . . . . . . . . . . 303

RESET.GSG . . . . . . . . . . . . . . . . . . . . . . . . . 303
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 303
Example of the RESET.GSG Command . . . . . . . . . . . . . . 304

Part 3. Appendixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

Appendix A. Introduction . . . . . . . . . . . . . . . . . . . . 307

Appendix B. Understanding Skeletal JCL . . . . . . . . . . . . . . 309

Using the Commands to Generate JCL and User-Defined Output . . . . . . 309
Using IBM-Supplied Skeletal JCL. . . . . . . . . . . . . . . . . . 310
Writing Your Own Skeletal JCL . . . . . . . . . . . . . . . . . . 310
Understanding the Skeletal JCL Data Set. . . . . . . . . . . . . . . 310
Understanding Skeletal JCL Syntax . . . . . . . . . . . . . . . . . 311
Understanding Simple Keywords . . . . . . . . . . . . . . . . . 311
Using Control Keywords . . . . . . . . . . . . . . . . . . . . 313
Writing Control Keywords . . . . . . . . . . . . . . . . . . . 320
Understanding Skeletal JCL Default Members . . . . . . . . . . . . 329
Understanding the Symbolic Keywords Recognized by DBRC . . . . . . . 331
All Supported Utilities . . . . . . . . . . . . . . . . . . . . . 331
Log Archive Utility (ARCHJCL). . . . . . . . . . . . . . . . . . 332
Database Change Accumulation Utility (CAJCL) . . . . . . . . . . . 333
Log Recovery Utility (LOGCLJCL) . . . . . . . . . . . . . . . . 334
Database Image Copy Utility, Database Image Copy Utility 2, and Online
Database Image Copy Utility (ICJCL and OICJCL) . . . . . . . . . 335
Database Recovery Utility- Receive (ICRCVJCL) . . . . . . . . . . . 336
Database Recovery Utility-Recover (RECOVJCL) . . . . . . . . . . . 338
Understanding the IBM-Supplied Skeletal JCL Execution Members . . . . 340

Appendix C. Sample Listings of RECONs. . . . . . . . . . . . . . 367

Sample Listing of LIST.HISTORY Output . . . . . . . . . . . . . . . 368
Sample Listing of a RECON at the Active Site . . . . . . . . . . . . . 373
RECON Status Record . . . . . . . . . . . . . . . . . . . . 374
Log Records . . . . . . . . . . . . . . . . . . . . . . . . 375
GSG Record . . . . . . . . . . . . . . . . . . . . . . . . 382
SSYS Record . . . . . . . . . . . . . . . . . . . . . . . . 383
BACKOUT Record . . . . . . . . . . . . . . . . . . . . . . 383
CAGRP and CA Records. . . . . . . . . . . . . . . . . . . . 384
DBGRP, DBDSGRP, and RECOVGRP Records . . . . . . . . . . . 385
DB (IMS) and Related Records . . . . . . . . . . . . . . . . . 386
DB (HALDB and PART) and Related Records . . . . . . . . . . . . 388
DB (FP) and Related Records . . . . . . . . . . . . . . . . . . 400
Sample Listing of a RECON at the Tracking Site . . . . . . . . . . . . 401
RECON Status Record . . . . . . . . . . . . . . . . . . . . 401
Log Records . . . . . . . . . . . . . . . . . . . . . . . . 402
GSG Record . . . . . . . . . . . . . . . . . . . . . . . . 407
SSYS Record . . . . . . . . . . . . . . . . . . . . . . . . 408
BACKOUT Record . . . . . . . . . . . . . . . . . . . . . . 408
CAGRP and CA Records. . . . . . . . . . . . . . . . . . . . 409
DBDSGRP Records . . . . . . . . . . . . . . . . . . . . . 410
DB (IMS) and Related Records . . . . . . . . . . . . . . . . . 410
DB (FP) and Related Records . . . . . . . . . . . . . . . . . . 411
IMS DB Records . . . . . . . . . . . . . . . . . . . . . . . 412

x DBRC Guide & Reference

Fields Present in a Listing of a RECON by Record Type . . . . . . . . . 416
Fields Present in a RECON Record . . . . . . . . . . . . . . . . 417
Fields Present in a THT Record . . . . . . . . . . . . . . . . . 420
Fields Present in a Log Record . . . . . . . . . . . . . . . . . 421
Fields Present in a LOGALL Record . . . . . . . . . . . . . . . 423
Fields Present in an Online Log Record . . . . . . . . . . . . . . 423
Fields Present in a GSG Record . . . . . . . . . . . . . . . . . 427
Fields Present in a SSYS Record . . . . . . . . . . . . . . . . 428
Fields Present in a BACKOUT Record . . . . . . . . . . . . . . . 429
Fields Present in a CAGRP Record . . . . . . . . . . . . . . . . 430
Fields Present in a CA Record. . . . . . . . . . . . . . . . . . 431
Fields Present in a Data Group Record . . . . . . . . . . . . . . 433
Fields Present in a DB (IMS) Record . . . . . . . . . . . . . . . 434
Fields Present in a DB (HALDB) Record . . . . . . . . . . . . . . 436
Fields Present in a DB (PART) and Related Records . . . . . . . . . 437
Fields Present in a DB (Fast Path) Record . . . . . . . . . . . . . 440
Fields Present in a DBDS (non-Fast Path) Record . . . . . . . . . . 441
Fields Present in a DBDS (Fast Path) Record . . . . . . . . . . . . 443
Fields Present in an ALLOC Record . . . . . . . . . . . . . . . 447
Fields Present in an IMAGE Record . . . . . . . . . . . . . . . 448
Fields Present in a REORG Record . . . . . . . . . . . . . . . . 450
Fields Present in a RECOV Record . . . . . . . . . . . . . . . . 451

Appendix D. Considering IMS DBRC RECON Data Set Placement . . . . 453

Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . 455
IMS Version 7 Library . . . . . . . . . . . . . . . . . . . . . . 455

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457

Contents xi
xii DBRC Guide & Reference
Figures
1. IMS Database Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2. DBRC JCL Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3. DBRC’s Role in Utility Execution . . . . . . . . . . . . . . . . . . . . . . . . . 15
4. DBRC’s Specific Place in a Utility Input Scheme. . . . . . . . . . . . . . . . . . . . 16
5. Making a Backup Copy with HISAM Unload . . . . . . . . . . . . . . . . . . . . . 31
6. What Change Accumulation Does with Data from Divergent Data Streams . . . . . . . . . 34
7. Non-Concurrent Data Set Update Information in Logs: Change Accumulation Not Required 35
8. Concurrent or Overlapping Data Set Update Information in Logs: Change Accumulation Required 36
9. RECON Three-Data-Set Scheme . . . . . . . . . . . . . . . . . . . . . . . . . 45
10. Events Affecting PRILOG Records . . . . . . . . . . . . . . . . . . . . . . . . 54
11. RECON Record Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
12. DBRC DL/I Records. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
13. RECON Record Structure for a HALDB . . . . . . . . . . . . . . . . . . . . . . 60
14. DBRC Fast Path Database Records. . . . . . . . . . . . . . . . . . . . . . . . 62
15. RECON Upgrade Utility Input and Output . . . . . . . . . . . . . . . . . . . . . . 73
16. Database Requirements for the DBRC . . . . . . . . . . . . . . . . . . . . . . . 75
17. Inputs and outputs of the DBRC Utility . . . . . . . . . . . . . . . . . . . . . . . 76
18. Skeletal JCL Data Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
19. How Simple Keyword Values Are Set . . . . . . . . . . . . . . . . . . . . . . . 313
20. IBM-Supplied Skeletal JCL for the Log Archive Utility . . . . . . . . . . . . . . . . . 341
21. IBM-Supplied Skeletal JCL for the Database Change Accumulation Utility . . . . . . . . . 347
22. IBM-Supplied Skeletal JCL for the Log Recovery Utility . . . . . . . . . . . . . . . . 350
23. IBM-Supplied Skeletal JCL for the Database Image Copy Utility . . . . . . . . . . . . . 352
24. IBM-Supplied Skeletal JCL for the Online Database Image Copy Utility . . . . . . . . . . 355
25. IBM-Supplied Skeletal JCL for the Database Recovery Utility . . . . . . . . . . . . . . 357
26. IBM-Supplied Skeletal JCL for the Database Recovery Utility . . . . . . . . . . . . . . 359
27. IBM-Supplied Skeletal JCL for the HALDB Index/ILDS Rebuild Utility . . . . . . . . . . . 365
28. Sample LIST.HISTORY Output . . . . . . . . . . . . . . . . . . . . . . . . . 369
29. Sample Listing of a RECON at the Active Site - RECON Status . . . . . . . . . . . . . 374
30. Sample Listing of a RECON at the Active Site - Log Records . . . . . . . . . . . . . . 375
31. Sample Listing of a RECON at the Active Site - GSG Record . . . . . . . . . . . . . . 382
32. Sample Listing of a RECON at the Active Site - SSYS Record . . . . . . . . . . . . . 383
33. Sample Listing of a RECON at the Active Site - BACKOUT Record . . . . . . . . . . . . 383
34. Sample Listing of a RECON at the Active Site - CAGRP and CA Records . . . . . . . . . 384
35. Sample Listing of a RECON at the Active Site - DBGRP, DBDSGRP, and RECOVGRP Records 385
36. Sample Listing of a RECON at the Active Site - DB (IMS) and Related Records . . . . . . . 386
37. Sample Listing of a RECON at the Active Site - DB (FP) and Related Records . . . . . . . 400
38. Sample Listing of a RECON at the Tracking Site - RECON Status Record . . . . . . . . . 401
39. Sample Listing of a RECON at the Tracking Site - Log Records . . . . . . . . . . . . . 402
40. Sample Listing of a RECON at the Tracking Site - GSG Record . . . . . . . . . . . . . 407
41. Sample Listing of a RECON at the Tracking Site - SSYS Record. . . . . . . . . . . . . 408
42. Sample Listing of a RECON at the Tracking Site - BACKOUT Record . . . . . . . . . . . 408
43. Sample Listing of a RECON at the Tracking Site - CAGRP and CA Records . . . . . . . . 409
44. Sample Listing of a RECON at the Tracking Site - DBDSGRP Records . . . . . . . . . . 410
45. Sample Listing of a RECON at the Tracking Site - DB (IMS) and Related Records . . . . . . 410
46. Sample Listing of a RECON at the Tracking Site - DB (FP) and Related Records. . . . . . . 411
47. Sample Listing of a RECON at the Tracking Site - More IMS DB Records . . . . . . . . . 412

© Copyright IBM Corp. 1974, 2001 xiii

xiv DBRC Guide & Reference
Tables
1. Results of GENJCL.IC Processing when GENMAX and RECOVPD are Specified with REUSE 30
2. Results of GENJCL.IC Processing when GENMAX and RECOVPD are Specified with NOREUSE 30
3. RECON Records of Variable Size. . . . . . . . . . . . . . . . . . . . . . . . . 51
4. Determining Which RECONs Are Accessed . . . . . . . . . . . . . . . . . . . . . 55
5. Parameters of NOTIFY.PRILOG (for OLDS) Command for Open, Switch, and Close . . . . . 271
6. Parameters of NOTIFY.PRILOG (for RLDS) Command for Open, EOV, and Close . . . . . . 275
7. Parameters of NOTIFY.PRILOG (SLDS or TSLDS) Command for Open, EOV, and Close 280
8. Parameters of NOTIFY.SECLOG (for OLDS) Command for Open, Switch, and Close . . . . . 289
9. Parameters of NOTIFY.SECLOG (for RLDS) Command for Open, EOV, and Close . . . . . . 292
10. Parameters of NOTIFY.SECLOG (for SLDS or TSLDS) Command for Open, EOV, and Close 295
11. What the GENJCL Commands Do . . . . . . . . . . . . . . . . . . . . . . . . 309
12. Records That Can Be Selected Using the %SELECT Keyword . . . . . . . . . . . . . 315
13. Symbolic Keywords in Skeletal JCL . . . . . . . . . . . . . . . . . . . . . . . 331
14. Symbolic Keywords for Log Archive Utility . . . . . . . . . . . . . . . . . . . . . 332
15. Symbolic Keywords for Database Change Accumulation Utility . . . . . . . . . . . . . 333
16. Symbolic Keywords for Log Recovery Utility . . . . . . . . . . . . . . . . . . . . 334
17. Symbolic Keywords for Database Image Copy and Online Database Image Copy Utility . . . . 335
18. Symbolic Keywords for Database Recovery Utility . . . . . . . . . . . . . . . . . . 336
19. Symbolic Keywords for Database Recovery Utility . . . . . . . . . . . . . . . . . . 338
20. Fields Present in the RECON Record . . . . . . . . . . . . . . . . . . . . . . . 417
21. Fields Present in the THT Record . . . . . . . . . . . . . . . . . . . . . . . . 420
22. Fields Present in a Log Record . . . . . . . . . . . . . . . . . . . . . . . . . 421
23. Fields Present in the LOGALL Record . . . . . . . . . . . . . . . . . . . . . . 423
24. Fields Present in an Online Log Record . . . . . . . . . . . . . . . . . . . . . . 423
25. Fields Present in a GSG Record . . . . . . . . . . . . . . . . . . . . . . . . 427
26. Fields Present in a SSYS Record . . . . . . . . . . . . . . . . . . . . . . . . 428
27. Fields Present in a BACKOUT Record . . . . . . . . . . . . . . . . . . . . . . 429
28. Fields Present in a CAGRP Record . . . . . . . . . . . . . . . . . . . . . . . 430
29. Fields Present in a CA Record . . . . . . . . . . . . . . . . . . . . . . . . . 431
30. Fields Present in the DBDSGRP Record. . . . . . . . . . . . . . . . . . . . . . 433
31. Fields Present in the DB (IMS) Record . . . . . . . . . . . . . . . . . . . . . . 434
32. Fields Present in the DB (HALDB) Record . . . . . . . . . . . . . . . . . . . . . 436
33. Fields Present in the DB (PART) Record . . . . . . . . . . . . . . . . . . . . . 437
34. Fields Present in the DB (Fast Path) Record . . . . . . . . . . . . . . . . . . . . 440
35. Fields Present in the DBDS (non-Fast Path) Record . . . . . . . . . . . . . . . . . 441
36. Fields Present in the DBDS (Fast Path) Record . . . . . . . . . . . . . . . . . . . 443
37. Fields Present in the ALLOC Record . . . . . . . . . . . . . . . . . . . . . . . 447
38. Fields Present in the IMAGE Record . . . . . . . . . . . . . . . . . . . . . . . 448
39. Fields Present in the REORG Record. . . . . . . . . . . . . . . . . . . . . . . 450
40. Fields Present in the RECOV Record . . . . . . . . . . . . . . . . . . . . . . . 451

© Copyright IBM Corp. 1974, 2001 xv

xvi DBRC Guide & Reference
Notices
This information was developed for products and services offered in the U.S.A. IBM
may not offer the products, services, or features discussed in this document in other
countries. Consult your local IBM representative for information on the products and
services currently available in your area. Any reference to an IBM product, program,
or service is not intended to state or imply that only that IBM product, program, or
service may be used. Any functionally equivalent product, program, or service that
does not infringe any IBM intellectual property right may be used instead. However,
it is the user’s responsibility to evaluate and verify the operation of any non-IBM
product, program, or service.

IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you any
license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this statement may not apply to
you.

This information could include technical inaccuracies or typographical errors.

Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements and/or
changes in the product(s) and/or the program(s) described in this publication at any
time without notice.

Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those
Web sites. The materials at those Web sites are not part of the materials for this
IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes
appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of
enabling: (i) the exchange of information between independently created programs

© Copyright IBM Corp. 1974, 2001 xvii

and other programs (including this one) and (ii) the mutual use of the information
which has been exchanged, should contact:
IBM Corporation
J74/G4
555 Bailey Avenue
P.O. Box 49023
San Jose, CA 95161-9023
U.S.A.

Such information may be available, subject to appropriate terms and conditions,

including in some cases, payment of a fee.

The licensed program described in this information and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement, or any equivalent agreement
between us.

Any performance data contained herein was determined in a controlled

environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurement may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those
products, their published announcements or other publicly available sources. IBM
has not tested those products and cannot confirm the accuracy of performance,
compatibility or any other claims related to non-IBM products. Questions on the
capabilities of non-IBM products should be addressed to the suppliers of those
products.

All statements regarding IBM’s future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.

This information is for planning purposes only. The information herein is subject to
change before the products described become available.

This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.

This information contains sample application programs in source language, which

illustrates programming techniques on various operating platforms. You may copy,
modify, and distribute these sample programs in any form without payment to IBM,
for the purposes of developing, using, marketing or distributing application programs
conforming to the application programming interface for the operating platform for
which the sample programs are written. These examples have not been thoroughly
tested under all conditions. IBM, therefore, cannot guarantee or imply reliability,
serviceability, or function of these programs. You may copy, modify, and distribute

xviii DBRC Guide & Reference

these sample programs in any form without payment to IBM for the purposes of
developing, using, marketing, or distributing application programs conforming to
IBM’s application programming interfaces.

Each copy or any portion of these sample programs or any derivative work, must
include a copyright notice as follows:

© (your company name) (year). Portions of this code are derived from IBM Corp.
Sample Programs. © Copyright IBM Corp. _enter the year or years_. All rights
reserved.

If you are viewing this information softcopy, the photographs and color illustrations
may not appear.

Trademarks
The following terms are trademarks of the IBM Corporation in the United States or
other countries or both:

BookManager IBM
CICS IMS
CICS/ESA IMS/ESA
DB2 MVS
DFSMS MVS/ESA

Product Names
In this book, the licensed program “DB2 for MVS/ESA” is referred to as “DB2”.

Other company, product, and service names, which may be denoted by a double
asterisk (**), may be trademarks or service marks of others.

Notices xix
xx DBRC Guide & Reference
Preface
This book describes the administrative and operational tasks associated with the
IMS Database Recovery Control facility (DBRC). DBRC provides tools for tracking
information used during database recovery. This book is for system and database
administrators who are responsible for design, operation, and recovery procedures
for their installation.

Prerequisite Knowledge
IBM offers a wide variety of classroom and self-study courses to help you learn
IMS. For a complete list of courses available, refer to the “How to Learn IMS”
section of General Information from the Library page of the IMS home page on the
Web: http://www.ibm.com/ims.

Before using this book, you should understand:

v Basic IMS concepts
v The IMS environment
v Your installation’s IMS system
v Administration of the IMS system and databases
v MVS control programs
v VSAM file structure and VSAM Access Method Services (AMS)

How to Use This Book

This book is structured as both a guide and reference. You can read “Part 1. How to
Use DBRC” on page 1 to familiarize yourself with how to use DBRC and the DBRC
utilities. Then you can use “Part 2. Command Reference” on page 93 as a reference
for syntax and usage of the DBRC commands. The appendixes provide additional
reference material.

How to Read the Syntax Diagrams

For details, see “How to Read the Syntax Diagrams” on page 107.

Related Reading
The following books in the IMS library contain information related to DBRC.
v For definitions of terminology used in this manual and references to related
information in other manuals:
– IMS Version 7 Master Index and Glossary
v For more information on upgrading the RECON from previous releases of IMS:
– IMS Version 7 Release Planning Guide
v For installation and initialization topics:
– IMS Version 7 Installation Volume 1: Installation and Verification
– IMS Version 7 Installation Volume 2: System Definition and Tailoring
v For information on database and system administration:
IMS Version 7 Administration Guide: Database Manager
IMS Version 7 Administration Guide: System
v For information on operating procedures:

© Copyright IBM Corp. 1974, 2001 xxi

IMS Version 7 Operations Guide
v For information on system utilities:
IMS Version 7 Utilities Reference: System
v For information on the utilities used in database recovery:
IMS Version 7 Utilities Reference: Database and Transaction Manager
v For information on the RECON I/O exit:
IMS Version 7 Customization Guide
v For diagnostic information and messages:
IMS Version 7 Diagnosis Guide and Reference
IMS Version 7 Messages and Codes, Volume 1

How to Send Your Comments

Your feedback is important in helping us provide the most accurate and highest
quality information. If you have any comments about this book or any other IMS
documentation, you can do one of the following:
v Go to the IMS home page at: http://www.ibm.com/ims. There you will find an
online feedback page where you can enter and submit comments.
v Send your comments by e-mail to [email protected]. Be sure to include the
name of the book, the part number of the book, the version of IMS, and, if
applicable, the specific location of the text you are commenting on (for example,
a page number or table number).
v Fill out one of the forms at the back of this book and return it by mail, by fax, or
by giving it to an IBM representative.

xxii DBRC Guide & Reference

Summary of Changes
| Changes to The Current Edition of This Book for IMS Version 7
| This edition includes technical and editorial changes.

| New information in the following sections is included:

| v “Registering Databases and Database Data Sets” on page 12
| v “DELETE.DB” on page 174
| v “DELETE.DBDS” on page 175
| v “INIT.DB” on page 225
| v “INIT.DBDS” on page 227
| v “INIT.DBDSGRP” on page 231
| v “INIT.PART” on page 235
|
Changes to This Book for IMS Version 7
This book contains new technical information for Version 7, as well as editorial
changes.

New information on the following enhancements is also included:

v HALDB (High Availability Large Database)
v Concurrent RECON upgrade from DBRC Version 6 to DBRC Version 7
v Large RECON record support
v RECON loss notification
v RECON performance improvement
v Image Copy GENMAX processing
v DBRC serviceability enhancements
v DBRC support for PROCOPT=L

Library Changes for IMS Version 7

| The major change to the IMS Version 7 library is that it is available not only in
| hardcopy and in softcopy on BookManager, but also in softcopy Portable Document
| Format (PDF). The complete library is available in BookManager and PDF on the
| IMS Version 7 product kit CD-ROM (LK3T-3526). The unlicensed IMS Version 7
| softcopy library is available on the Transaction Processing and Data CD-ROM
| (SK2T-0730) and the OS/390 Collection CD-ROM (SK2T-6700) in BookManager.
| The unlicensed IMS Version 7 softcopy library is available in BookManager and
| PDF on the Web at http://www.ibm.com/ims

Other changes include changes to these following books:

v IMS Version 7 Common Queue Server and Base Primitive Environment Guide
and Reference
The book formerly titled IMS/ESA Common Queue Server Guide and Reference
in the Version 6 library is called IMS Version 7 Common Queue Server and Base
Primitive Environment Guide and Reference.
The IMS Version 7 Common Queue Server and Base Primitive Environment
Guide and Reference is divided into two parts: ″Part 1: Common Queue Server,″
and ″Part 2: Base Primitive Environment.″

© Copyright IBM Corp. 1974, 2001 xxiii

The IMS Version 7 Common Queue Server and Base Primitive Environment
Guide and Reference is now an unlicensed book.
v IMS Version 7 Command Reference
The book formerly titled IMS/ESA Operator’s Reference in the Version 6 library is
called IMS Version 7 Command Reference.
v IMS Version 7 Utilities Reference: Database and Transaction Manager
The books formerly titled IMS/ESA Utilities Reference: Database Manager and
IMS/ESA Utilities Reference: Transaction Manager in the Version 6 library have
been combined into one book called IMS Version 7 Utilities Reference: Database
and Transaction Manager.
v IMS Version 7 Application Programming: Database Manager and IMS Version 7
Customization Guide
The chapter titled ″IMS Adapter for REXX Exit Routine″ has been moved from
the IMS Version 7 Application Programming: Database Manager to the IMS
Version 7 Customization Guide.
v IMS Version 7 Sample Operating Procedures
For IMS Version 7, this book is available only in BookManager and PDF softcopy
on the product kit (LK3T-3526), the OS/390 Collection CD-ROM (SK2T-6700),
and on the Web at: http://www.ibm.com/ims

| The library includes a new book: IMS Version 7 IMS Java User’s Guide (IJUG). As
| a new book, the IJUG is available only in PDF softcopy on the product kit
| (LK3T-3526) and on the Web at: http://www.ibm.com/ims

xxiv DBRC Guide & Reference

Part 1. How to Use DBRC
Chapter 1. DBRC in the IMS Database Recovery Process . . . . . . . . 5
What Is DBRC? . . . . . . . . . . . . . . . . . . . . . . . . . 5
DBRC Tasks . . . . . . . . . . . . . . . . . . . . . . . . . 6
DBRC Components . . . . . . . . . . . . . . . . . . . . . . 6
RECONs . . . . . . . . . . . . . . . . . . . . . . . . . 6
Database Recovery Control Utility (DSPURX00) . . . . . . . . . . . 7
Skeletal JCL . . . . . . . . . . . . . . . . . . . . . . . . 7
RECON Upgrade Utility (DSPURU00) . . . . . . . . . . . . . . . 7
IMS Recovery utilities and functions . . . . . . . . . . . . . . . . 7
Recording Recovery-Related Information . . . . . . . . . . . . . . . 8
Generating JCL . . . . . . . . . . . . . . . . . . . . . . . . 8
When Should You Use DBRC? . . . . . . . . . . . . . . . . . . . 10
Initializing DBRC . . . . . . . . . . . . . . . . . . . . . . . . 10
Specifying When DBRC Is to Be Used . . . . . . . . . . . . . . . 10
The IMSCTRL Macro . . . . . . . . . . . . . . . . . . . . 10
IMS.PROCLIB Execution-Parameter Members . . . . . . . . . . . 11
IMS Procedures and DBRC . . . . . . . . . . . . . . . . . . 11
DBRC Procedure . . . . . . . . . . . . . . . . . . . . . . 11
Initializing the RECON . . . . . . . . . . . . . . . . . . . . 11
Registering Databases and Database Data Sets . . . . . . . . . . . 12
Considerations for Using DBRC. . . . . . . . . . . . . . . . . . 12
DBRC Functions . . . . . . . . . . . . . . . . . . . . . . . 13
Using DBRC to Record Log Information. . . . . . . . . . . . . . 13
Using DBRC for Database Recovery . . . . . . . . . . . . . . . 14
Using DBRC for Data Sharing . . . . . . . . . . . . . . . . . 20
Data Set Naming Conventions . . . . . . . . . . . . . . . . . . 21
Naming Convention for Image Copy Data Sets . . . . . . . . . . . 21
Naming Convention for Duplicate Image Copy Data Sets . . . . . . . 22
Naming Convention for Change Accumulation Data Sets . . . . . . . 22
DBRC Support for Remote Site Recovery . . . . . . . . . . . . . . 22

Chapter 2. Considerations for a DBRC System . . . . . . . . . . . . 25

Database Backup Copies . . . . . . . . . . . . . . . . . . . . . 25
The Image Copy Utilities (DFSUDMP0, DFSUICP0, DFSUDMT0) . . . . . 26
Database Image Copy (DFSUDMP0) . . . . . . . . . . . . . . . . 27
Database Image Copy 2 (DFSUDMT0) . . . . . . . . . . . . . . . 27
Online Database Image Copy (DFSUICP0) . . . . . . . . . . . . . 28
Concurrent Image Copy . . . . . . . . . . . . . . . . . . . . 28
Creating Image Copy Data Sets for Future Use and Reuse . . . . . . . 29
Controlling the Number of Image Copies Managed. . . . . . . . . . . 29
Recovery Period of Image Copy Data Sets and GENMAX . . . . . . . . 30
Reusing Image Copy Data Sets. . . . . . . . . . . . . . . . . . 30
HISAM Copies (DFSURUL0 and DFSURRL0) . . . . . . . . . . . . 31
Nonstandard Image Copy Data Sets . . . . . . . . . . . . . . . . 32
Frequency and Retention . . . . . . . . . . . . . . . . . . . . 32
Log Record Change Accumulation . . . . . . . . . . . . . . . . . . 33
Condensing the Accumulated SLDS or RLDS (Change Accumulation). . . . 33
When Is Change Accumulation Required? . . . . . . . . . . . . . . 35
Input to the Database Change Accumulation Utility. . . . . . . . . . 36
Change Accumulation Groups . . . . . . . . . . . . . . . . . 37
Defining Change Accumulation Data Sets for Future Use . . . . . . . 37
Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
The Database Recovery Process . . . . . . . . . . . . . . . . . 38

© Copyright IBM Corp. 1974, 2001 1

How DBRC Helps in Recovery . . . . . . . . . . . . . . . . . . 39
Generating Recovery JCL . . . . . . . . . . . . . . . . . . . 39
Validating Utility JCL . . . . . . . . . . . . . . . . . . . . . 39
Recording the Result. . . . . . . . . . . . . . . . . . . . . 39
Planning Recovery Procedures . . . . . . . . . . . . . . . . . . 39
Setting Up Recovery Mechanisms . . . . . . . . . . . . . . . . . 39
Recovery Facilities . . . . . . . . . . . . . . . . . . . . . . 40
Dynamic Backout . . . . . . . . . . . . . . . . . . . . . . 40
Batch Support . . . . . . . . . . . . . . . . . . . . . . . 40
Limitations of DBRC Backout Support . . . . . . . . . . . . . . 41
Forward Recovery. . . . . . . . . . . . . . . . . . . . . . 41
Recovery without DBRC . . . . . . . . . . . . . . . . . . . . 42
Restart after IMS Failure . . . . . . . . . . . . . . . . . . . . 42
Restart after DBRC Failure . . . . . . . . . . . . . . . . . . . 42
Recovery Involving IRLM Configurations . . . . . . . . . . . . . . 42
Batch Backout . . . . . . . . . . . . . . . . . . . . . . . . 43
Archiving Log Records . . . . . . . . . . . . . . . . . . . . . 43

Chapter 3. Initializing and Maintaining the RECON . . . . . . . . . . 45

Planning Considerations for the RECON . . . . . . . . . . . . . . . 46
First-Time Users . . . . . . . . . . . . . . . . . . . . . . . 46
Avoiding RECON Contention Problems . . . . . . . . . . . . . . . 46
Avoiding RECON Deadlock . . . . . . . . . . . . . . . . . . 47
RECON Serialization. . . . . . . . . . . . . . . . . . . . . 47
Allocating the RECONs . . . . . . . . . . . . . . . . . . . . 49
Avoiding RECON Space Problems . . . . . . . . . . . . . . . 50
Creating a RECON . . . . . . . . . . . . . . . . . . . . . 50
Variable Size RECON Records . . . . . . . . . . . . . . . . . 51
Security Considerations for RECON . . . . . . . . . . . . . . . 54
Initial RECON Access . . . . . . . . . . . . . . . . . . . . . 54
Records in the RECON . . . . . . . . . . . . . . . . . . . . . 55
RECON Header Records . . . . . . . . . . . . . . . . . . . 56
Log Data Set Records . . . . . . . . . . . . . . . . . . . . 56
Database Recovery Records . . . . . . . . . . . . . . . . . . 57
Maintaining the RECONs . . . . . . . . . . . . . . . . . . . . 64
Backing Up RECON . . . . . . . . . . . . . . . . . . . . . 64
Deleting Unnecessary RECON Log Records . . . . . . . . . . . . 65
Reorganizing RECON . . . . . . . . . . . . . . . . . . . . 66
RECON Reorganization Procedure . . . . . . . . . . . . . . . 67
Replacing Damaged RECONs . . . . . . . . . . . . . . . . . 67
Recovering the RECON . . . . . . . . . . . . . . . . . . . 68
Replacing a Discarded RECON . . . . . . . . . . . . . . . . . 69

Chapter 4. RECON Upgrade Utility (DSPURU00) . . . . . . . . . . . 71

Chapter 5. Database Recovery Control Utility (DSPURX00) . . . . . . . 75

What Is the Database Recovery Control Utility (DSPURX00)? . . . . . . . 75
Input and Output . . . . . . . . . . . . . . . . . . . . . . . . 75
Example of DBRC Utility JCL . . . . . . . . . . . . . . . . . . . 76

2 DBRC Guide & Reference

JCL Requirements . . . . . . . . . . . . . . . . . . . . . . . 76

Chapter 6. Hints and Tips for DBRC . . . . . . . . . . . . . . . . 79

Part 1. How to Use DBRC 3

4 DBRC Guide & Reference
Chapter 1. DBRC in the IMS Database Recovery Process
This chapter provides an overview of the IMS database recovery process and then
describes DBRC’s (IMS Database Recovery Control facility) role in that process.

In This Chapter:
v “What Is DBRC?”
v “When Should You Use DBRC?” on page 10
v “Initializing DBRC” on page 10
v “Registering Databases and Database Data Sets” on page 12
v “Considerations for Using DBRC” on page 12
v “DBRC Functions” on page 13
v “Data Set Naming Conventions” on page 21
v “DBRC Support for Remote Site Recovery” on page 22

What Is DBRC?
DBRC helps you control log and database recovery. It also controls the data
sharing environment by allowing (or preventing) access to databases by various
IMS subsystems sharing those databases.

The recovery process for IMS databases can include these three basic steps,
although the details of the process can vary with the type of database to be
recovered:
1. Restore the database to the most current image copy.
2. Use the log data sets (or change accumulation data sets) to restore changes
made to the database since the image copy was made.
3. Back out any incomplete changes.
Figure 1 illustrates a simple database recovery.

Figure 1. IMS Database Recovery

Information for a database recovery can come from any or all of the following
sources:
v Image copies of the database
v Database reorganization data sets

© Copyright IBM Corp. 1974, 2001 5

DBRC and Database Recovery
v Log data sets (SLDSs and RLDSs) 1

v Change accumulation data sets

You can use DBRC to track all of these information sources, greatly simplifying the
task of database recovery.

Related Reading: Refer to IMS Version 7 Operations Guide for more information
on recovery.

DBRC Tasks
DBRC is responsible for the following tasks:
1. This first group of tasks are those performed automatically through the
interaction of DBRC and IMS (including utilities):
v Controlling logs for IMS
v Recording recovery information in the RECON
v Verifying that database utilities have the correct input
v Controlling the recovery of registered databases
v Controlling the data sharing environment by maintaining authorization
information for the control and serialization of access to shared databases
2. These tasks are performed when you request them by passing commands to
DBRC:
v Recording recovery information in the RECON
v Generating JCL for various IMS utilities and generating user-defined output
(Use GENJCL commands to perform these operations.)
v Listing the information in the RECONs; use LISTcommands to list this
information

Related Reading:
v See “Using DBRC to Record Log Information” on page 13 for additional
information about DBRC’s logging support.
v See “Using DBRC for Data Sharing” on page 20 for additional information about
DBRC’s data sharing support.

DBRC Components
DBRC includes the following components which are discussed in this section:
v RECONs
v Database Recovery Control utility (DSPURX00)
v Skeletal JCL
v RECON Upgrade utility (DSPURU00)

RECONs
DBRC stores recovery-related information in a set of VSAM KSDSs called the
RECON (REcovery CONtrol) data sets.

Three RECONs should be defined when you install DBRC. The first two RECONs
are active data sets, the third one is a spare. The second active data set is a copy
of the first. For most purposes, you can think of the two active RECONs as if they
were a single data set, the RECON, or simply RECON.

1. system log data set (SLDS), recovery log data set (RLDS)

6 DBRC Guide & Reference

DBRC and Database Recovery
Related Reading: These data sets are described in detail in “Chapter 3. Initializing
and Maintaining the RECON” on page 45.

Database Recovery Control Utility (DSPURX00)

This utility provides a set of commands that allow you to specify the type of
information that is tracked for your IMS databases.

The DBRC commands allow you to perform all of the following tasks:
v List the information in RECON
v Update the information in RECON
v Use the information in RECON to generate jobs for the IMS utilities

Skeletal JCL
DBRC also uses partitioned data set (PDS) members that contain skeletal JCL.

DBRC uses the skeletal JCL to generate the JCL and control statements that are
needed in order to run some of the recovery utilities. These PDS members are
distributed with DBRC. You must make any changes to the PDS members that are
necessary for your installation’s system configuration.

RECON Upgrade Utility (DSPURU00)

This utility allows you to migrate the RECON from previous releases of IMS to the
current release.

Related Reading:
v “Chapter 4. RECON Upgrade Utility (DSPURU00)” on page 71 describes
DSPURU00.
v “Chapter 5. Database Recovery Control Utility (DSPURX00)” on page 75
describes DSPURX00.
v “Chapter 11. GENJCL Commands” on page 185 and “Appendix B. Understanding
Skeletal JCL” on page 309 contain information on generating and using skeletal
JCL.

IMS Recovery utilities and functions

Recovery utilities is a generic term for the following IMS utilities:
v Online Recovery Service (ORS)
v Database Change Accumulation (DFSUCUM0)
v Database Image Copy (DFSUDMP0)
v Database Image Copy 2 (DFSUDMT0)
v Online Database Image Copy (DFSUICP0)
v Batch Backout (DFSBBO00)
v Database Recovery (DFSURDB0)
v Log Archive (DFSUARC0)
v Log Recovery (DFSULTR0)

The data sets used by these utilities and recorded in the RECONs are image copy,
change accumulation, and log data sets. Other recovery-related information
recorded in RECON includes information about:
v Using IMS databases (for example, which IMS subsystems are using which
databases at any given time)
v Recovering database data sets (DBDSs)
v Reorganizing databases

Chapter 1. DBRC and Database Recovery 7

DBRC and Database Recovery
Recording Recovery-Related Information
DBRC automatically records information in RECON on the status of log data sets
for online subsystems. This includes the OLDS, the SLDS, and the RLDS that are
produced by the Log Archive utility. If you specify that DBRC be invoked for batch
jobs, DBRC also records the status of the batch SLDS in RECON.

The information recorded for each log data set includes the data set name, volume
serial numbers, start and stop times, and status. DBRC records the archiving of
OLDS data sets, as well as the creation of the corresponding SLDSs and RLDSs. It
also records information about execution of the Log Recovery utility.

If you want DBRC to control database recovery, you must register the databases in
RECON. DBRC then records information about when databases were updated and
about the corresponding log data sets that contain updated log records. DBRC also
records the creation of image copy and change accumulation data sets, and
records database recoveries and reorganizations that affect registered databases.

Figure 2 on page 9 shows the input DBRC uses to create JCL.

8 DBRC Guide & Reference

DBRC and Database Recovery

Figure 2. DBRC JCL Generation

DBRC installation procedures place these skeletal JCL execution members from an
IMS distribution library (IMS.SDFSISRC) into an IMS procedure library
(IMS.PROCLIB). DBRC uses these members to generate jobs (JCL and control
statements) for the IMS utilities listed in Table 11 on page 309. There is also a
skeletal JCL execution member, JOBJCL, that produces a JOB statement.

In addition, the GENJCL.USER command generates user-defined output, which can

include JCL. No skeletal JCL execution members are supplied to support the
GENJCL.USER command. If you want to enter GENJCL.USER commands, you must
supply the members to support them.

Use the GENJCL command to request that DBRC generate JCL in batch or via the
/RMGENJCL command online. When you enter this command, DBRC reads skeletal
JCL and replaces symbolic parameters (performs symbolic substitution) based on
the information recorded in RECON to build the appropriate JCL. For example, if
you request that DBRC generate JCL to recover a database, DBRC retrieves the
skeletal JCL member from the library and completes the JCL information with the
latest image copy, change accumulation, and log data sets, if necessary. Your
databases must be registered in order for DBRC to generate JCL to process them.

The GENJCL process can significantly reduce the time and manual effort required to
recover a database. It can also eliminate the causes of many recovery errors. You
could spend much time during database recoveries determining which input data
sets should be provided in what order to the Database Recovery utility. When
change accumulation or RLDS data sets are available, DBRC selects them rather
than the SLDS for recovery. This results in quicker database recoveries if you run
the Database Change Accumulation regularly. DBRC knows which log data sets are
required and ensures that IMS processes all volumes in the correct order. DBRC
also selects the most recent image copy for database recovery.

Related Reading:
v See IMS Version 7 Installation Volume 2: System Definition and Tailoring for
more information about the tailoring actions for IMS.PROCLIB members, the
DBRC procedure, and JCLOUT and JCLPDS DD statements.
v See “Appendix B. Understanding Skeletal JCL” on page 309 for details about
customizing your own skeletal JCL and about the contents of IMS supplied JCL.

Chapter 1. DBRC and Database Recovery 9

DBRC and Database Recovery

When Should You Use DBRC?

Most IMS configurations require DBRC, including:
v Online configurations: DB / DC, DCCTL, or DBCTL
v Data sharing environments, including IMS Sysplex configurations
v Configurations that use Extended Recovery Facility (XRF)
v Remote Site Recovery (RSR)

DBRC plays a key role in managing the log data needed to restart and recover IMS
online subsystems.

DBRC is not required for IMS batch jobs and for some offline utilities. However, if
batch jobs and utilities that access registered databases are allowed to run without
DBRC, the recoverability and integrity of the databases could be lost. Even if your
configuration does not require the use of DBRC (such as in a non-sharing,
non-RSR batch environment), you can simplify your recovery process by using
DBRC to supervise recovery and protect your databases.

Related Reading:
v IMS Version 7 Operations Guide provides detailed descriptions of recovery
procedures with and without DBRC.
v “Chapter 2. Considerations for a DBRC System” on page 25 further describes
how DBRC helps with database recovery.

Initializing DBRC
You initialize DBRC during IMS system generation. This section provides a brief
overview of the requirements for creating and executing a DBRC region.

Related Reading:
v Refer to IMS Version 7 Installation Volume 1: Installation and Verification and
IMS Version 7 Installation Volume 2: System Definition and Tailoring for a
complete description of IMS installation procedures and requirements.
v See “Chapter 3. Initializing and Maintaining the RECON” on page 45 for
information on creating and allocating the RECON.

Specifying When DBRC Is to Be Used

IMS online systems always use DBRC; you cannot override this.

You can choose whether IMS batch jobs use DBRC. But you must understand that
certain functions, such as data sharing, cannot be used without DBRC.

The IMSCTRL Macro

Use the DBRC= parameter to specify DBRC or no DBRC for all batch jobs. You can
also use this parameter to override DBRC=NO on all batch jobs except:
v If DBRC=FORCE is specified as the first parameter for the IMSCTRL macro,
DBRC is active for batch and online environments. DBRC=FORCE cannot be
overridden except in these instances:
– A batch backout execution of IMS
– The execution of the System Log Recovery utility
– The execution of the IMS Log Archive utility

10 DBRC Guide & Reference

DBRC and Database Recovery
v If DBRC=NO is specified (or defaulted) for the first parameter DBRC is active for
online environments only.
v If DBRC=YES is specified for the first parameter, DBRC is active for both
environments unless it is overridden on IMS procedures.

DBRC for an online IMS subsystem resides in its own address space. Use the
DBRCNM= parameter to request that IMS create a cataloged DBRC procedure. The
IMS control region initiates the DBRC address space with an MVS START command.

Copy the DBRC procedure that was created when the system was generated from
IMS.PROCLIB to SYS1.PROCLIB.

Place DBRC’s Load modules into a load library that is in the normal load library
search sequence for your IMS load modules; for example, IMS.SDFSRESL.

IMS.PROCLIB Execution-Parameter Members

You can override the DBRC procedure name specified at system generation in the
DFSPBIMS, DFSPBDBC, and DFSPBDCC members.

IMS Procedures and DBRC

The EXEC parameter, DBRC=, determines whether DBRC is used in a batch
procedure. It is ignored by an online IMS.

The DBRCNM= parameter may be used to override the DBRC procedure name for
an online IMS execution.

DBRC Procedure
IMS automatically starts the DBRC procedure with an MVS START command during
control region initialization. This procedure specifies parameters for the DBRC
region.

To include the DBRC procedure during system generation, you must copy the
skeletal procedure that IMS generates in IMS.PROCLIB to SYS1.PROCLIB. The
member name must match the name specified on the DBRCNM parameter in the
IMSCTRL macro or the applicable EXEC procedure. If DBRCNM is specified in
more than one place, or if DBRCNM is not explicitly specified, the following order of
precedence applies:
v DBRCNM=DBRC is the default.
v DBRCNM=name in the IMSCTRL macro overrides the default.
v DBRCNM=name defined in a DFSPBxxx member in IMS.PROCLIB overrides the
IMSCTRL macro setting.
v DBRCNM=name defined in a JCL EXEC parameter overrides the IMS.PROCLIB
member setting.

Related Reading: See IMS Version 7 Installation Volume 2: System Definition and
Tailoring for a complete description of the DBRC procedure and its parameters.

Initializing the RECON

Use the Access Method Services (IDCAMS) DEFINE CLUSTER command to create the
RECONs and then use the INIT.RECON command to initialize the RECONs as
RECONs usable by DBRC.

If you do not intend to register databases, the INIT.RECON command is the only
command you need to issue in order to initialize the data set.

Chapter 1. DBRC and Database Recovery 11

DBRC and Database Recovery
v See “Chapter 3. Initializing and Maintaining the RECON” on page 45 for
information on creating the RECON.
v See “Registering Databases and Database Data Sets” for information on
registering databases.
v See “Chapter 12. INIT Commands” on page 221 for information on the
INIT.RECON command.

Registering Databases and Database Data Sets

The RECON must have a DB record for each database whose recovery DBRC is to
control.

| For non-HALDBs (High Availability Large Databases), use the INIT.DB and
| INIT.DBDS commands to register databases in RECON and to define them as
| recoverable or non-recoverable. For HALDBs, you can use the INIT.DB and
| INIT.PART commands, or the HALDB Partition Definition utility.

For each database that you have registered, issue the INIT.DBDS command to
register all its data sets or DEDB areas. For DEDBs, use the INIT.ADS command to
identify the data sets within each area. An area can have up to seven area data
sets (ADSs).

| A utility job for an INIT.DB command to register a HALDB, or any INIT.DBDS

| command, must include a ddname for the IMS.DBDLIB data set that contains an
| entry for the HALDB DBD, or non-HALDB DBDS, for which you are issuing the
| command (a ddname for the IMS.DBDLIB is not needed for non-HALDB INIT.DB
| command).

Related Reading: See “Chapter 12. INIT Commands” on page 221 for specifics
about the INIT commands.

From a DBRC perspective, a HALDB consists of a HALDB master (TYPE=HALDB)

and HALDB partitions (TYPE=PART).

To update or delete information about HALDBs in the RECON data set, you must
use the HALDB Partition Definition utility. You can use the CHANGE.DB and
CHANGE.DBDS commands, with some restrictions.

Related Reading:
v See the IMS Version 7 Administration Guide: Database Manager for an overview
of HALDBs and detailed information about how to create them.
v See the IMS Version 7 Utilities Reference: Database and Transaction Manager
for information about the HALDB Partition Definition utility.
v See “Chapter 9. CHANGE Commands” on page 113 for information about the
CHANGE commands.

Considerations for Using DBRC

Be aware of the following considerations when using DBRC:
v DBRC does not support main storage databases (MSDBs).
v DBRC plays no role in the processing of GSAM databases, so there is no reason
to register them.
v Logging is required for batch jobs that use DBRC and have update access.
v Never update RECON information (such as for DBDSs or log data sets) about a
data set that is currently in use.

12 DBRC Guide & Reference

DBRC and Database Recovery
v Be sure to set the time-of-day (TOD) clock value in the host processors
accurately, or unpredictable results might occur in RECON.

DBRC Functions
After you have initialized DBRC for your installation, DBRC automatically provides
control for IMS log data sets. If you want DBRC to control the recovery of your
DBDSs, register them with DBRC. The following sections describe how DBRC
tracks and controls logs, database recovery, and data sharing.

Using DBRC to Record Log Information

DBRC automatically records information about all log data sets that are produced
by the online IMS subsystem and by log archiving jobs in the RECON. IMS uses
this information for database recovery jobs, if databases are registered, and also for
IMS restart. DBRC also tracks the archiving requirements of the online data set
(OLDS) and, if requested, generates and submits the JCL for archiving jobs.

It is not required that you use DBRC in order to control logs that are produced by
batch subsystems. However, for batch jobs that use DBRC, DBRC records all log
data sets that are produced by batch jobs and prevents any batch update job from
executing if you specify a dummy or null log data set.

Attention: If registered databases are updated without DBRC control, DBRC

cannot correctly control recovery for the databases and database integrity can be
jeopardized.

Changing RECON Log Records: You can use the CHANGE.PRILOG or

CHANGE.SECLOG commands to change the information in the RECON about OLDS,
RLDS, or SLDS records. Use these commands to indicate that errors have occurred
on the data sets or that volume serial numbers have changed. You do not normally
need to use these commands.

Archiving OLDS: Invoke the Log Archive utility to archive an OLDS to an SLDS
so that IMS can reuse the OLDS. How frequently you should archive depends on
the load on the subsystem and the number of log records written to the OLDSs.

The archive utility always produces an SLDS. The SLDS contains all log records
that are required for both database recovery and for online IMS restart.

You can ask the utility to produce an RLDS in addition to an SLDS. The RLDS
contains only those log records that are required for database recovery.

If you request an RLDS, the output RLDS data sets are recorded in the PRILOG
RECON record, and the SLDS data sets in the PRISLD record. If you do not
request an RLDS, the same SLDS data sets are recorded in both the PRILOG and
PRISLD records.

If there is a secondary OLDS, or if you request that dual logs be produced from a
single OLDS, the secondary-log output is recorded in corresponding SECLOG and
SECSLD records.

Important: Log data sets that are output from IMS batch jobs are recorded in
PRILOG / SECLOG records even though they are technically SLDSs.

Invoke the archive utility by entering the GENJCL.ARCHIVE command. DBRC then
determines which OLDSs are full, and generates the appropriate JCL.

Chapter 1. DBRC and Database Recovery 13

DBRC and Database Recovery
Related Reading: See Member DFSVSMxx in the IMS Version 7 Installation
Volume 2: System Definition and Tailoring for more information on the ARCHDEF
statement and automatic archiving.

Whether you use automatic archiving or invoke archiving yourself, you should make
sure the archive jobs run as quickly as possible. The online subsystem only reuses
an OLDS after it has been archived. If the archive job is not run and all OLDSs are
used, the online subsystem waits. One way to ensure that archive jobs run quickly
is to use an initiator that runs with a fairly high priority and is not used by many
other users. This ensures that the archive jobs do not remain on the internal reader
queue for too long.

If DBRC has marked an OLDS in RECON as having errors, the GENJCL function
does not submit it for archiving. If one of a pair of OLDSs has been destroyed or is
unavailable, you can choose to mark it in RECON as having errors.

DBRC Log Related Commands: You can use the following commands, which
perform DBRC log-related functions, in your operational procedures:

INIT.RECON DELETE.LOG LIST.LOG

CHANGE.PRILOG GENJCL.ARCHIVE NOTIFY.PRILOG
CHANGE.RECON GENJCL.CLOSE NOTIFY.SECLOG
CHANGE.SECLOG

Using DBRC for Database Recovery

If you register recoverable databases in RECON, DBRC records the association of
the databases to the log data sets containing database change records.

DBRC also records:

v Database image copies
v Reorganizations (except DEDB online reorganizations)
v Recoveries
v Change accumulations
v Backout

Because DBRC records this information in RECON, DBRC can generate JCL for
executing a database recovery. Whether you use the GENJCL commands to generate
JCL or provide the JCL yourself, DBRC uses information in the RECON to
determine exactly which data sets are required for input. The utility runs only if
DBRC verifies that the JCL is correct.

Figure 3 on page 15 shows where DBRC generally fits in utility execution.

14 DBRC Guide & Reference

DBRC and Database Recovery

Figure 3. DBRC’s Role in Utility Execution

Implement DBRC in phases, defining at first only a few recoverable databases in

RECON. This allows you to gain experience in the use of DBRC, and gives you an
opportunity to assess, make, and test any changes needed in your backup,
recovery, and operational procedures.

Using the IMS Recovery Utilities: DBRC is invoked by the following IMS utilities
and services to validate input and record the results:
v Index/ILDS Rebuild Utility (DFSPREC0)
v Database Image Copy utility (DFSUDMP0)
v Online Recovery Service (ORS)
v Database Image Copy 2 utility (DFSUDMT0)
v Online Database Image Copy utility (DFSUICP0)
v Database Change Accumulation utility (DFSUCUM0)
v Batch Backout utility (DFSBBO00)
v Database Recovery utility (DFSURDB0)
v Log Recovery utility (DFSULTR0)
v Log Archive utility (DFSUARC0)
v HD Reorganization Unload utility (DFSURGU0)
v HD Reorganization Reload utility (DFSURGL0)
v HISAM Reorganization Unload utility (DFSURUL0)
v HISAM Reorganization Reload utility (DFSURRL0)
v Database Prefix Update utility (DFSURGP0)
v DEDB Area Data Set Create utility (DBFUMRI0)

Figure 4 on page 16 shows where DBRC specifically fits in the input scheme.

Chapter 1. DBRC and Database Recovery 15

DBRC and Database Recovery

Figure 4. DBRC’s Specific Place in a Utility Input Scheme.

DBRC checks that these utilities perform the correct processing with the correct
input data sets. This is true even if you do not use the GENJCL command. DBRC
verifies the JCL for these utilities before execution.

Exception: For the HD and the HISAM reorganization utilities, DBRC only records
their execution in RECON.

DBRC always selects the optimum input for the Database Recovery utility by using
change accumulation data sets whenever possible. If you have not used the
Database Change Accumulation utility, or if that utility did not process some log
data sets, DBRC selects the required log data sets from the PRILOG (or SECLOG)
records, which can contain RLDS, SLDS, or both RLDS and SLDS entries.

The DEDB Area Data Set Create utility increases availability by providing additional
usable copies of an online area. It does not provide backup copies for recovery. The
DEDB Area Data Set Create utility uses the DBRC RECON data set as part of its
input.

DBRC verifies all logs that are input to the database Batch Backout utility
(DFSBBO00) by determining the complete set of logs that are needed for a
particular backout job. In addition, DBRC manages information about the logs so
that backout and restart jobs can be easily coordinated.

DBRC also provides unit-of-recovery management for all attached subsystems.

DBRC provides information about these units of recovery for batch backout,
dynamic backout, partial backout, and restart.

Related Reading:
v See IMS Version 7 Utilities Reference: Database and Transaction Manager for
more information on the IMS recovery utilities.
v See “NOTIFY.BKOUT” on page 264 for information about a related command,
which manually creates a backout record in RECON.

16 DBRC Guide & Reference

DBRC and Database Recovery
Specifying Image Copy Requirements: If you use a supported image copy utility,
DBRC records the image copies for registered databases. DBRC also generates
the JCL for the utility if you enter the GENJCL.IC or GENJCL.OIC command.

If you use nonstandard image copy techniques, such as a pack dump, you must
create your own JCL and update RECON with a NOTIFY.UIC command.

When you register a DBDS in RECON, you specify the maximum number of image
copy generations for DBRC to record with the GENMAX parameter of the INIT.DBDS
command. When this number is exceeded, DBRC discards the information relating
to the oldest image copy. For example, if you take image copies daily and want to
keep four days of back level image copies, specify a GENMAX of 4. However, in
some emergency situations, you may take backup copies more frequently, possibly
three in one day. To prevent DBRC from discarding information relating to the
earlier copies, specify the optional parameter RECOVPD to indicate the number of
days you want information retained. If the GENMAX limit is reached, but the
RECOVPD for the oldest image copy record has not expired, DBRC issues a
warning message (DSP0065I), and does not discard the record. If the DSP0065I
warning message appears frequently, you might need to tune the GENMAX or
RECOVPD values with the CHANGE.DBDS command.

DBRC also provides an optional data set recycling capability for standard image
copies. You can, for example, pre-allocate four DASD data sets to contain the
image copy, and request that DBRC reuse these data sets. The recycling capability
is indicated using the REUSE keyword of the INIT.DBDS command. DBRC then
generates JCL so that the oldest DASD data set is always used for output from the
image copy. DBRC has the same capability with tape volumes. However, you need
to analyze your existing tape library techniques to make sure there is no conflict.

Concurrent Image Copy: The concurrent image copy process requires that a
database be registered with DBRC. Information about a concurrent image copy data
set is recorded in the RECON data set. When concurrent image copy succeeds, a
true image exists and can be used for recovery.

You cannot take concurrent image copies of a nonrecoverable databases because

changes to them are not logged, and the fuzzy (incomplete) copy remains fuzzy if
the database is recovered.

HSSP Image Copy: The high speed sequential processing (HSSP) image copy
(IC) process requires that a database be registered with DBRC and requires that an
area be registered with the REUSE attribute for recycling the predefined IC data
sets. Image copies that are created by HSSP are concurrent image copies.

Database Image Copy 2: The Database Image Copy 2 utility requires that
databases and areas be registered with DBRC. You cannot take concurrent image
copies of nonrecoverable databases.

Specifying Change Accumulation Requirements: If you decide to use the

Database Change Accumulation utility for some or all of your recoverable registered
databases, specify the change accumulation groups using the INIT.CAGRP
command. You can, for example, divide the DBDSs into the following groups:
v Application-associated databases
v Physical database clusters
v Logical database clusters
v Volatile (critical data) databases

Chapter 1. DBRC and Database Recovery 17

DBRC and Database Recovery
As with image copies, DBRC provides an optional data set recycling capability for
change accumulations. If you decide to use this capability, specify the data set
information using the INIT.CA command.

You can add or delete members of a CA group after you have created it. A
database can be a member in only one CA group. To move a member from one CA
group to another CA group, you must first delete it from its current CA group and
then add it to the new CA group.

Recommendation: When moving a member to a new CA group, it may be

beneficial to do so shortly after an image copy is done. The change accumulation
utility processes all logs for the member that are needed for recovery, based on the
last good image copy.

Using DBDS Groups: A DBDS group is a named collection of DBDSs or DEDB

areas. DBRC can perform various operations by DBDS group so that you do not
need to repeat the command for every member of the group.

You can specify DBDS groups on the following commands:

GENJCL.IC GENJCL.OIC
GENJCL.RECEIVE GENJCL.RECOV
GENJCL.USER LIST.DBDS
LIST.HISTORY

When you specify a DBDS group on a command, DBRC invokes that command for
each member of the DBDS group. For example, you might have a DBDS group for
a particular application, like payroll. When performing a timestamp recovery, for
example, all DBDSs of a particular application of a database must be recovered to
the same point. If you specify a DBDS group on the GENJCL.RECOV command, you
need only invoke the command once to recover all DBDSs.

You can also specify a CA group as a DBDS group. DBRC then executes the
command for each member of the CA group.

You can define as many DBDS groups as you want. Up to 2000 DBDSs can be in a
group. All DBDSs in a group must be registered in RECON. A DBDS can belong to
more than one DBDS group.

A database is an implied DBDS group for the GENJCL and LIST commands. It is
unnecessary to define a DBDS group consisting of the DBDSs or areas of a single
database. Specify the database name and omit the DDNAME to operate on the
whole database.

The following commands affect the definition of a DBDS group:

v INIT.DBDSGRP
v CHANGE.DBDSGRP
v DELETE.DBDS
v DELETE.DBDSGRP
v LIST.DBDSGRP

DBDS groups can include ILDS (Indirect List Data Set) and index data sets.

18 DBRC Guide & Reference

DBRC and Database Recovery
Related Reading: See “Chapter 11. GENJCL Commands” on page 185 for the
impact of these data sets on the GENJCL commands.

Using DB Groups: A DB group is a named collection of databases or DEDB

areas. A DB group name can be specified in the /START, /STOP, /DBRECOVERY, and
/RECOVER commands, instead of issuing these commands separately for each
database or area. Specifying a DB group name with these commands greatly
reduces the number of times these commands must be issued. Use the
DATAGROUP keyword to specify the DB group name.

DB groups can also include HALDB master and HALDB partition names. Be aware
of the effects of a command issued using a DB group that has a HALDB master
name and one or more of its partitions. See IMS Version 7 Command Reference for
more information.

You can define as many DB groups as you want. Up to 2000 databases or areas
can be in a group. A database or area can belong to more than one DB group and
need not be registered in RECON.

Recommendation: Use a database group whenever possible, even though a

DBDS group can be used as a DB group. Processing a DBDS group as a DB group
entails increased overhead.

DB groups are a form of a DBDS group, so they are stored in RECON using the
DBDS group record. The following commands affect the definition of a DB group:
v INIT.DBDSGRP
v CHANGE.DBDSGRP
v DELETE.DBDSGRP
v LIST.DBDSGRP

Opening a Database: After IMS opens a database, DBRC passes back the
RECON initialization token (RIT) and any extended error queue elements (EEQEs)
associated with each DBDS. The RIT allows IMS to determine whether the
database has been used without DBRC or whether the database has been
controlled by a different RECON.

Recording Allocations and De-allocations: DBRC records information in

RECON about changes to DBDSs and areas. DBRC subsequently uses this
information to determine what log data sets might contain change records for a
given DBDS or area.

When a DBDS that is registered in RECON is first updated, IMS tells DBRC to
create an ALLOC record. In the case of a DEDB area, the ALLOC record is created
when the area is first opened for update. This record identifies the DBDS or area
and contains the time stamp of the first update and the open time stamp of the
corresponding PRILOG.

When DBRC creates the ALLOC record, DBRC enters the name of the DBDS or
area being changed in the LOGALL record for the PRILOG that is active at the time
of the change.

Chapter 1. DBRC and Database Recovery 19

DBRC and Database Recovery
When you de-allocate a DBDS or area using a /DBRECOVERY command from the
operator console of the online IMS subsystem, DBRC writes a de-allocation time
stamp in the ALLOC record that was created when the DBDS or area was
allocated. If no de-allocation time is recorded, DBRC uses the closing time of the
associated log as the de-allocation time. Thus RECON contains a list of the names
of DBDSs or areas for which change records might exist on a given log data set
(LOGALL record) and a list of the time ranges where changes could exist for a
specific DBDS or area (ALLOC records) and a list of the logs containing them.

Using DBRC for Data Sharing

Data sharing requires that the databases be registered with DBRC. DBRC checks
that subsystems have authority to perform the requested task and that other
subsystems are not currently reserving the database.

Related Reading: See the IMS Version 7 Operations Guide and the IMS Version
7 Administration Guide: System for more information on data sharing.

Levels of Data Sharing: DBRC supports the two levels of IMS data sharing:
Database level The entire database or DEDB area is a resource
that can be accessed for update by a single IMS
system at a time. For area resources this can also
be called Area-level sharing.
Block level A database or DEDB area can be accessed by
multiple IMS subsystems concurrently. Data
integrity is preserved for the IMS subsystems that
access the shared data. Within a database or area,
resources are reserved at the block level.

Definition:
v For OSAM databases, the block is a physical data block stored on DASD. For
VSAM databases and DEDBs, the block is a control interval (CI).

Sharing Information Recorded in RECON: DBRC records the following data

sharing information in RECON for all registered databases:
v Sharing level allowed for each database
v Names of databases or areas currently authorized for processing
v Names of IMS subsystems that are involved
v Statuses of the IMS subsystems
v Database statuses from a recovery viewpoint

Assigning a Sharing Level with DBRC: The sharing level of a database or

DEDB area determines whether a request for access is granted. DBRC allows you
to establish one of four sharing levels using the INIT.DB or CHANGE.DB commands.

The following sharing levels are defined using the INIT.DB command.
SHARELVL 0 The database is not to be shared. The database can be authorized
for use by one IMS system at a time. SHARELVL 0 is equivalent to
specifying ACCESS=EX on the /START command.
SHARELVL 1 Sharing is at the database level. One IMS system can be
authorized for update at one time; any sharing systems can only be
authorized for read-only processing. Otherwise, the data sharing is
for multiple readers.

20 DBRC Guide & Reference

DBRC and Database Recovery
SHARELVL 2 Sharing is at the block level but only within the scope of a single
IRLM and a single MVS. Sharing requires that IMS subsystems
sharing a database use the same RECON. Multiple IMS systems
can be authorized for update or read processing.
SHARELVL 3 Sharing is at the block level by multiple IMS subsystems on multiple
IRLMs. Multiple IMS systems can be authorized for non-exclusive
access. The IMSs can be on multiple MVSs using different IRLMs.

Data Set Naming Conventions

The use of MVS catalog facilities for image copy and change accumulation data
sets is optional, because DBRC always records volume serial information pertaining
to these data sets in RECON. If you catalog image copy and change accumulation
data sets, they must have unique data set names.

DBRC provides a data set naming convention to help you generate unique data set
names for those image copy data sets (for HSSP image copies and concurrent
image copies, as well as standard image copies) and change accumulation data
sets that you define for future use.

If you use this convention all the time, uniqueness of your data set names is
assured. If you use the convention only occasionally, you are sent a message at the
end of your job step that indicates that you did not follow the naming convention
and that duplicate data set names could exist in RECON. DBRC assumes that data
set names specified in quotation marks do not follow the name convention.
Therefore, DBRC does not check data set names surrounded by quotation marks.

When you add records to RECON that create data sets for one of the recovery
utilities to use in the future and you are using this data set naming convention, you
can specify either the fully-qualified data set name or simply the abbreviation
high-level-qualifier.*.low-level-qualifier (for example, ALPHA1.*.OMEGA). You can
use these abbreviated names on any INIT, CHANGE, DELETE, or NOTIFY.REORG
command of DBRC when you are specifying the name of a data set that follows the
naming convention. DBRC expands the abbreviated name to its fully-qualified form
before it accesses RECON.

Naming Convention for Image Copy Data Sets

The format for image copy data sets is:

high-level-qualifier.dbdname.ddname.IC.low-level-qualifier

where:
v high-level-qualifier is a the data character string of your choice from one to eight
alphanumeric characters long. The first character must be alphabetic.
v dbdname is the database name of the DBDS for which the image copy data set
is being recorded in RECON.
v ddname is the data set ddname of the DBDS for which the image copy data set
is being recorded in RECON.
v IC indicates that this is the image copy data set.
v low-level-qualifier is a character string of your choice from one to eight
alphanumeric characters long. It must be unique for each DBDS and the first
character must be alphabetic.

Chapter 1. DBRC and Database Recovery 21

DBRC and Database Recovery
Naming Convention for Duplicate Image Copy Data Sets
The format for duplicate image copy data sets is:

high-level-qualifier.dbdname.ddname.IC2.low-qualifier

This is identical to the convention for image copy data sets, except that the IC2 field
indicates that this is a duplicate image copy data set.

Naming Convention for Change Accumulation Data Sets

The format for change accumulation data sets is:

high-level-qualifier.cagrpname.CA.low-level-qualifier

where:
v high-level-qualifier is a character string of your choice that can be from one to
eight alphanumeric characters long. The first character must be alphabetic.
v cagrpname is the name of the CA group for which you are creating the change
accumulation data set.
v CA indicates that this is a change accumulation data set.
v low-level-qualifier is a character string of your choice that can be from one to
eight alphanumeric characters long and must be unique for each CA group. The
first character must be alphabetic.

DBRC Support for Remote Site Recovery

DBRC assists you in the installation of IMS DB and IMS TM, as well as with the
definition and management of IMS components in the Remote Site Recovery (RSR)
complex. In support of RSR, DBRC provides:
v Commands to define, update, and display the status of the RSR complex.
The RECON contains the definition of an RSR complex. You define the elements
of the RSR complex with DBRC commands, and you can modify and display the
RSR complex definition with other DBRC commands.
Related Reading: See IMS Version 7 Operations Guide for more information on
RSR.
v Services that are used by an active subsystem to identify the tracking subsystem
and the databases covered by RSR.
An active subsystem obtains the identity of its tracking subsystem from DBRC.
As databases are updated by the active subsystem, DBRC tells the database
component whether the database is covered by RSR. And the active subsystem
sends its log data to the tracking subsystem.
v Services used by a tracking subsystem to record information about log data that
is received from an active subsystem.
As logs are received and stored at the tracking site, DBRC records the receipt of
the log data. When begin-update records are received for registered databases,
DBRC records the database update.
v Tracking subsystem database support:
– Two types of tracking (called shadowing): DB level tracking (DBTRACK) or
Recovery level tracking (RCVTRACK).
– Maintains log data set information for online forward recovery.
– Records which database change records have actually been applied to the
covered databases.
v Services to assist in the takeover process

22 DBRC Guide & Reference

DBRC and Database Recovery
During a remote takeover, DBRC changes the state of the registered databases
at the new active site to indicate that they are now the master databases.

Related Reading: See IMS Version 7 Administration Guide: System for more
information on controlling database recovery.

Chapter 1. DBRC and Database Recovery 23

24 DBRC Guide & Reference
Chapter 2. Considerations for a DBRC System
This chapter discusses concepts under the following headings that might be helpful
for you to consider for your DBRC system.

In This Chapter:
v “Database Backup Copies”
v “Log Record Change Accumulation” on page 33
v “Recovery” on page 38
v “Batch Backout” on page 43
v “Archiving Log Records” on page 43

This chapter also describes how to use DBRC to control these database-related
and log-related processes:
v Creating backup copies of databases
v Creating DB change accumulation data sets
v Recovering databases
v Protecting databases that need backout
v Archiving OLDSs

Database Backup Copies

When IMS takes a regular system checkpoint, it records internal control information
for DL/I (for Fast Path, IMS also records buffers and MSDBs), but it does not record
the external contents of the database. If the database is lost, examining the last
system checkpoint does not help. The log can tell you what changes have occurred,
but without a backup copy of the database, recovery is impossible.

Recommendation: Make a backup copy of the database after you initially load it,
and make new backup copies at regular intervals. The more recent the backup
copy is, the fewer log change records need to be processed during recovery, thus
reducing the time that is needed for recovery.

IMS enables you to make backup copies in these ways:

v The Database Image Copy utility (DFSUDMP0) runs offline and uses access
method services to make the copy.
v The Database Image Copy 2 utility runs offline and invokes DFSMS Concurrent
Copy to make the copy.
v The Online Database Image Copy utility (DFSUICP0) runs online and uses IMS
services to make the copy.
v The unloaded data that is output from the HISAM Reorganization Unload utility
(DFSURUL0) can be used as a backup copy.
v HSSP processing can also create image copies of DEDB areas.

When these utilities run, they can (depending on installation parameters) call DBRC
to update essential information in the RECON. You can also use various utilities
supplied by the operating system to make your backup copies; however, these do
not interact with DBRC, and so you need to take certain actions to notify DBRC of
your non-standard image copies. See “Nonstandard Image Copy Data Sets” on
page 32 for a discussion of how to notify DBRC about these data sets.

© Copyright IBM Corp. 1974, 2001 25

Backup Considerations
Related Reading: See IMS Version 7 Administration Guide: Database Manager for
more information on HSSP processing of DEDB areas.

The Image Copy Utilities (DFSUDMP0, DFSUICP0, DFSUDMT0)

IMS enables you to “take a picture” of your database before and after changes
have been made to the database. The “pictures” are called image copies. The term
refers to the fact that the copy is an as-is image; the image copy utilities do not
alter the physical format of the database as they copy it. Image copies are backup
copies of your data that help speed up the process of database recovery.

The Database Image Copy utility (DFSUDMP0), Database Image Copy 2 utility
(DFSUDMT0), and Online Database Image Copy utility (DFSUICP0) create image
copies of databases. All of the image copy utilities operate on data sets or areas, so
if a database is composed of multiple data sets or areas, be sure to supply the
utility with multiple specifications. You can request that one of the supported image
copy utilities produce an image copy data set and a duplicate image copy data set
in one run of the utility.

Recommendation: It is advisable to copy all data sets or areas belonging to a

database at one time. If you perform multiple recoveries in order to reset a
database to a prior state, recover all data sets belonging to the database and to all
logically related databases (including those related by application processing) to the
same point to avoid integrity problems.

Each of the image copy utilities provide the option to create backup copies without
taking databases and areas offline. You can use this capability to provide increased
database availability. Image copies taken while the database is available for
concurrent update processing by IMS applications are called concurrent image
copies or ’fuzzy’ image copies. When the concurrent image copy option is not used,
the database must be either taken offline or made available only for ’read’ access
and a consistent or ’clean’ image copy is taken. See “Concurrent Image Copy” on
page 28 for more information.

When using these utilities, you have the option of creating one to four output image
copies. Only the Database Image Copy 2 utility allows three or four output copies
and only the first two output copies are recorded in RECON. The advantage of
making multiple copies is that if an I/O error occurs on one copy, the utility
continues to completion on the other copies. Also, if one copy cannot be read, you
can perform recovery using another. The trade-off in deciding whether to make
multiple copies, is that performance can be degraded because of the time required
to write the additional copies.

DBRC works similarly with the three image copy utilities. The rules for pre-definition
and reuse of image copy data sets apply to all three. Each utility calls DBRC to
verify the input to the utility (DBRC allows it to run only if the input is valid), and it
calls DBRC to record information in the RECON about the image copy data sets
that it creates. An image copy record in RECON has the same format whether its
corresponding image copy data set was created by the Database Image Copy
utility, the Database Image Copy 2 utility, or by the Online Database Image Copy
utility. Two different commands create image copy jobs:
v GENJCL.IC for the offline utilities Database Image Copy and Database Image
Copy 2
v GENJCL.OIC for the online utility Online Database Image Copy

26 DBRC Guide & Reference

Backup Considerations
When you run batch jobs without logging, take an image copy immediately
afterwards; do not count on rerunning the batch jobs, as part of a subsequent
recovery, in combination with the Database Recovery utility. Since the batch
processing is not guaranteed to be physically repeatable, the database could be
damaged by the combination.

Database Image Copy (DFSUDMP0)

Database Image Copy (DFSUDMP0) copies data sets for HISAM, HIDAM, HDAM,
PHDAM, PHIDAM, and PSINDEX databases, and areas for DEDBs. It runs offline
and supports a CIC (concurrent image copy) option that enables you to take an
image copy while the database remains online.

Note: PHDAM (partitioned HDAM), PHIDAM (partitioned HIDAM), and PSINDEX

(partitioned secondary index) are database organizations that are known as
HALDBs (High Availability Large Databases). Unlike the other IMS database types,
HALDBs are partitioned full function DL/I databases. See IMS Version 7
Administration Guide: Database Manager for more information about IMS database
types, and a comparison of HALDBs with non-HALDBs.

When you run the Database Image Copy utility to take a consistent image copy
(CIC option not specified), the use of DBRC is not required but is recommended.
DBRC ensures that there is no update activity against the database or area while
the utility is executing. If you run the utility without using DBRC you must make
certain that no updates occur to the database or area. You can issue a /DBDUMP
command or a/STOP AREA command, for example, to prevent updating of the
database or area by transactions in the system previously doing updates.

To request a concurrent image copy, use the CIC keyword on the GENJCL.IC
command. Alternatively, you can specify the CIC parameter on the EXEC statement
for image copy job. DBRC must be used by the utility and you can only take a
concurrent image copy of a database that has been registered with DBRC.

Using Database Image Copy, concurrent image copies of OSAM data sets and
VSAM Entry Sequenced Data Sets (ESDSs) can be taken. VSAM Key Sequenced
Data Set (KSDSs) are not supported for concurrent image copy by this utility.

Database Image Copy 2 (DFSUDMT0)

The Database Image Copy 2 utility (DFSUDMT0) uses DFSMS Concurrent Copy to
take an image copy. It invokes DFSMS to dump the input data set using the
Concurrent Copy option. The output is recorded in the RECON and can be used for
database recovery in the same way as the output from either of the other image
copy utilities. You can use this utility for HISAM, HIDAM, HDAM, PHDAM, PHIDAM,
and PSINDEX databases and for DEDB areas. Database data sets that are to be
copied by this utility must reside on hardware that supports the Concurrent Copy
option.

An optional COMPRESS parameter invokes the ″compress″ option in DFSMS

Concurrent Copy. The ″compress″ option enables you to reduce the storage space
required to hold the image copy; however, using the compress option increases the
CPU time that is required to perform the copy operation.

The Database Image Copy 2 utility provides greater database availability when
taking consistent or ’clean’ image copies. The database needs to unavailable for
update processing for only a very short period of time while DFSMS establishes a

Chapter 2. Considerations for a DBRC System 27

Backup Considerations
concurrent copy session. Update processing can than be resumed while the image
copy data sets are actually being written. The updates are not included in the image
copy.

This utility can also copy the database while it is being updated by IMS
applications. The image copy created in this case is a ’fuzzy’ copy or a concurrent
image copy. The Database Image Copy 2 utility can copy all supported data set
types, including VSAM KSDSs, while the databases remain online.

The Database Image Copy 2 utility must use DBRC and the databases and areas
being copied must be registered with DBRC. The utility can create up to 4 output
copies, but only the primary and secondary copies are recorded in the RECON.

The image copy output from the Database Image Copy 2 utility is in DFSMS dump
format, which is different than the format of the output of the other image copy
utilities. It is, however, directly usable as input to the Online Recovery Service
(ORS) and to the Database Recovery utility. The image copies are recorded in
RECON with image copy type SMSCIC or SMSNOCIC. The Database Recovery
utility must use DBRC when recovering with these types of image copy data sets.

Online Database Image Copy (DFSUICP0)

Online Database Image Copy (DFSUICP0) runs as a BMP program in the online
IMS and DBCTL environments. You can use it for HISAM, HIDAM, HDAM, PHDAM,
PHIDAM, and PSINDEX databases only; it does not support areas. A database
being copied by this utility is available for updating by the IMS subsystem in which
the utility is executing. Other IMS subsystems cannot have concurrent update
access to the database.

If the database being copied is updated while the utility is running, a ’fuzzy’ image
copy is produced. Recovery with this image copy requires all logs starting with the
log that was in use when the Online Database Image Copy utility was started.

Related Reading: See the IMS Version 7 Utilities Reference: Database and
Transaction Manager for more information about specifying the CIC option on the
EXEC statement.

Concurrent Image Copy

IMS provides the capability to take an image copy of a database without taking that
database offline. This means the database can be updated while the image copy is
being taken and some, all, or none of the updates might appear in the image copy.
This image copy is called ″fuzzy″ because the copy represents the state of the
database over a certain period of time rather than at one specific instant in time. It
is also called a ’concurrent image copy’ because the copy was taken while update
processing is happening.

The ability to take image copies while the databases are being updated by IMS
applications allows increased database availability. The offline image copy utilities,
Database Image Copy and Database Image Copy 2, provide an option to take a
concurrent image copy. A database being copied by the Online Database Image
Copy utility can be concurrently updated by the IMS subsystem in which the utility is
running (but not by other IMS subsystems). Image copies created by HSSP
processing are also ’fuzzy’ copies because the areas are available for update
processing while HSSP is running.

28 DBRC Guide & Reference

Backup Considerations
When a consistent or ’clean’ image copy is input to database recovery, the recovery
only requires logs from after the image copy job completed. A concurrent image
copy, might not include updates that were made before the image copy process
started or while it was executing. Therefore, when a concurrent image copy is input
to recovery, logs from before the image copy process was started might have to be
supplied to database recovery.

You can only take a concurrent image copy of a database that is registered with
DBRC. Also, the Database Image Copy utility (which can take consistent image
copies without using DBRC) must use DBRC when taking a fuzzy copy. You cannot
take a concurrent image copy of a non-recoverable database. Fuzzy copying of
non-recoverable databases is not allowed because there is no log data to
’complete’ the image copy.

Creating Image Copy Data Sets for Future Use and Reuse
Use the REUSE parameter to inform DBRC that you want to be able to define
image copy data sets and record them in RECON for future use. You define image
copy data sets with the INIT.IC command. When processing the GENJCL.IC
command, DBRC selects one of the image copy data sets for use by the image
copy utility.

When the Database Image Copy utility uses an available image copy data set,
DBRC updates its record in RECON with the time stamp of the run of the Database
Image Copy utility during which the image copy data set was used.

If you specify the NOREUSE parameter, you cannot predefine image copy data sets
(This is the default). You need to supply the output data set name for the utility in
either the skeletal JCL member used in processing the GENJCL.IC command or in
the JCL that you produce yourself. When you specify NOREUSE, DBRC
dynamically sets the unit type of the output image copy data set. DBRC sets it to
the default unit type for the device as specified in the INIT.RECON and CHANGE.RECON
commands. Specify NOREUSE when you want more than two DFSMS concurrent
copies (you can have up to four).

If you do not specify REUSE, every time the image copy utility is run DBRC deletes
the oldest image record that exceeds both the GENMAX and RECOVPD values.
The image copy data set itself is not scratched-only its record in RECON is
scratched. You must either scratch the data set or keep track of it yourself, because
DBRC is no longer aware of its existence.

If you are using the image copy option of HSSP for a DEDB area, the area must be
defined with the REUSE parameter and the data sets you predefine must be
cataloged.

Controlling the Number of Image Copies Managed

You can use the INIT.DBDS and the CHANGE.DBDS commands to specify how many
image copies of the DBDS or area that DBRC is to maintain records of.

The GENMAX parameter specifies the maximum number of recovery generations

(images) that DBRC maintains for the identified DBDS or DEDB area. Duplicate
image copy data sets are not included in this number.

Use the RECOVPD parameter to maintain data for a certain period.

Chapter 2. Considerations for a DBRC System 29

Backup Considerations
v See “Recovery Period of Image Copy Data Sets and GENMAX” for more
information about the RECOVPD parameter.
v See “INIT.DBDS” on page 227 for more information on the REUSE, NOREUSE,
GENMAX, and RECOVPD.

Recovery Period of Image Copy Data Sets and GENMAX

A recovery period is the minimum amount of time that image copy information is
maintained in RECON. For example, if the recovery period of a DBDS or DEDB
area is 14 days, image copies are maintained for at least 14 days.

If both GENMAX and RECOVPD have been specified for a DBDS or DEDB area,
DBRC considers both when deciding whether to reuse or delete an image copy
data set.

Table 1 shows the results of GENJCL.IC processing when both GENMAX and
RECOVPD have been specified for a DBDS or area defined with the REUSE
parameter.
Table 1. Results of GENJCL.IC Processing when GENMAX and RECOVPD are Specified
with REUSE
Number of Number of Age of Oldest GENJCL Result
Image Data Sets In-Use Image Image Copy
Copies
=GENMAX =GENMAX <RECOVPD Fail (DSP0063I)
>GENMAX =GENMAX <RECOVPD Avail IC DS used (DSP0065I)
=GENMAX =GENMAX >RECOVPD Oldest IC DS reused

Table 2 shows the results of running an image copy utility when both GENMAX and
RECOVPD have been specified for a DBDS or area defined with the NOREUSE
parameter.
Table 2. Results of GENJCL.IC Processing when GENMAX and RECOVPD are Specified
with NOREUSE
Number of Image Copies Age of Oldest Image Utility EOJ Result
Copy
=GENMAX >RECOVPD Delete oldest image copy
=GENMAX <RECOVPD No delete (DSP0064I)
<GENMAX N/A No delete

If you issue a CHANGE.DBDS command and specify new GENMAX and RECOVPD
values that are less than the existing values, any used image copy data sets that
are beyond the recovery period are deleted until the number of remaining image
copy data sets equals the specified GENMAX value.

If you issue the DELETE.IC command, any specified image copy data set record is
deleted regardless of RECOVPD or GENMAX.

Reusing Image Copy Data Sets

DBRC enables you to reuse old image copy data sets. The REUSE parameter of
the INIT.DBDS command, in addition to enabling you to define image copy data sets

30 DBRC Guide & Reference

Backup Considerations
for future use, enables DBRC to reuse image copy data sets. To reuse the image
copy data set means that the same name, volumes, and physical space are used
for the new image copy.

A run of one of the IMS image copy utilities automatically reuses the oldest image
copy data set for a DBDS or area with the REUSE attribute when all of the
following conditions are met:
v A number of image copy data sets equal to the current GENMAX value are
recorded in RECON. To see the current GENMAX value, use the LIST.DBDS
command.
v The Database Image Copy utility or Online Database Image Copy utility used all
image copy data sets for this DBDS. None of the image copy data sets is
available.
v The oldest image copy is beyond the recovery period.

When you use a GENJCL.IC command to generate the job for the Database Image
Copy utility, the image copy data set that is to be reused is automatically selected.
If the number of image copy data sets is less than the GENMAX value and all
image copy data sets have been used, more image copy data sets must be defined
for the DBDS or area before running the Database Image Copy utility. The number
of image copy data sets should be greater than the GENMAX value if you want to
use a recovery period.

The Database Image Copy 2 utility can create up to four output image copy data
sets. However, GENJCL.IC for a DBDS defined as REUSE generates JCL only one
or two output copies (because you can define image copy data sets for only one or
two copies). If you use GENJCL.IC for the Database Image Copy 2 utility to process
a DBDS defined as REUSE and you want more than two output copies, you have
to modify the generated JCL before you execute the job.

HISAM Copies (DFSURUL0 and DFSURRL0)

Using the HISAM Reorganization Unload utility (DFSURUL0) to make backup
copies of a database lets you process an entire HISAM database in one pass (the
image copy utilities deal with single data sets or areas). The unload utility
(DFSURUL0) also reorganizes the database as it copies it.

Because the unload utility (DFSURUL0) reorganizes the database, before resuming
normal online operations, the data set must be reloaded using the HISAM
Reorganization Reload utility (DFSURRL0), as shown in Figure 5. The logging,
which is done between the unload and reload, reflects the old data set organization.

When using the HISAM utility to make a backup copy, reload immediately, or the
actual database and the backup database are mismatched.

Figure 5. Making a Backup Copy with HISAM Unload

The reload utility (DFSURRL0) notifies DBRC. The unload utility creates a
reorganized copy of each data set. Then the reload utility reloads each data set
from the reorganized copy, and through DBRC, creates a REORG and an IC record

Chapter 2. Considerations for a DBRC System 31

Backup Considerations
in RECON for each data set. The IC record points to the data set that was output
from the Unload utility and input to the Reload utility. After a database has been
reorganized, a DBDS can be authorized only if an image copy of that data set has
been created.

Updates of the database between unload and reload operations must be prevented.
Updates of the database made after an unload operation but before a reload
operation are wiped-out by the reload operation. In addition, the change records
that are logged reflect the old organization, so that a subsequent recovery using
those log records damages the database.

You can prevent access to a shared database during reorganization by using one of
the following methods:
v From an online IMS subsystem, issue a global /DBRECOVERY command for the
database that is to be reorganized. This prevents any subsequent authorizations
except for reorganization and recovery. Ensure that recovery utilities do not run
during the reorganization.
v Manually update RECON by specifying the NOAUTH parameter of the CHANGE.DB
command. This prevents any subsequent authorizations except for the
reorganization and recovery utilities. Ensure that recovery utilities do not run
during the reorganization. After the reorganization process is complete, manually
update RECON by specifying the AUTH parameter of the CHANGE.DB command
for the database that was just reorganized.

Nonstandard Image Copy Data Sets

You can create backup copies of DBDSs by using some means other than the
Database Image Copy utility. For example, you could make a copy of the volume on
which a DBDS resides. DBRC does not record the existence of these nonstandard
image copy data sets in RECON automatically; use a NOTIFY.UIC command to
inform RECON of these data sets. If this information is not recorded in RECON,
DBRC might misinterpret subsequent information about changes to the DBDS. You
cannot issue the NOTIFY.UIC command for a DBDS that is defined with the REUSE
option.

Before recovering a DBDS or DEDB area with a nonstandard image copy data set,
perform the following steps:
1. Close the database using /DBR (without NOFEOV). Load the data set from the
nonstandard image copy (UIC) and record the event in RECON (by issuing
NOTIFY.RECOV with RCVTIME specified).
2. Apply the change records from the logs that were produced since the UIC (by
running DBRC with USEDBDS or USEAREA for the GENJCL.RECOV command or
DFSDUMP DD DUMMY statement in the DBRC JCL).

Since an image copy is not used for Step 2, DBRC does not allow DBRC to
process any log that contains changes outside the recovery range. The recovery
range is defined by the timestamp recovery record RECOV TO (image copy time)
and RUNTIME values.

Frequency and Retention

Consider the following questions when making backup copies of databases:
v How frequently should I make new copies?
v How long should I keep old (back-level) copies?

32 DBRC Guide & Reference

Backup Considerations
There are no precise answers to these questions. Generally, the more frequently
you copy, the less time recovery takes. The further back in time your old copies go,
the further back in time you can recover. (Remember that program logic errors are
sometimes not discovered for weeks.) Conversely, making each new copy requires
work, and each old copy that you save uses additional resources.

The only firm guidelines are these:

v If a database is composed of several data sets, be sure to copy all of the data
sets at the same time.
v If you reorganize a database, immediately make a new backup copy of it. (This is
not necessary for online DEDBs or HISAM reorganizations.)
v If you create a new database, immediately make a backup copy of it.
v If you perform a timestamp recovery, make a backup copy for use in subsequent
recoveries.

Log Record Change Accumulation

As IMS runs, the number of stored SLDSs or RLDSs grows. You can use these
stored volumes to recover a lost or damaged database, but to use them in their raw
form would be inefficient because:
v Each SLDS or RLDS contains a record of activities of the entire system and all
the data sets within all the databases. Yet when you are recovering a database,
you are doing so for a single data set only. Thus, much of what is on the SLDS
or RLDS does not apply.
v The SLDS or RLDS chronologically notes each change to any single record. If a
record were changed 100 times since the last backup copy of the data set, the
SLDS or RLDS would include 100 such notations. Yet, in recovery, you are only
interested in the value the data had at the moment the data set was lost. The
previous 99 changes are irrelevant.

DBRC requires that change records be input in chronological order, but if a

database is shared, the change records might be distributed among different log
data sets in a way that makes their input to the utility impossible. A DBRC
GENJCL.RECOV command or DBRC utility execution fails if this log data has not been
properly merged. Such a failure is accompanied by a message informing you that a
Change Accumulation should be run.

Condensing the Accumulated SLDS or RLDS (Change Accumulation)

The Database Change Accumulation utility offers you a way of sorting through your
accumulated log data sets in advance, merging and condensing them. This utility:
v Merges updates from different subsystems
v Picks out only those log records relating to recovery of databases
v Sorts these records by data set within a database
v Saves only the most recent state of each changed part of each data set.

Figure 6 on page 34 illustrates how change accumulation merges data from

divergent data streams.

Chapter 2. Considerations for a DBRC System 33

Log Record Change Accumulation

Figure 6. What Change Accumulation Does with Data from Divergent Data Streams

34 DBRC Guide & Reference

Log Record Change Accumulation
When Is Change Accumulation Required?
Running the Database Change Accumulation utility is not required if, during the time
period in question, only one system updated the database; using it periodically
speeds any database recovery that becomes necessary. Alternately, you can run
the Database Change Accumulation utility only when the need for recovery arises
(just before running DBRC).

Figure 7 illustrates why change accumulation would not be required when

non-concurrent data set update information exists in various logs. The database
changes are received in the correct order if the logs are input serially to DBRC.

Figure 7. Non-Concurrent Data Set Update Information in Logs: Change Accumulation Not
Required

Figure 8 on page 36 illustrates why change accumulation can be required when

concurrent data set update information exists in various logs. The logs cannot be
input to DBRC in a way that the change records are seen in the correct order.

Chapter 2. Considerations for a DBRC System 35

Log Record Change Accumulation

Figure 8. Concurrent or Overlapping Data Set Update Information in Logs: Change

Accumulation Required

Related Reading: See the IMS Version 7 Utilities Reference: Database and
Transaction Manager for detailed instructions on running the Database Change
Accumulation utility.

Input to the Database Change Accumulation Utility

In addition to stored SLDSs and RLDSs, you can use a previous change
accumulation data set and other IMS log volumes as input. The utility writes the
accumulated changes in a new change accumulation data set.

You can specify all log volumes or a subset of log volumes as input to the Database
Change Accumulation utility. When you specify a subset of log volumes, DBRC
determines whether the subset is complete for each DBDS or area. A subset of log
volumes is complete for a DBDS or area when all of the following conditions are
true:
v The first volume in the subset is the earliest volume, that could possibly have
changes to the DBDS, that were not included in the last change accumulation or
in the last image copy.
v The remaining volumes are in sequence.
v In a data sharing environment, logs from all updating subsystems containing
changes and any open data streams for a DBDS are included.

The DBRC LIST.CAGRP command indicates whether the log subset for each DBDS
of the change accumulation group is complete.

36 DBRC Guide & Reference

Log Record Change Accumulation
You can use the change accumulation data set as input to a later run of the
Database Change Accumulation utility whether your subset of log volumes is
complete or incomplete; however, you can use a change accumulation data set as
input to DBRC only if it represents a complete log subset.

Recommendation: If DBRC is being used, it is recommended that the change

accumulation process is performed using the GENJCL.CA command. This command
creates the correct JCL and includes all unprocessed log data sets. If you use your
own JCL instead, verify the specifications for change accumulation before
execution.

An image copy of the specified database data set is needed and must be identified
to RECON in order to create a valid starting point for change accumulation records.

All changes since the last valid image copy are collected by the utility. If a
timestamp recovery has occurred since the last image copy, the change
accumulation that is created is invalid for use in future recoveries. No error
messages are generated by GENJCL.CA or by the execution of the utility.

You can run the Change Accumulation utility with a valid log subset at any time
during change accumulation to reduce data to a minimum.

Related Reading:
v Sample operating procedure 162 in IMS Version 7 Sample Operating Procedures
describes the task of running the Database Change Accumulation utility.
v See the IMS Version 7 Operations Guide for more information on the change
accumulation process in general.

Change Accumulation Groups

A CA group can contain from one to 2000 members, which must be registered
DBDSs or areas. Use INIT.CAGRP to create your CA group. To modify your CA
group, use CHANGE.CAGRP. A DBDS or area can belong to only one CA group.

DBRC supports the Change Accumulation utility only by CA group. Likewise,

GENJCL.CA generates JCL only for a CA group. The DBRC verification exit routine
verifies for a whole CA group.

You can run the CA utility for DBDSs that do not belong to a CA group even with
DBRC=YES in effect. However, DBRC does not verify the input to the utility nor
record its output.

Defining Change Accumulation Data Sets for Future Use

You can use the REUSE keyword on the INIT.CAGRP command to inform DBRC that
you want to define a ″pool″ of data sets to receive the output from the Change
Accumulation utility. Define the data sets using the INIT.CA command. The number
of change accumulation data sets that you can define, can equal up to the value of
the INIT.CAGRP command GRPMAX parameter that defined the group.

If you define a CA group with the REUSE parameter and also use a GENJCL.CA
command to generate the job for the Database Change Accumulation utility, reuse
can occur. When all these available change accumulation data sets for this CA
group have been used and the maximum number of change accumulation data sets
has been reached, the next run of the Database Change Accumulation utility for this
group reuses the change accumulation data set containing the oldest change

Chapter 2. Considerations for a DBRC System 37

Log Record Change Accumulation
records. To reuse a change accumulation data set means that its data set name,
volumes, and physical space are used as if they were for an empty change
accumulation data set.

If you define the CA group with NOREUSE:

v You must specify the output data set name for the utility either in the skeletal JCL
member used for the GENJCL.CA command or in the JCL that you produce.
v When you run the CA utility and the number of data sets specified by GRPMAX
has been reached, DBRC deletes the RECON record of the change
accumulation data set that contains the oldest change records. The data set itself
is not scratched. The data set must be manually scratched or monitored if you
want to keep it, because DBRC no longer recognizes its existence.

The Database Recovery Process

Recovery of a database data set by the Online Recovery Service (ORS) or by the
Database Recovery utility (DFSURDB0) consists of the following:
1. Loading (usually) the most recent image copy.
If the image copy is a UIC, you must perform this step yourself. ORS and the
recovery utility do not load user image copies.
2. Applying all changes logged since the image copy was taken.

The changes can be recorded in log data sets, in change accumulation data sets,
or in a combination of the two.

If the image copy was made while the database was not being accessed for
update, only changes that were logged after the run time of the copy are required.

If the database was accessed for update at the time the copy was made, the image
copy is said to be ″fuzzy″; that is, changes already made to the database by active
applications might be missing from the copy because they had not yet been
physically written to the data set. They had, however, been written to the log. In this
case, to ensure that all changes are applied it is necessary to go back to some
earlier point in the logs, how far depends on the type of database and which image
copy utility was used.

Note that the input to the Change Accumulation utility, when the most recent image
copy is ″fuzzy″, is subject to the same conditions. The point-in-time selected to start
the Change Accumulation utility is called the ″purge time.″

You can omit all logged changes after a certain time from the input by performing a
″timestamp recovery.″ A timestamp recovery is equivalent to backing out the omitted
changes from the database. However, if you want to omit changes, it is not always
possible to do so without DBRC.

38 DBRC Guide & Reference

Recovery
How DBRC Helps in Recovery
DBRC will use ORS and the recovery utility to help in recovery. For ORS, DBRC
selects the recovery input (IC, CA, and logs) as part of the /RECOVERY START
command processing but not for GENJCL. However, for the recovery utility, DBRC
will generate recovery JCL and validate utility JCL:

Generating Recovery JCL

You can use the GENJCL.RECOV command to generate the JCL that is necessary to
recover a registered database data set. Using information recorded in RECON,
DBRC selects the image copy data set to use for step 1, and selects the CA and
log data sets that are to be input to step 2. If Change Accumulation input is required
because of data sharing, but it is not present or usable, DBRC informs you of that
fact and the command fails.

You can request a timestamp recovery, and DBRC selects the correct logs and, at
execution time, communicate to the utility where to stop processing the input to
correctly perform your request.

Validating Utility JCL

When the recovery utility runs against a registered database data set, the utility
presents its input to DBRC for validation. Whether the recovery JCL was created by
you or by DBRC, DBRC verifies that the input for both step 1 and step 2 are correct
according to the current RECON information. (It is possible, even if you created the
JCL with the GENJCL command, that intervening events could invalidate it before it
runs.)

Recording the Result

Upon successful conclusion of the recovery, DBRC records it in RECON, including
the range of omitted changes if you did a timestamp recovery. If ORS timestamp
recovery is used with the point in time recovery (PITR) option, you must make an
immediate image copy to ensure a valid starting point for subsequent recoveries.
DBRC then prevents the changes from being reapplied on any subsequent
recovery.

Planning Recovery Procedures

Recovery in a data sharing environment is similar to standard IMS recovery. It
involves you in these primary tasks:
v Setting up the mechanisms of recovery (logging, taking checkpoints, keeping
records)
v Setting up the operational procedures for situations that require recovery

Setting Up Recovery Mechanisms

The logging and checkpoint mechanisms of online IMS subsystems in a
non-sharing environment are also active in a data sharing environment. These
include:
v System log data sets and the use of the WADS and restart data sets
v Program, system, and message-queue checkpoints
v Making image copies of databases

The primary difference between non-sharing and data sharing environments is in

their degree of reliance on DBRC. DBRC helps control the data sharing
environment; it does not merely keep records.

Chapter 2. Considerations for a DBRC System 39

Recovery
Database reconstruction (forward recovery), program-level (dynamic) backout,
database backout, and restart (with embedded recovery) in a data sharing
environment, however, are different in a nonsharing environment.

Related Reading: See the IMS Version 7 Operations Guide for detailed
information on recovery procedures in sharing and nonsharing environments.

Recovery Facilities
The following recovery facilities behave differently in data sharing and nonsharing
environments:
v Dynamic backout
v Batch backout
v Forward recovery

Dynamic Backout
An online IMS subsystem in a data sharing environment dynamically backs out the
uncommitted database changes of an application program and discards its
uncommitted output messages under either of these conditions:
v The program fails.
v The program requests backout with a rollback call.

The same is true in a nonsharing environment. In a data sharing environment,

however, IRLM locks and RECON status indicators ensure integrity by protecting
uncommitted changes from sharing subsystems. Operation of the system and other
programs continues uninterrupted.

Related Reading: See the IMS Version 7 Operations Guide for detailed
information about dynamic backout.

Batch Support
DBRC improves database integrity by interfacing with IMS restart dynamic backout,
and the Batch Backout utility to control access to databases in need of backout.
DBRC creates a backout record (BKOUT) to track each unit-of-recovery (UOR) for
each database in need of backout. DBRC verifies logs that are input to the batch
backout utility.

Backout records are created for online subsystems. Backout records are not
created for DL/I batch subsystems unless dynamic backout was being used and it
failed.

Prior to executing an emergency restart with the COLDSYS parameter (/ERESTART

COLDSYS), run batch backout with either the COLDSTART or ACTIVE parameter.
This creates a backout record (BKOUT) for all in-flight and indoubt UORs as
candidates for backout. The next IMS restart promotes candidate UORs to
backout-needed status. Backout-needed flags are set in database records in
RECON.

When dynamic backout fails, a backout record is created with a UOR indicating
dynamic backout failure and the database record in RECON is flagged as needing
backout.

When the databases are backed out successfully, the flags in database records in
RECON are reset appropriately and the backout records are updated. When
backouts for all of the UORs have been completed, the backout record is deleted
from RECON.

40 DBRC Guide & Reference

Recovery
For DBCTL, if you choose not to back out an unresolved indoubt UOR, use the
DELETE.BKOUT or CHANGE.BKOUT command to remove it from the RECON backout
record.

DBRC commands are also available to update backout records if needed. The need
to make manual changes to the backout record should be minimal.

Recommendation: Use the DELETE.BKOUT or CHANGE.BKOUT commands with

extreme caution.

DBRC provides batch backout input log verification. Log volumes input to the batch
backout utility are checked to ensure they are in the correct sequence, all logs are
provided, and properly closed. When ACTIVE or COLDSTART options are included
in the utility SYSIN statement, then an additional check is done to ensure all
volumes related to restart are included. For DL/I batch logs, a check is also
performed to ensure that the correct volumes are from the last batch execution.

Attention: If BYPASS LOGVER is included in the SYSIN statement of the batch

backout utility, then input log verification and notification of UORs is not done.
Existing UORs are updated on successful completion of backouts.

Related Reading: See IMS Version 7 Operations Guide and IMS Version 7
Utilities Reference: Database and Transaction Manager for more information on
UOR and backout.

Limitations of DBRC Backout Support

Although this support protects databases from damage caused by the most
common errors in using backout, some possible sources of damage to databases
remain.
v If an IMS subsystem abends and an ERE COLDSYS is done before the in-flight
and indoubt UORs have been identified to DBRC (by a Batch Backout run), the
databases associated with those in-flights and indoubts are not protected from
erroneous updates until the first Batch Backout run using the COLDSTART
statement (or the ACTIVE statement).
v Including logs from multiple runs of a batch job in the same log data set (by
specifying DISP=MOD) makes log verification unreliable.
v DBRC commands are provided for the modification of the RECON. Carelessness
in using these commands could lead to errors which would allow backouts that
should not be done or allow other subsystems access to databases that are in
need of back out.
v The Batch Backout control statement BYPASS LOGVER is provided to allow
backouts to be done when RECON information indicates that the input log is
invalid or the backouts are not needed. Careless use of this control statement
can cause backouts to be performed that should not be.
v Unregistered databases are not protected from being used while backout is
needed.
v Backing out a normally terminated job (that did not use IRLM) after a timestamp
recovery was performed (to recover the database to a point in time prior to this
log) makes log verification unreliable. Since the log being backed out is the last
log for this SSID, it passes DBRC verification.

Forward Recovery
The process of recovering a database in a data sharing environment has certain
similarities to recovering a database in a nonsharing environment. In both
environments, use DBRC with either ORS or the Database Recovery utility

Chapter 2. Considerations for a DBRC System 41

Recovery
(DFSURDB0) and provide it the most recent image copy of the lost database, and
all pertinent system log data sets used since that copy was made.

If you are using DFSURDB0, block-level data sharing, however, might require the
additional step of Change Accumulation, if you are not using ORS for forward
recovery.

Related Reading: See the IMS Version 7 Operations Guide for further discussion
of forward recovery.

Recovery without DBRC

If you perform any recovery-related actions offline when DBRC is not running, such
as making database image copies, problems could arise because DBRC would not
be notified of the changes in status. Therefore, DBRC must be specifically informed
of such changes. DBRC offers you several commands for this purpose.

Related Reading: See the IMS Version 7 Operations Guide for detailed
information about recovery without DBRC and its related commands.

Because restart is required, the Utility Control Facility (UCF) might have to be used
without DBRC being active. If you use UCF for any recovery-related work, DBRC
must be informed of status changes afterward.

Restart after IMS Failure

Restart an IMS subsystem in a data sharing environment in the same way as in a
nonsharing environment:
v If you can shut down the subsystem normally (a checkpoint shutdown
/CHECKPOINT PURGE, /CHECKPOINT DUMPQ, or /CHECKPOINT FREEZE), you can restart
it normally, using the /NRESTART command.
v If the subsystem failed, an emergency restart must be done using the /ERESTART
command.

In a data sharing environment, however, consider that if the associated IRLM also
stops or fails, you must first start IRLM before you start IMS in a block-level
environment.

Related Reading: See the IMS Version 7 Operations Guide for more information
on restart after IMS failure.

Restart after DBRC Failure

Because DBRC runs under the control of IMS, IMS knows whether its DBRC fails. If
a DBRC failure occurs, IMS terminates abnormally, attempts to flush its buffers, and
closes the system log. After correcting the DBRC problem, you can restart IMS
using the /ERESTART command.

Recovery Involving IRLM Configurations

DBRC records IRLM status information in the subsystem record.

42 DBRC Guide & Reference

Recovery
Batch Backout
Prior to executing an emergency restart with the COLDSYS parameter (/ERESTART
COLDSYS), run batch backout with either the COLDSTART or ACTIVE parameter.
Provide DBRC with the names of the logs to protect registered databases (that
need to be backed-out) from being accessed until their backouts are complete.

For DB level control, if you choose not to back out an unresolved in-doubt UOR,
use the DELETE.BKOUT command to remove it from the RECON backout record.

Recommendation: Use the DELETE.BKOUT command with extreme caution. It

deletes all backout information for a subsystem from the RECONs.

Archiving Log Records

Related Reading:
v See IMS Version 7 Operations Guide for more information on automatic, manual
and custom archiving of log records.
v See IMS Version 7 Utilities Reference: System for more information about
specifying entry points and running the Log Archive utility.
v Refer to IMS Version 7 Customization Guide for more information about writing
exit routines.

Chapter 2. Considerations for a DBRC System 43

Recovery

44 DBRC Guide & Reference

Chapter 3. Initializing and Maintaining the RECON
In This Chapter:
v “Planning Considerations for the RECON” on page 46
v “Initial RECON Access” on page 54
v “Records in the RECON” on page 55
v “Maintaining the RECONs” on page 64

DBRC records recovery-related information in a pair of key-sequenced data sets

(KSDSs) called RECON (recovery control). DBRC uses dual recovery control
(RECON) data sets to increase availability and recoverability. They contain identical
information. The data sets are identified by the DD names RECON1 and RECON2.

If you define only two RECONs and an error occurs on one of them during
operation, the current jobs continue using the remaining one. New jobs start only if
your RECON setting allows a start with only one active RECON. If you want to
continue operations in dual mode, you can define a third RECON (RECON3).
DBRC does not use this spare data set unless an error occurs on one of the two
active RECONs. Then, DBRC copies the good RECON to the spare data set
(RECON3), which then becomes active (thus maintaining RECON dual-mode
operation).

Figure 9 shows the normal three RECON operating configuration.

Figure 9. RECON Three-Data-Set Scheme

The RECON data sets are critical resources for both DBRC and IMS. If both
RECON data sets are lost, DBRC abnormally terminates rather than compromising
database integrity. IMS cannot continue processing transactions without a RECON
data set, so it also abnormally terminates.

© Copyright IBM Corp. 1974, 2001 45

Maintaining the RECON

Planning Considerations for the RECON

Each RECON is a VSAM KSDS with a 32-byte key.

Define your RECONs specifying VSAM SHAREOPTION(3,3). Ideally, each data set
should be on a different device, channel, control unit, and catalog. Data sets should
also be of different sizes (see “Avoiding RECON Space Problems” on page 50).

When defining the RECONs using VSAM Access Method Services (AMS), you must
use the same index control interval (CI) size and data CI size for all the RECONs.
Unequal index or data CI sizes cause DBRC to use virtual storage inefficiently.

Recommendations:
v Ensure that the data CI size specified exceeds the specified index CI size by at
least 2048 bytes. Failure to do so can seriously degrade your DBRC
performance.
v Specify the maximum record size for all RECONs when defining the RECONs
using AMS. DBRC initialization fails if the maximum record size of the two active
RECONs do not match.

First-Time Users
After allocating the RECONs, use the INIT.RECON command to initialize the
RECON. This command is only valid for an empty, uninitialized RECON. If the
initialization job fails, delete and redefine the data sets before rerunning it.

Avoiding RECON Contention Problems

Maximum RECON availability depends on the following:
v Eliminating deadlock
v Minimizing situations in which more than one RECON becomes simultaneously
unavailable

For maximum availability, each RECON must:

v Have different space allocations. The spare data set must be at least as large as
the largest RECON.
v Be on different devices.
v Be on different channels.
v Be in different user catalogs.

For additional information on avoiding space problems, see “Avoiding RECON

Space Problems” on page 50.

Recommendation: To eliminate contention and facilitate recoverability it is

recommended that RECONs be the only type of data set on their respective
devices.

To eliminate deadlocks, the RECONs must:

v Be the only objects cataloged in their respective catalogs.
v Be on the same device as their catalogs. When RECONs are accessed, an
enqueue on the RECONs can result, followed by an enqueue on the catalog.
When the RECONs and catalog are on the same device, the possibility of
conflicts with another job enqueueing the devices in reverse order is eliminated.

46 DBRC Guide & Reference

Maintaining the RECON
Avoiding RECON Deadlock
To avoid deadlock situations, give special consideration to the placement of
RECONs that are shared among multiple processors. During a physical open,
DBRC reserves RECON1, RECON2, and RECON3. DBRC determines which are
available and which are Copy1, Copy2, and spare. DBRC then closes and
dequeues the spare (if it exists) and any unusable RECONs. So, during the use of
DBRC, two RECONs are reserved most of the time. DBRC always reserves both
RECONs in this order: RECON1 and RECON2. If RECON1 and RECON2 are
specified consistently throughout jobs, DBRC does not encounter deadlock.

However, other jobs that reserve multiple volumes can cause deadlock if any of the
volumes also contain a RECON.

GRS: Global Resource Serialization (GRS) provides a method of converting a

RESERVE request into an ENQ request. The ENQ, DEQ, and RESERVE macros
identify a resource by its symbolic name. The symbolic name has three parts:
v Major name (qname)
v Minor name (rname)
v Scope (which can be STEP, SYSTEM, or SYSTEMS)

For example, on an ENQ or DEQ macro, a resource might have a symbolic name
of APPL01,MASTER,SYSTEM. The major name (qname) is APPL01, the minor
name (rname) is MASTER, and the scope is SYSTEM.

When an application uses the ENQ, DEQ, and RESERVE macros to serialize
resources, global resource serialization uses resource name lists (RNLs) and the
scope on the ENQ, DEQ, or RESERVE macro to determine whether a resource is a
local resource or a global resource. Global resource serialization identifies each
resource by its entire symbolic name. For example, a resource that is specified as

Chapter 3. Initializing and Maintaining the RECON 47

Maintaining the RECON
A,B,SYSTEMS is considered a different resource from A,B,SYSTEM or A,B,STEP
because the scope of each resource is different. To ensure that resources are
treated as you want them to be without changes to your applications, global
resource serialization provides three resource name lists (RNLs):
v SYSTEMS EXCLUSION RNL
The SYSTEMS exclusion RNL contains a list of resources that are requested
with a scope of SYSTEMS that you want global resource serialization to treat as
local resources.
v RESERVE CONVERSION RNL
The RESERVE conversion RNL contains a list of resources that are requested
on RESERVE macros for which you want global resource serialization to
suppress the RESERVE.
v SYSTEM INCLUSION RNL
The SYSTEM inclusion RNL contains a list of resources that are requested with a
scope of SYSTEM that you want global resource serialization to treat as global
resources.

Related Reading: See the following publications for more information about GRS
and the MVS RESERVE, DEQ, and ENQ macros:
v OS/390 MVS Programming: Authorized Assembler Services Reference
v OS/390 MVS Planning: Global Resource Serialization

OBTAIN: DBRC uses a VSAM DADSM (Direct Access Device Storage

Management) OBTAIN request to the FORMAT-4 DSCB (the VTOC) to force an I/O
that insures that DBRC really has the RECON reserved in a multi-system
environment. For more information about the OBTAIN DADSM macro, see the
MVS/DFP V3R3 System Program Reference Manual.

DEQ: DBRC releases the RECONs by using the MVS DEQ macro.

DFP Record Management Services: DBRC uses VSAM services to retrieve,

manipulate, and store the RECON records. These RECON records have a 32 byte
record key.

RECON Serialization Strategies: The following items discuss several serialization

implementations and their effects:
v GRS SYSTEMS EXCLUSION RNL
If you implement GRS SYSTEMS EXCLUSION RNL, then GRS does not do
global serialization, and the RESERVE is issued. This is the recommended way
to implement IMS with DBRC and it works well provided that the RECON data
set is located on a DASD volume which does not contain other data sets which
are needed by other MVS systems.
To implement this method follow these steps:
1. Add the RECON QNAME to the SYSTEMS EXCLUSION RNL
– RNLDEF RNL (EXCL) TYPE (GENERIC) QNAME (DSPURI01)
2. Carefully consider the placement of the following VSAM QNAMEs:
– SYSZVVDS
– SYSIGGV2

48 DBRC Guide & Reference

Maintaining the RECON
The performance (in terms of least CPU time used, least storage used, and least
elapsed time) is best for this option. It does require careful control of the contents
of the DASD volume holding the RECON (ideally a dedicated volume exists for
the RECON).
v RESERVE CONVERSION RNL
If you implement GRS RNL CONVERSION by adding the QNAME for the
RECON, DSPURI01, to the conversion list, the hardware reserve is eliminated
and replaced by a GRS enqueue that is propagated to all sharing MVS systems.
They all must be in the same GRS ring. This locks out access to the RECON
data set by IMS code that does the enqueue on the RECON. It does not lock out
access by non-IMS code that does not issue an ENQUEUE for DSPURI01. Thus,
there is a potential integrity exposure, but only for non-IMS products that should
NOT access the RECON in any situation.
Other data sets on the same DASD volume can be used while the RECON is
″reserved″; this is the benefit of performing the RNL conversion. GRS RNL
conversion uses CPU and storage and can affect system performance.
Conversion of a production IMS system is not recommended. It may be
reasonable to do for a development IMS system, but the performance analysis is
a decision for each specific environment.

Allocating the RECONs

For both online and batch DBRC jobs, you can allocate the RECON1, RECON2,
and RECON3 data sets with JCL, or you can let DBRC dynamically allocate them.

When dynamically allocating the RECON, omit the DD statements for RECON1,
RECON2, and RECON3.

Use the IMS DFSMDA dynamic allocation macro to establish three dynamic
allocation parameter lists in IMS.SDFSRESL. When multiple processors access the
same RECONs, keep the IMS.SDFSRESL information pertaining to dynamic
allocation parameters in synchronization on all processors.

Related Reading: See IMS Version 7 Utilities Reference: System for information
about the DFSMDA macro.

DBRC always allocates RECONs with DISP=SHR.

Although JCL allocation and dynamic allocation are both valid methods for
allocating RECONs, JCL allocation should be used only in a controlled test.

Recommendation: Use dynamic allocation for your production system and all other
test or development environments.

The principal advantages of dynamic RECON allocation are:

v All DBRC jobs automatically use the correct and current RECON data sets, and
no JCL statements are left to become outdated.

Chapter 3. Initializing and Maintaining the RECON 49

Maintaining the RECON
v You can reorganize and restore RECONs, in case of error, without having to shut
down online IMS systems.

Avoiding RECON Space Problems

Allocate the RECONs with different amounts of space so that if one becomes full,
the system can continue using the other RECON while you provide a replacement.

If one RECON becomes full during online operation, IMS deallocates it. DBRC
responds by copying and reorganizing the good RECON to a spare RECON, if one
is available. If no spare RECON is available, the system runs in single RECON
mode.

When all active subsystems have deallocated the failing RECON data set, you can
delete and redefine it offline using VSAM AMS. If you are in single mode, and a
spare RECON is available, the next time DBRC accesses the RECON, it
automatically enters dual RECON mode. You do not have to enter the CHANGE.RECON
command with the DUAL or REPLACE option.

Creating a RECON
The DEFINE CLUSTER keywords that are recommended when defining a RECON
VSAM KSDS are defined below. Information on all the keywords can be found in
the DFSMS/MVS V1R5 Access Method Services for VSAM catalog.
CONTROLINTERVALSIZE
The values used with this keyword affect the total amount of storage used by
DBRC for VSAM buffers. DBRC uses the Local Shared Resources (LSR) option
of VSAM to process the RECONs. If the number of index and data buffers
created by DBRC is allowed to default, the amount of storage used for RECON
buffers is (60·index_ci_size + 120·data_ci_size). This occurs when the index
and data CI sizes are the same for all RECONs. The amount of storage used
by DBRC for buffer space can be adjusted by changing the index or data
control interval (CI) size on this keyword.
Recommendations: Initially set your minimum CI size to a minimum of eight
KB. The allowable CI size is affected by the value you select for RECORDSIZE.
Also, ensure that the smallest data CI size specified exceeds the largest index
CI size specified by at least 2048 bytes. Failure to do so can seriously degrade
your DBRC performance. Alternately, you can change the default number of
index or data buffers used by DBRC in an online or batch environment.
Related Reading: See IMS Version 7 Customization Guide for further details
about using the Buffer Size Specification Facility.
CYLINDERS
FREESPACE
The default values of FREESPACE(0 0) must not be used. While you are
entering initial information in the RECON, you must specify a high
control-interval percentage (for example, 70%) as free space. Later, you can
lower the percentage with an Access Method Services (AMS) ALTER command.
INDEXED
KEYS
KEYS(32 0) is required.
NAME
NOERASE
NOREUSE

50 DBRC Guide & Reference

Maintaining the RECON
RECORDSIZE
A minimum of RECORDSIZE(4086 524,288) is recommended. This is the
default value when SPANNED is specified. The largest record size supported by
the AMS REPRO function with sequential output files is 32760.
For IMS subsystems that access many databases and operate for very long
periods between shutdowns, a very large record size might be required. A very
large record size can help in minimizing unplanned outages that can result from
certain RECON records becoming too large.
Depending on the configuration of your IMS environment, the number of
databases a subsystem might access and the elapsed time between IMS
startup and shutdown, you might want to increase the maximum record size
beyond 32600.
Restriction: If you increase the maximum record size beyond 32600, you
cannot use the DBRC BACKUP.RECON command to copy the RECON to a
sequential file because of the AMS REPRO function restriction.
Recommendation: Use the BACKUP.RECON command to copy the RECON to a
KSDS, and then use the DFSMSdss DUMP command to copy the KSDS to a
sequential file.
Related Reading: See the IMS Version 7 Release Planning Guide for more
information on record size changes.
SHAREOPTIONS
SHAREOPTIONS(3 3) must be specified. The first value is required with
single-host processors. Both values are required with multiple-host processors.
SPANNED
SPEED
UNORDERED
UNIQUE
If ICF catalogs are used, this keyword is not necessary.
VOLUMES

Recommendation: Do not use authorization keywords because frequent operator

prompting results.

Avoid the use of WRITECHECK; it can degrade RECON I/O performance. The use
of dual RECONs eliminates the need for WRITECHECK.

Variable Size RECON Records

The following table lists the variable length RECON records that have the possibility
of exceeding the RECON maximum record size.

DBRC warns you when any record exceeds a size threshold that you have set so
that you might have time to take corrective action before the maximum size is
reached. See “CHANGE.RECON” on page 147.
Table 3. RECON Records of Variable Size
Record Type How exceeding Result when What to do
RECORDSIZE can RECORDSIZE is
happen exceeded
Records whose growth is event-driven and open-ended:

Chapter 3. Initializing and Maintaining the RECON 51

Maintaining the RECON
Table 3. RECON Records of Variable Size (continued)
Record Type How exceeding Result when What to do
RECORDSIZE can RECORDSIZE is
happen exceeded
PRILOG The record is filling up IMS ABENDs v Stop subsystem,
with data set entries
v Increase RECON
because:
RECORDSIZE, -OR-
v Combination of
v Correct whatever is
RECORDSIZE and
preventing log
Image Copy
compression.
frequency is not
correct for the See “Getting PRILOG
subsystem’s logging Compression to Work”
volume. on page 82 for more
v Something is information about
preventing PRILOG compressing the
compression. PRILOG.
DBDS/Area A database was not IMS ABENDs. /ERE To prevent ABEND,
stopped after an I/O might also fail if /DBR the database;
device failure so that backout generates after ABEND increase
endless EEQEs are more EEQEs. RECON
recorded. RECORDSIZE.
BKOUT This is very unlikely; it Subsystem ABENDs. Increase RECON
would require a small RECORDSIZE.
RECORDSIZE and an
abnormally high
number of dynamic
backout failures.
Records whose size is determined by the number of objects supported:
CAGRP RECORDSIZE is CHANGE.CAGRP Increase RECON
insufficient for number command fails. RECORDSIZE.
of members (2000
members = 32052
bytes).
CA RECORDSIZE is CA utility fails. Increase RECON
insufficient for number RECORDSIZE.
of CAGRP members
(2000 members =
72096 bytes).
DBDSGRP RECORDSIZE is CHANGE.DBDSGRP Increase RECON
insufficient for number command fails. RECORDSIZE.
of members (2000
members = 32052
bytes).
SSYS RECORDSIZE is Authorization failure. Increase RECON
insufficient for the RECORDSIZE.
number of databases
the subsystem is
attempting to access
(2000 databases =
64072 bytes).

52 DBRC Guide & Reference

Maintaining the RECON
Table 3. RECON Records of Variable Size (continued)
Record Type How exceeding Result when What to do
RECORDSIZE can RECORDSIZE is
happen exceeded
PRIOLD This is very unlikely, Online IMS ABENDs or Increase RECON
since a RECORDSIZE NOTIFY.LOG command RECORDSIZE.
of just 32760 would fails.
permit recording 235
OLDSs.
Records that cannot exceed RECORDSIZE:
DB/AAuth 16 is the maximum
number of SSYSs.
LOGALL The SSYS record
would fill up first.

Record Size Warning Messages: Figure 10 on page 54 illustrates an example of

when the various warning messages would appear for the PRILOG record of online
OLDS data set. For the purposes of this example, a small RECON record size of
1000 is used, and the parameter values for the CHANGE.RECON command are:
CHANGE.RECON SIZALERT(4,1,50) LOGALERT(1,1)

Additional considerations to note for this example are:

v The fixed portion of the PRILOG record is 112 bytes.
v Assuming one volume per log data set entry, each data set entry is 160 bytes
long. Each additional volume adds 40 bytes.

Chapter 3. Initializing and Maintaining the RECON 53

Maintaining the RECON

Figure 10. Events Affecting PRILOG Records

Security Considerations for RECON

All jobs that access the RECONs must have control-level authority to the RECONs.
Control, rather than update-level authority, must be specified, because VSAM
issues VERIFY macros. VERIFY uses control interval processing.

Even jobs with read intent for databases using DBRC must have control-level
authority because even a job with read intent updates information on the RECON
header record.

Initial RECON Access

When a job needs to read the RECON, the RECON must be opened. When three
RECONs exist, DBRC determines which two are the active RECONs and which is
the spare data set. Table 4 on page 55 shows how this determination is made.
v RECONA, RECONB, and RECONC represent the RECON1, RECON2, and
RECON3 DD statements in no particular sequence.
v Data Set Status indicates the status of the data set during open time.
v Data Set Use indicates how DBRC assigns the data set.

54 DBRC Guide & Reference

Maintaining the RECON
Table 4. Determining Which RECONs Are Accessed
Case DD Statement Data Set Status Data Set Use DBRC Selection Criteria
1 RECONA Create Mode Copy1 Specify INIT.RECON command
RECONB Create Mode Copy2 Specify INIT.RECON command
RECONC Create Mode Spare
2 RECONA RECON Copy1 Current copy of RECON
RECONB Create Mode Copy2 Produced from Copy1
RECONC Create Mode Spare
3 RECONA RECON Copy1 Current copy of RECON
RECONB RECON Copy2 Current copy of RECON
RECONC Create Mode Spare
4 RECONA RECON Copy1 Current copy of RECON
RECONB RECON Unused Older copy than RECONA
RECONC Create Mode Copy2 Produced from Copy1
5 RECONA RECON Copy1 Current copy of RECON
RECONB RECON Unused Older copy than RECONA
RECONC RECON Unused Older copy than RECONA
6 RECONA RECON Copy1 Current copy of RECON
RECONB RECON Copy2 Current copy of RECON
RECONC RECON Unused Older copy than RECONA
7 RECONA RECON Copy1 Current copy of RECON
RECONB Create Mode Copy2 Produced from Copy1
8 RECONA Create Mode Copy1 Specify INIT.RECON command
RECONB Create Mode Copy2 Specify INIT.RECON command
9 RECONA RECON Copy1 Current copy of RECON
RECONB RECON Copy2 Current copy of RECON
10 RECONA RECON Copy1 Current copy of RECON
RECONB RECON Unused Older copy than RECONA
11 RECONA Create Mode None Discontinue processing
12 RECONA RECON Copy1 Current copy of RECON

Case 4 is the situation where two RECONs are available, but one is now out of
date. DBRC does not use the out-of-date RECON. Instead, it copies the up-to-date
RECON to the spare data set.

Only one RECON is available in cases 5, 10, and 12. If you have specified the
STARTNEW parameter of the INIT.RECON or CHANGE.RECON command, processing
continues with one RECON. Otherwise, processing ends.

Records in the RECON

The RECON contains many types of records. Some records, such as header
records, exist primarily to control RECON processing. Other records exist to define
the various data sets used in the recovery of DBDSs. Still others exist to record
events related to the use of DBDSs.

Figure 11 on page 56 shows the major relationships of RECON record types.

Chapter 3. Initializing and Maintaining the RECON 55

Maintaining the RECON

Figure 11. RECON Record Types

RECON Header Records

The RECON has three record types that contain control information DBRC uses in
its processing:
v RECON header
In addition to internal control information that DBRC creates and uses, the
RECON header record contains information provided by you in the parameters of
the INIT.RECON and CHANGE.RECON commands.
v RECON header extension
The RECON header extension record contains RECON configuration and state
data that DBRC uses to process the RECONs.
v RECON Time History Table (THT) Extension
The RECON THT extension contains a history of time-zone changes (such as
when the system time was changed to and from Daylight Savings Time) during
the period covered by the RECON. The THT is required for RECON migration
from pre-IMS/ESA Version 6 and must be maintained as long as pre-IMS/ESA
Version 6 systems share the RECON.

Log Data Set Records

Three types of log data sets exist. Each type can have a primary log record,
secondary log record, interim-primary log record, and interim-secondary log record.
Log data set records for each log data set are:
v Recovery log data set
– PRILOG (primary log record)
– SECLOG (secondary log record)
– IPRI (interim primary log record)
– ISEC (interim secondary log record)
v System log data set

56 DBRC Guide & Reference

Maintaining the RECON
– PRISLD (primary system log data set)
– SECSLD (secondary system log data set)
– PRITSLDS (primary RSR tracking site log data set)
– SECTSLDS (secondary RSR tracking site log data set)
– IPRISL (interim primary system log data set)
– ISECSL (interim secondary system log data set)
– IPRITSLD (interim primary RSR tracking site log data set)
– ISECTSLD (interim secondary RSR tracking site log data set)
v Online log data set
– PRIOLDS (primary online log data set)
– SECOLDS (secondary online log data set)
– IPRIOL (interim primary online log data set)
– ISECOL (interim secondary online log data set)

Log records come in sets called ″PRILOG families.″ A PRILOG family consists of a
PRILOG and one or more of the following: SECLOG, PRISLD, and SECSLD for a
given time period and IMS subsystem. All records in this set have the same start
and end times and normally have matching data set entries. The same LOGALL
record applies to all members of the set.

DBRC creates the PRILOG and PRISLD records whenever an online IMS opens
the first OLDS, and updates them each time an OLDS is archived. If you use dual
archiving, DBRC creates SECLOG and SECSLD records when the first OLDS is
archived and updates them each time an OLDS is archived.

Related Reading: See “Archiving Log Records” on page 43 for more information
about DBRC and the archiving of online logs.

Log data sets output from IMS batch jobs are recorded in PRILOG / SECLOG
records even though, technically, they are SLDSs. These records are created
whenever the output log is opened and updated when volume switches occur.

In addition, during Log Recovery processing, DBRC creates an IPRISL or IPRIOL

record for each interim primary-log data set and an interim secondary-log record for
each interim secondary-log data set whenever the Log Recovery utility runs. An
interim log record is an internal record that is used to reflect intermediate
processing of the DUP function of the Log Recovery utility.

Related Reading: See IMS Version 7 Operations Guide for more information
about interim primary and interim secondary-log data sets.

Although not part of normal DBRC operation, you can use the following commands
to create log records (for example, to set up a test environment or for RECON
repair purposes):
v NOTIFY.PRILOG
v NOTIFY.SECLOG

Database Recovery Records

In addition to the log data set records, the following types of records contain
database recovery information:
v Backout Record (BACKOUT)
v Change Accumulation Group Record (CAGRP)

Chapter 3. Initializing and Maintaining the RECON 57

Maintaining the RECON
v Change Accumulation Run Record (CA)
v Database Data Set Group Record (DBDSGRP)
v Database Records (DB)
– Database Record (DL/I and Fast Path)
– Fast Path Area Authorization Record
– DBDS (DL/I) / Area Recovery (FP) Record
v Global Service Group Record (GSG)
v Image Copy Record (IMAGE)
v Reorganization Record (REORG)
v Log Allocation Record (LOGALL)
v Database Allocation Record (ALLOC)
v Recovery Record (RECOV)
v Subsystem Record (SSYS)

Backout Record (BACKOUT): A BACKOUT record contains information about

units of recovery including time stamp, associated PSB name, recovery token, and
database name. The names of nonrecoverable databases are not stored in the
BACKOUT record.

Change Accumulation Group Record (CAGRP): A CAGRP record identifies a

change accumulation (CA) group. This record includes up to 2000 names of DBDSs
whose change records are accumulated during one run of the Database Change
Accumulation utility. Each DBDS (for which DBRC is controlling recovery) can be a
member of only one CA group in order for the Database Change Accumulation
utility to accumulate its changes. You specify this in the INIT.CAGRP command that
you use to create a CAGRP record in the RECON.

The CAGRP record contains the name of a member of a partitioned data set. This
member contains the skeletal JCL that is to be used to generate the JCL to run the
Database Change Accumulation utility for this CA group. The CAGRP record also
contains an indicator that specifies whether change accumulation data sets that
correspond to this group can be reused. It also contains an indication of the
maximum number of change accumulation data sets that are to be maintained for
the group.

Change Accumulation Run Record (CA): For each CAGRP record, there can be
up to 1024 CA records. A CA record contains information about a change
accumulation data set and can be either available or in use.

An available CA record is created by an INIT.CA command. This CA record

contains the volume serial numbers and the data set name of a data set that is to
be used for output from a subsequent run of the Database Change Accumulation
utility. You can create available CA records only for those CA groups that are
defined with the REUSE parameter.

An in-use change accumulation record is created by a run of the Database Change

Accumulation utility. It can be a formerly available CA record that was used during a
run of the Database Change Accumulation utility, or it can be a new record with
information obtained from the JCL. The information in an in-use change
accumulation record includes:
v Data set name
v Volume serial numbers

58 DBRC Guide & Reference

Maintaining the RECON
v Run time of the Change Accumulation utility
v Stop time of the last log volume that the Database Change Accumulation utility
processed; or, if the CA processed a subset of logs, the start time of the first log
that should be processed on the next execution
You can use a NOTIFY.CA command to create a CA record.

Data Group Record (DBGRP, DBDSGRP, RECOVGRP): You can use a

DBDSGRP record to define the following types of named groups:
v DBDSGRP, a group of DBDSs and DEDB areas
v DBGRP, a group of DL/I DBs and DEDB areas that can be named in the
DATAGROUP parameter for the /STA, /STO, and /DBR commands
v RECOVGRP, a group of DL/I DBs and DEDB areas that are logically related for
ORS purposes

All groups must have unique names. For example, a DBDSGRP cannot have the
same name as a DBGRP.

You use the INIT.DBDSGRP, CHANGE.DBDSGRP, DELETE.DBDSGRP, and LIST.DBDSGRP

commands to manipulate all three data group types.

Recommendation: Although any type of group can be named in the DATAGROUP

parameter for the /STA, /STO, and/DBR commands, the use of a DBDSGRP is not
recommended because it is inefficient.

Related Reading: See “Using DBDS Groups” on page 18 for more information on
DBDS groups.

Database Records (DB): DBRC treats DL/I, Fast Path, and HALDB (High
Availability Large Database) database records differently. These types of records,
their treatment, and contents are explained in this section.

DL/I Database Records: A DB record identifies a database that is registered and

whose recovery is under the control of DBRC. This record contains information
about the database and related recovery information including:
v Database name
v Database type
v Share level of database
v List of subsystems using the database
v Extended Error Queue Element (EEQE) counter
v IRLM identification of the first subsystem that authorized the database (if IRLM is
used)

A DBDS record identifies a DBDS whose recovery DBRC is to control. This record
contains information about the DBDS (such as its data set organization) and related
recovery information including:
v Name of the CA group to which the DBDS belongs
v Maximum number of image copy data sets to be maintained for this DBDS
v Indication of whether image copy data sets are to be reused
v Period of time that image copy data sets are to be maintained for this DBDS
v Name of the implied skeletal JCL default member
v Extended Error Queue Elements (EEQEs)

Chapter 3. Initializing and Maintaining the RECON 59

Maintaining the RECON
v Names of the members of the partitioned data set of skeletal JCL to be used in
order to generate JCL for utilities that are run for this DBDS

To describe DL/I databases and DBDSs, DBRC has a logical structure of records,
as shown in Figure 12.

Figure 12. DBRC DL/I Records

HALDB Records: From a RECON data set perspective, HALDBs consist of a

HALDB master (TYPE=HALDB) and one or more HALDB partitions (TYPE=PART).

Figure 13 shows the relationship of the new or changed RECON data set records
that represent a HALDB.

Figure 13. RECON Record Structure for a HALDB

HALDB Master (DSPDBHRC)

The RECON data set stores information pertaining to the entire HALDB by using a
DB header record. The DB header record includes the following:
v HALDB master name
v TYPE=HALDB
v Partition Selection exit routine name
v Number of partitions in the HALDB

60 DBRC Guide & Reference

Maintaining the RECON
v Data Set Group count
v Current Partition ID
v Current change version number
v Global DMB number
v Share Level
v RSR Global Service Group Name and tracking level
v RECOVABL | NONRECOV

The TYPE=HALDB DB record stores information about the HALDB. Applications

conduct DB activity at the HALDB master level; DBRC conducts the DB activity at
the HALDB partition level. A subsystem authorizes a HALDB partition, not a HALDB
master.

HALDB Partition

Each partition of the HALDB consists of the following RECON data set records:
v Partition record (DSPPTNRC)
DSPPTNRC contains information that applies to the individual partition. The
HALDB Partition Definition utility displays the partition record information. The
LIST command does not display the partition record.
v Partition DB record (DSPDBHRC)
DSPDBHRC accesses the HALDB at the partition level. Like the TYPE=IMS DB
record, the DB record for the HALDB partition records all sharing and recovery
information. The partition name sets the database name field in this record.
TYPE=PART has been defined for this record. The following fields have the same
settings for each partition across the entire HALDB:
– Global DMB number
– Share Level
– RSR Global Service Group Name and tracking level
– RECOVABL | NONRECOV
– HALDB master name
v Partition DBDS records (DSPDSHRC)
Depending on the organization of the HALDB, there can be three types of
DBDSs for each HALDB partition: data, index, and ILDS data sets. Multiple data
DBDSs can exist, but only one of each of the others. Only data DBDSs can be
recovered. The other DBDSs are rebuilt using the HALDB Index/ILDS Rebuild
utility (DFSPREC0).
Related Reading: See IMS Version 7 Administration Guide: Database Manager
for information about the data set and DDN naming conventions for DBDS
records.

Fast Path Database Records: To describe DEDBs, AREAs, and AREA Data Sets
(ADSs), DBRC has a logical structure of records, as shown in Figure 14 on
page 62.

DBRC uses the DB and DBDS records to describe both DL/I databases and
DEDBs; however, DBRC adds an ADS list to the Fast Path DBDS record giving
information about each ADS. Each DEDB may contain multiple areas, and each
area may contain up to seven ADSs.

The Fast Path DB record contains information similar to the information in a DL/I
DB record, except that it describes a DEDB; and it does not contain a list of

Chapter 3. Initializing and Maintaining the RECON 61

Maintaining the RECON
authorized subsystems. For Fast Path, this list is in the DBDS record, which is
composed of an area authorization record and an area recovery record. The Fast
Path DB record is displayed in the listing as the DBDS record.

When an Area is registered in RECON, it ensures that:

v The area names in the DEDB are unique
v The ADS ddnames in an area are unique
v No more than seven ADSs are defined for an area

Figure 14. DBRC Fast Path Database Records

Global Service Group Record (GSG): GSG record defines a global service group
and the service groups that make up the GSG. An RSR service group is made up
of two service groups: the active and the tracker.

GSG records are created by the INIT.GSG command and can be deleted by the
DELETE.GSG command. The INIT.SG and DELETE.SG commands add and remove
service group definitions to and from the GSG record. The CHANGE.SG command
modifies information about a service group.

Image Copy Record (IMAGE): An IMAGE record contains information about an

image copy data set and can be either available or in-use.

An available IMAGE record is created by an INIT.IC command. It describes data

sets that are to be used for output from a subsequent run of an image copy utility.
You can create available IMAGE records only for those DBDSs that are defined with
the REUSE parameter.

An in-use IMAGE record is created by an execution of an image copy utility:

v If the DBDS or area is defined with REUSE, it is a formerly available IMAGE
record or a reused in-use record.
v If the DBDS or area is defined with NOREUSE, it is a new record with the data
set description that is obtained from the JCL.

In addition to the data set description, the in-use IMAGE record identifies the type
of copy operation and contains the copy operation’s run time and, depending on the
type of copy, the copy operation’s stop time.

62 DBRC Guide & Reference

Maintaining the RECON
If you request that the image copy utility create an image copy data set and a
duplicate image copy data set, DBRC records information about both in the same
image copy record. The first record is designated IC1, and the duplicate is
designated IC2.

If you create a nonstandard image copy data set (one that the image copy utility did
not create), you must use a NOTIFY.UIC command to record its existence in the
RECON.

Related Command: See the NOTIFY.UIC command for more information on the
IMAGE COPY record.

Reorganization Record (REORG): DBRC creates a REORG record each time

you run the HISAM Reorganization Reload utility or HD Reorganization Reload
utility for a registered DBDS. DBRC creates a REORG record in the RECON for
each DBDS that you reorganize.

Related Command: See the NOTIFY.REORG command for more information on the
REORG record.

Log Allocation Record (LOGALL): DBRC creates a log allocation (LOGALL)

record for each PRILOG record. A LOGALL record identifies the registered DBDSs
that were changed while the corresponding log data set was open.

Database Allocation Record (ALLOC): For Fast Path, DBRC creates an ALLOC
record when the area is placed in OPEN-for-update status. For DL/I, DBRC creates
an ALLOC record when IMS updates a DBDS the first time during a run of IMS or
the first time after you enter a /DBRECOVERY command. This record contains the time
stamp of its creation and the time stamp of the opening of the corresponding log.
This time stamp identifies the log data sets containing the database change records
that are needed for recovery. If the DBDS is subsequently deallocated, DBRC adds
the time stamp of the deallocation to the ALLOC record.

DBRC automatically deletes allocation records if they are older than the oldest
image copy record and if DBRC no longer needs them for database recovery. As
DBRC deletes an ALLOC record, it changes the associated LOGALL record. This is
part of the DBRC Image Copy utility exit routine processing. This automatic deletion
of ALLOC records for a DBDS does not occur under either of the following
conditions:
v The ALLOC record has no deallocation time.
A deallocation time is recorded when the database or area has had the /DBR
command run against it. Otherwise, the ALLOC record uses the log close time as
an implicit deallocation time.
v The PRILOG record associated with the ALLOC record is open (it has a
STOPTIME of zero) but is not marked in error.
In cases such as these, you can use the DELETE.ALLOC command to delete
unwanted ALLOC records from RECON. DBRC automatically updates allocation
timestamps during online and concurrent image copy utility exit routine processing
to move the allocation timestamps forward in time.

Related Command: See the DELETE.ALLOC and the NOTIFY.ALLOC commands for
more information on the ALLOC record.

Chapter 3. Initializing and Maintaining the RECON 63

Maintaining the RECON
Recovery Record (RECOV): DBRC creates a RECOV record each time you run
the Database Recovery utility to recover a DBDS. The RECOV record can indicate
one of these types of recovery:
v A full recovery of a DBDS where the RECOV record contains the time stamp of
the recovery.
v A timestamp recovery where the RECOV record contains the time stamp of the
run of the Database Recovery utility and the time stamp to which the DBDS was
recovered.

Related Command: See the NOTIFY.RECOV command for more information on the
RECOV record.

Subsystem Records (SSYS): RECON uses the subsystem (SSYS) record to

describe data sharing information.

An SSYS record is created when an IMS subsystem signs on to DBRC. This SSYS
record contains information about the subsystem and related recovery information
including:
v Subsystem name and type (online or batch)
v IRLM identification
v Abnormal-end flag and the recovery-process start flag
v List of authorized databases
v Time stamp that correlates the subsystem entry with the appropriate log records

Related Command: See the NOTIFY.SUBSYS command for more information on the
SSYS record.

Maintaining the RECONs

You should perform periodic maintenance on the RECONs to maintain data integrity
and an acceptable level of performance. Maintenance of the RECONs falls into
these categories:
v Backing up copies
v Reorganizing the data sets
v Extending the data sets to obtain more space when necessary
v Deleting unnecessary RECON log records
v Compressing the PRILOG record
v Replacing a damaged RECON
v Replacing a discarded RECON
v Recovering the RECON

Backing Up RECON
Back up the RECONs frequently. They are a critical resource. Always make backup
copies of RECON after performing any RECON record maintenance, such as
registering databases and adding or deleting change accumulation groups.

Use the BACKUP.RECON command to perform backup. This command issues the
necessary RESERVE commands (reserving the device during backup processing) to
ensure backup integrity. Then it invokes the AMS REPRO command to copy the data
set. The BACKUP.RECON command copies only the first copy of the RECON. Its
parameters determine whether it makes one or two copies.

64 DBRC Guide & Reference

Maintaining the RECON
Related Reading: See “Chapter 8. BACKUP Command” on page 111 for additional
information on the BACKUP.RECON command.

Deleting Unnecessary RECON Log Records

You can delete unnecessary RECON records using the following methods:
v Automatic deletion by RECON
v PRILOG compression
v Manual log record deletion

Automatic Deletion of Extraneous Records: Normally you should not need to

perform much record maintenance for database-related records.

When RECON is notified of an image copy, it may delete or reuse the oldest in-use
IMAGE record, and a later IMAGE record becomes the oldest IMAGE record.
RECOV and REORG records with start times earlier than the (now) oldest IMAGE
record, and ALLOC records with DEALLOC times earlier than that, are now
extraneous, and are deleted from RECON. This is the image copy cleanup process.

At the same time that extraneous IMAGE records are deleted from RECON, all
active ALLOC records are updated to the time of the first log volume necessary for
recovery, based on the oldest image copy for the DBDS or area. When the cleanup
process deletes an extraneous ALLOC record it changes the state of the associated
LOGALL records. Once all the ALLOC records associated with the LOGALL record
have been deleted (this may take place over many image copies for many
databases), the PRILOG record associated with the LOGALL record becomes
inactive.

Compressing the PRILOG Record: PRILOG record compression is the deletion

of all inactive data set entries in the PRILOG record. A data set entry is defined as
being inactive when it is older than all of the following criteria:
v Log retention period
v Oldest allocation (ALLOC) for any database updated on that log
v Earliest restart checkpoint for the online IMS

PRILOG record compression deletes inactive data set entries up to the oldest
ALLOC on the log or the first gap in the data set entries. A gap occurs when an
OLDS has not yet been archived.

When inactive data set entries are deleted from active PRILOGs, they are
compressed to a single dummy data set entry that has the same start time as the
start time of the log and the same stop time as the stop time of the last inactive
data set entry deleted.

Automatic PRILOG Compression: PRILOG record compression is attempted

automatically after an OLDS has been archived or after a CICS log EOV call is
used. At an RSR (remote site recovery) tracking site, automatic compression is
attempted when a tracking log data set is opened by Log Router and recorded in
RECON.

If the size of the PRILOG record exceeds a threshold percentage of the maximum
RECON defined record size, then the PRILOG record is compressed. This
compression includes the deletion of all inactive data set entries in the PRILOG
record. When applicable, corresponding entries in the SECLOG, PRISLD, and
SECSLD records are also deleted.

Chapter 3. Initializing and Maintaining the RECON 65

Maintaining the RECON
Automatic PRILOG record compression occurs only if the size of the log exceeds
the threshold value. Two threshold values are used: 50% and 75% of the maximum
RECON defined record size. If the log cannot be compressed to the current
threshold value, the threshold value is increased to the 75% value. Likewise, if the
log can be compressed below the 75% threshold, PRILOG compression is
attempted at every OLDS switch.

Manual Process for PRILOG Compression: You can initiate PRILOG record
compression manually by using the DELETE.LOG INACTIVE command. This command
deletes inactive data set entries from active PRILOG records and deletes entire
inactive PRILOG records, regardless of whether the PRILOG record exceeds the
current threshold size.

Deleting Log Records: DBRC does not automatically delete RECON records that
describe log data sets (PRILOG and SECLOG records). This design gives you
control over which RECON records associated with log data sets are deleted. You
must periodically delete PRILOG and SECLOG records that are no longer needed
for recovery.

Use the DELETE.LOG INACTIVE command to delete inactive PRILOG and SECLOG
records.

Deleting log records does not prevent the RECONs from filling up because the
space freed by deletions may not be reused by VSAM. However, if you delete the
log records before backing up or reorganizing RECON, you are able to reclaim the
space during backup or reorganization.

Related Reading:
v See “DELETE.LOG (for OLDS)” on page 177 for more information on LIST.LOG.
v See “LIST.LOG (for a PRILOG Family)” on page 254 for more information on
DELETE.LOG.

Reorganizing RECON
You need to reorganize the RECONs periodically. Many of the record keys in
RECON include the date and time. DBRC recording of IMS log and database
activity can cause CI and CA splits, that can degrade performance. In addition,
deleting unnecessary records may not prevent RECON from filling up because
VSAM does not always reuse the space freed.

You can reorganize a RECON online if you are using dynamic allocation for the
RECON. A spare RECON must be available. In this situation, you can issue the
CHANGE.RECON command with the REPLACE option. This causes DBRC to copy and
reorganize the active RECON specified on the CHANGE command to the spare data
set. VSAM removes all CI and CA splits, and restores the original FREESPACE
attributes.

The CHANGE command also deallocates the old RECON (the one that needed
reorganization). However, before you can delete and redefine this data set, you
must wait for all other subsystems that are using it to deallocate it. If you redefine
the data set with the same name it originally had, it is available to the online system
for use as a spare data set. You can repeat this process to reorganize the second
active RECON. If you use JCL in order to allocate data sets, dynamic deallocation
does not occur.

66 DBRC Guide & Reference

Maintaining the RECON
If you do not use dynamic allocation or if a spare RECON is not available, you must
wait for the online subsystem and all other subsystems that access RECON to
deallocate it before you can reorganize.

Recommendation: Back up RECONs before and after reorganizing, using the

following procedure:
1. Copy the RECONs to temporary data sets with different data set names.
2. Verify that the copied data sets are uncorrupted.
3. Delete the original data sets.
4. Redefine the original data sets using the same data set names.
5. Copy the temporary data sets back to these original data sets.

RECON Reorganization Procedure

To clean up your logs and reorganize your RECONs, following this procedure. This
process assumes that you are running DBRC in dual mode with RECON1 (as
Copy1), RECON2 (as Copy2), and a spare.
1. Issue a LIST.LOG OPEN command to identify any open logs. Determine which of
the identified logs should be open, and which should be closed or deleted.
Close any logs that should be closed or deleted.
2. Issue a DELETE.LOG INACTIVE command to delete any inactive or unused logs.
You are now ready for the RECON reorganization.
3. Issue a CHANGE.RECON with the REPLACE option for RECON1. DBRC signals the
start of RECON reconfiguration with message DSP0380I, identifies the
subsystems that are ″active″ at reconfiguration with message DSP0388I, and
signals that the process has completed with message DSP0381I.
4. Issue either an /RMLIST DBRC=’RECON STATUS’ or /DISPLAY OLDS command on all
of the IMS subsystems that are sharing the RECON. Issuing this command will
cause the IMS subsystems to detect that a RECON reconfiguration has
occurred and to deallocate RECON1. If the CHANGE.RECON REPLACE was
issued as an online command, the IMS subsystem that processed the command
has already reconfigured and does not need a /RMLIST or /DISPLAY OLDS
command.
5. Run IDCAMS DELETE and DEFINE CLUSTER procedures for RECON1.
6. Repeat steps 3, 4, and 5 for RECON2.
7. Repeat steps 3, 4, and 5 for the spare RECON.
Your log clean up has been performed, and your RECONs have now been
reorganized.

Replacing Damaged RECONs

If an I/O error occurs in the current RECON that is the only one remaining, DBRC
stops the job. Any other jobs that are currently using the RECON continue to run if
no other I/O error is encountered.

If an I/O error occurs in a RECON and two RECONs exist, DBRC attempts to
locate a spare data set. If a spare is available, DBRC copies the RECON without
the I/O error to the spare RECON. DBRC then establishes the spare as the Copy2
RECON.

After the spare RECON replaces the RECON that has the error, redefine the
discarded RECON as quickly as possible. If you immediately replace the RECON
with the I/O error, you are unlikely to experience a subsystem failure due to loss of
all RECONs.

Chapter 3. Initializing and Maintaining the RECON 67

Maintaining the RECON
If DBRC cannot locate a spare RECON and you have specified the STARTNEW
parameter of the INIT.RECON command, DBRC continues processing with one
RECON. Otherwise, DBRC completes the current job but does not start new jobs
until you define a spare RECON.

Recovering the RECON

If an I/O error occurs on a RECON and a spare data set is available, DBRC copies
the good RECON to the spare, and then activates the spare. As soon as other
subsystems that are still using the failed RECON (identified in message DSP0388I)
have completed their processing, you can delete and redefine the RECON with the
error so that it can be used as a spare. If, however, you want to analyze the
RECON error, you should allocate new space for the RECON, rather than deleting
and redefining it.

If a spare RECON is not available, all currently executing jobs continue processing
using the RECON in single mode. If you specified the STARTNEW parameter in the
INIT.RECON or CHANGE.RECON command, DBRC allows new jobs to start with only
one RECON. This is not recommended as it jeopardizes the integrity of the system.

If one of the data sets in the set of RECONs becomes unusable by DBRC, you
need to deallocate the RECON that is unusable and allocate a new spare.

In an RSR environment, the isolated log sender (ILS) starts its own copy of DBRC.
You might need to stop ILS to terminate the DBRC in the transport manager
address space. This causes the ILS’s DBRC to deallocate the RECONs so you can
replace the unusable RECON. Issue STOP ILS(gsg) for each started ILS instance.
Then issue START ILS(gsg) to bring up ILS and DBRC again.

What to Do If Both RECONs Are Unusable:

It is unlikely that both RECONs would be unusable; however, if both RECONs ever
become unusable, follow this procedure:
1. Stop all jobs that require access to the RECON.
2. Use the AMS REPRO command to back the RECONs up if you can access both
of them. This step is optional. You should do it, though, so that regardless of
what happens, you are no worse off than you were at the start of this
procedure.
3. Use the AMS utility to delete and redefine your RECONs.
4. Use the AMS REPRO command to restore one of the RECONs.
5. Use the AMS REPRO command to restore the other RECON from the first.
6. Use the LIST.RECON command to list one of the RECONs. Evaluate the list and
determine which DBDSs have been updated since you made the backup in step
2. If you cannot determine which DBDSs have been updated, assume that all
have been updated.
7. Use the CHANGE.IC command with the INVALID parameter to mark all image
copy records that are in error for all applicable DBDSs in step 6.
8. Make an image copy of all applicable DBDSs in step 6.
9. Use the BACKUP.RECON command to make a backup copy of the RECONs.

The RECONs are now restored and resynchronized with the databases.

If you do not control an excessive number of databases, it may be easier to follow

this procedure:
1. Stop all jobs that require access to the RECON.

68 DBRC Guide & Reference

Maintaining the RECON
2. Define new RECONs.
3. Initialize these RECONs.
4. Register the environment (always keep a backup copy of the most recently
initialized, but not-yet-used, RECON available).
5. Take image copies of all databases.

Finally, before you proceed with your regular operations, clean up the new RECON
by, for example, closing any open, out-of-date OLDSs with the NOTIFY.PRILOG
command.

Replacing a Discarded RECON

DBRC detects that a RECON is discarded only when some activity occurs that
causes DBRC to access the RECONs. You can have multiple instances of DBRC
whenever you have multiple IMS subsystems, online or batch. You cannot delete
and redefine a discarded RECON until all instances of DBRC detect that a change
has occurred and they deallocate the discarded data set. DBRC lists the
subsystems that are ″active″ at reconfiguration in message DSP0388I. This
message enables you to identify the subsystems that might need your help in
detecting the status change of the RECONs.

To redefine a RECON after an I/O error has occurred, or in conjunction with the
CHANGE.RECON REPLACE command, follow this procedure:
1. Allow all batch jobs using DBRC to finish.
2. Issue LIST.RECON STATUS in all online subsystems. This causes the online
subsystems to obtain the same Copy1 and Copy2 RECONs and to deallocate
the discarded RECON.
3. Use the AMS DELETE command to delete the discarded RECON.
4. Use the AMS DEFINE command to recreate the RECON as an empty VSAM
KSDS data set. Use the same procedure that you used originally to create the
RECON. See “Creating a RECON” on page 50.

Chapter 3. Initializing and Maintaining the RECON 69

Maintaining the RECON

70 DBRC Guide & Reference

Chapter 4. RECON Upgrade Utility (DSPURU00)
In This Chapter:
v “Before You Start”
v “Upgrade Procedure”
v “JCL Requirements” on page 73
v “Upgrade Utility Return Codes and Message Information” on page 73

What Is the RECON Upgrade Utility?

The RECON Upgrade utility converts a RECON from IMS/ESA Year 2000 Local
DL/I or Version 5 to the format required for Version 7.

To convert a RECON from IMS/ESA Version 6 to the format required for Version 7,
use the CHANGE.RECON UPGRADE command.

Related Reading: See section “CHANGE.RECON” on page 147 and the for more
information about Version 6 to Version 7 RECON conversion.

Before You Start

The steps listed below must be performed while no other subsystems, batch jobs,
or utility jobs are accessing the RECON. All such jobs must be completed or
terminated before the upgrade process is initiated.

Requirement: In order for pre-Version 7 subsystems and jobs to access the

upgraded RECON, the coexistence SPE must be applied.

© Copyright IBM Corp. 1974, 2001 71

RECON Upgrade
2. Use your current release of IMS to issue a LIST.SSYS command. If any SSYS
records are listed, determine why they exist and take the appropriate action to
remove them before proceeding.
3. Make a backup copy of the RECON. Using your current release of IMS, issue
the BACKUP.RECON BOTH command, ensuring that the data set is KSDS format.
This copy is input to the Upgrade utility and can be used to restore the original
RECON in case of a failure in the following steps.
Attention: If you have old PRILOG/SECLOG records in RECON, your upgrade
may fail with a DSP03431 time conversion failure message. You can delete old
PRILOG/SECLOG records prior to doing the upgrade.
4. Install the new version of IMS.
5. Delete and redefine the RECON1, RECON2, and RECON3 data sets as empty
data sets, each with a 32-byte key, using AMS.
6. Issue the following DBRC command to initialize the RECONs (defined in the
preceding step) and create the Time History Table (THT).
Attention: The THT is required for RECON migration and must be maintained
as long as pre-IMS Version 6 systems share the RECON.
The INIT.RECON command requires the two empty RECONs to run successfully.
INIT.RECON UPGRADE

The UPGRADE parameter allows the new RECON to be used only by the
RECON Upgrade utility until the upgrade has successfully completed.

Related Reading: See the Migrating DBRC section in the IMS Version 7
Release Planning Guide for more information on THT migration
recommendations.
7. Run the RECON Upgrade utility to convert the RECON. If the utility runs
successfully, continue to the next step. If the utility fails, see the return code.
Code Meaning
8 The upgrade process could not be started; the new RECON has not yet
been changed.
v Correct the problem.
v Repeat this step.
12 The upgrade process completed but one or more records had
timestamp fields containing invalid data. To identify the invalid data see
the text of messages DSP0343I and DSP0350I.
v Determine the necessary corrective action and whether to use the
new RECON or correct the old one. If you choose to correct the old
RECON, do so, then repeat this process from 5.
16 The new RECON has been partially written.
v Correct the problem.
v Repeat the process beginning at Step 5.

Attention: RECON records have increased in length. Consequently, the

RECON Upgrade utility might fail with a “RECON RECORD TOO LONG”
message. If so, return to Step 5, specifying a larger RECORDSIZE value for
RECON1.

72 DBRC Guide & Reference

RECON Upgrade
8. Delete and redefine RECON2 and RECON3 data sets as empty data sets, each
with a 32-byte key, using AMS. The next time DBRC accesses the upgraded
RECON1 data set, DBRC copies its contents to one of these empty data sets,
identifying the new copy as COPY2. The other defined data set is available as a
spare. A batch job that issues the LIST.RECON STATUS command can be used to
perform the copy operation.

Input and Output

Figure 15 shows input to and output from the RECON Upgrade utility.

Figure 15. RECON Upgrade Utility Input and Output

JCL Requirements
The RECON Upgrade utility runs as a standard MVS job. A job statement, which
you define, an EXEC statement, and DD statements are required:
EXEC
Specifies the utility DSPURU00 and a region size of at least 4096 KB.

The following DD statements are used to define inputs and outputs that are
required:
SYSPRINT DD
Specifies a sequential message data set. The data set can reside on a tape,
DASD volume, or printer, or it can be routed through the output stream.
BACKUP1 DD
Specifies the copy of the old RECON created at Step 3 on page 72.
RECON1 DD
Specifies the redefined RECON (from Step 5 on page 72) which is to be
updated. Neither a RECON2 nor RECON3 DD statement can be specified.

Upgrade Utility Return Codes and Message Information

The RECON Upgrade utility issues the following return codes:
Code Meaning
0 The operation completed successfully. The RECON is upgraded.
8 The operation was not performed. Possible reasons:

Chapter 4. RECON Upgrade Utility (DSPURU00) 73

RECON Upgrade
v The input BACKUP1 data set could not be upgraded, so the output data
set has not been changed. Refer to the message log that was written to
the SYSPRINT data set for information on the cause of the error.
v The output RECON1 data set was not suitable for upgrade. The data set
may have been left in an unacceptable state following a previous
upgrade attempt. Refer to the message log that was written to the
SYSPRINT data set for information on the cause of the error.
12 The upgrade process completed, but one or more records had timestamp
fields containing invalid data that is identified by messages DSP0343I and
DSP0350I.
16 The RECON1 data set was left in a partially upgraded state; an error
occurred while upgrading it. Refer to the message log that was written to
the SYSPRINT data set for information on the cause of the error.

Related Reading: See the IMS Version 7 Messages and Codes, Volume 1 for
more information on RECON Upgrade utility messages.

Example of RECON Upgrade Utility JCL

The RECON Upgrade utility processes the RECON IMS.RECON1. An example of a
job to execute the RECON Upgrade utility with a JOBLIB statement is shown:
//UPGRADE JOB (place your job parameters here)
//JOBLIB DD DSN=IMS71.SDFSRESL,DISP=SHR
//DOIT EXEC PGM=DSPURU00,REGION=4096K
//SYSPRINT DD SYSOUT=A
//BACKUP1 DD DSN=IMS.RECONX,DISP=OLD
//RECON1 DD DSN=IMS.RECON1,DISP=OLD

The RECON Upgrade utility processes the RECON IMS.RECON1. The following
example is for a job which can be used to execute the RECON Upgrade utility with
a STEPLIB statement:
//UPGRADE JOB (place your job parameters here)
//DOIT EXEC PGM=DSPURU00,REGION=4096K
//STEPLIB DD DSN=IMS71.SDFSRESL,DISP=SHR
//SYSPRINT DD SYSOUT=A
//BACKUP1 DD DSN=IMS.RECONX,DISP=OLD
//RECON1 DD DSN=IMS.RECON1,DISP=OLD

74 DBRC Guide & Reference

Chapter 5. Database Recovery Control Utility (DSPURX00)
In This Chapter:
v “Input and Output”
v “Example of DBRC Utility JCL” on page 76
v “JCL Requirements” on page 76

What Is the Database Recovery Control Utility (DSPURX00)?

The DBRC utility supports commands that build and maintain the RECON, add
information to the RECON, and generate jobs for utilities.

Commands submitted to the DBRC utility have the same general format. Each
command is composed of a verb and a modifier, separated by a period and
followed by parameters.

Input and Output

Figure 16 shows the I/O requirements for DBRC. Notes on the figure follow.

Figure 16. Database Requirements for the DBRC

Notes to Figure 16:

The input to DBRC is:

1. The DBRC command
2. The RECON
3. The PDS, which contains the JCL and control statements for the utility that
DBRC uses to generate a job

© Copyright IBM Corp. 1974, 2001 75

Database Recovery Control Utility
4. The data set that contains the database descriptions for the databases that are
to be placed under the control of DBRC

The output from DBRC is:

5. Jobs created by GENJCL commands
6. The RECON, which may have been updated by the utility
7. One or more of the following:
v A listing of the input commands
v Informational messages associated with their execution or diagnostic
messages explaining any failures and return codes
v A listing of each job that was created in the case of GENJCL commands

Example of DBRC Utility JCL

This sample job initializes the RECON and registers one database with two DBDSs:

//INITRCON JOB
1 //INIT04 EXEC PGM=DSPURX00
2 //STEPLIB DD DSN=IMS.SDFSRESL
3 //SYSPRINT DD SYSOUT=A
4 //*
5 //IMS DD DSN=IMS.DBDLIB
6 //JCLPDS DD DSN=IMS.JCLPDS
7 //JCLOUT DD DSN=IMS.JCLOUT
8 //SYSIN DD *
9 INIT.RECON SSID(IMS3)
10 INIT.DB DBD(DBDESDS1) SHARELVL(2)
11 INIT.DBDS DBD(DBDESDS1) DDN(DDNESDSA) GENMAX(3) -
REUSE DSN(IMS.DBDESDS1.DDNESDSA.DSN) -
ICJCL(MYIC) RECOVJCL(MYRECOV) -
12 INIT.IC DBD(DBDESDS1) DDN(DDNESDSA) -
ICDSN(IMS.*.ICDSN1)
INIT.IC DBD(DBDESDS1) DDN(DDNESDSA) -
ICDSN(IMS.*.ICDSN2) ICDSN2(IMS.*.ICDSN2)
INIT.IC DBD(DBDESDS1) DDN(DDNESDSA) -
ICDSN(IMS.*.ICDSN3)
//*
13 INIT.DBDS DBD(DBDESDS1) DDN(DDNESDSB) GENMAX(4) -
NOREUSE DSN(IMS.DBDESDS1.DDNESDSB.DSN)
//*
14 INIT.CAGRP GRPNAME(CAGRP1) GRPMAX(2) REUSE -
GRPMEM((DBDESDS1,DDNESDSA),(DBDESDS1,DDNESDSB))
15 INIT.CA GRPNAME(CAGRP1) CADSN(IMS.*.CADSN1) -
VOLLIST(CAVOL1,CAVOL2,CAVOL3) FILESEQ(4)
INIT.CA GRPNAME(CAGRP1) CADSN(IMS.*.CADSN2) -
VOLLIST(CAVOL4)
/*

Figure 17. Inputs and outputs of the DBRC Utility

JCL Requirements
The DBRC utility runs as a standard MVS job. The numbers below refer to the JCL
statements illustrated in the previous example.
1. EXEC Indicates the program to be executed.
2. STEPLIB Points to IMS.SDFSRESL, which contains the IMS nucleus and the
required action modules.

76 DBRC Guide & Reference

Database Recovery Control Utility
3. SYSPRINT Defines the destination of DBRC diagnostic messages and the
listing output. The destination can be a tape or DASD data set, a
printer, or it can be routed through the output stream (SYSOUT).
4. RECON DD statements for RECON1, RECON2, and RECON3 are omitted
so that RECON is allocated dynamically.
| 5. IMS Defines the IMS DBDLIB data set. It is required only for the
| INIT.PART commands; the INIT.DBDS commands; the NOTIFY.REORG
| commands; the INIT.DB command, if you are initializing a HALDB;
| and the CHANGE.DBDS commands, if you change a DBDS ddname or
| area name.
6. JCLPDS, or the DD name you supply with the JCLPDS parameter
Defines the PDS containing skeletal JCL members. It is required
only for the GENJCL commands.
7. JCLOUT, or the DD name you supply with the JCLOUT parameter
Defines the data set which is to receive generated JCL. It is
required only for the GENJCL commands.
8. SYSIN Defines the source of input commands. SYSIN can be a tape or
DASD data set, a card reader, or it can be routed through the input
stream (DD * or DD DATA.)

Following are the input command statements:

9. INIT.RECON
Initializes the RECON with control information and a default
subsystem name of IMS3.
10. INIT.DB Registers a database with sharing level 2.
11. INIT.DBDS Identifies a DBDS for the database. It is to have a maximum of
three image copy data sets, which are to be predefined and are to
be reused when the GENMAX value is exceeded. GENJCL.IC and
GENJCL.RECOV commands issued for this DBDS uses the
user-specified skeletal JCL members of the JCLPDS instead of the
default members ICJCL and RECOVJCL.
12. INIT.IC Commands identify data sets to receive image copies of the DBDS
that was just defined. The data set names are specified using the
naming convention described in “Data Set Naming Conventions” on
page 21. The ICDSN2 parameter on the second INIT.IC command
identifies a duplicate image copy data set.
13. INIT.DBDS Identifies a second DBDS for the database, for which a maximum
of four image copies is to be maintained. Image copy data sets are
not reused, but are deleted when the GENMAX value is exceeded.
14. INIT.CAGRP
Defines a change accumulation group that includes the two DBDSs
just defined. A maximum of two change accumulation data sets is to
be maintained for this group, which are to be predefined and
reused when the GRPMAX value is exceeded.
15. INIT.CA Commands identify change accumulation data sets that are
available for future use by the CA group just defined. They are
named according to the naming convention described in “Data Set
Naming Conventions” on page 21.

Chapter 5. Database Recovery Control Utility (DSPURX00) 77

Database Recovery Control Utility

78 DBRC Guide & Reference

Chapter 6. Hints and Tips for DBRC
This chapter provides task-oriented instructions for frequently-used procedures,
including the following topics:

In This Chapter:
v “Locating the Last SLDS Stop Time in RECON”
v “Adjusting GENMAX When It Is Reached or It Is Too High” on page 80
v “Getting PRILOG Compression to Work” on page 82
v “PRILOG Record Sizes” on page 82
v “Using NOTIFY.PRILOG to Close an Open Online PRILOG” on page 83
v “Deleting Log Records” on page 84
v “Working with Subsystem Records (SSYS)” on page 84
v “Removing Authorization Inconsistency between the SSYS from DB/AREA
Records” on page 86
v “Getting Change Accumulation to Start Processing Logs Again” on page 86
v “Getting Change Accumulation Working When It States Nothing to Process” on
page 86
v “Moving Log Data Sets” on page 87
v “Reorganizing RECON to Increase Maximum RECORDSIZE” on page 87
v “Cataloging Data Sets” on page 89
v “Performing Multiple Cold Starts in a Test Environment” on page 90
v “Avoiding Some Causes of RECON Enqueue Problems” on page 91

Locating the Last SLDS Stop Time in RECON

Follow this procedure to find the last SLDS stop time in RECON using the
GENJCL.USER command. This can be done when IMS is still running and also works
if the PRISLD is already closed.
1. Create a skeletal JCL execution member first. Here is an example of a member
named USER01:
%SELECT SLDS(%USSID,LAST)
%ENDSEL
SLDSDD BEG=%SLDSTIM
END=%SLDETIM
VOL=%SLDVOLS
UNT=%SLDUNIT
DSN=%SLDSDSN

2. Issue the GENJCL.USER command indicating the execution member to run with.
Below is a sample of the GENJCL.USER command indicating that the command is
to be run with member USER01:
GENJCL.USER MEMBER(USER01),-
NOJOB, USERKEYS((%USSID,'SYS3')),-
JCLOUT(SYSPRINT)
3. Below is the SLDS listing:
PRISLD
START = 96.296 11:51:21.8 * SSID=SYS3 VERSION=6.1
STOP = 96.296 13:08:18.4 #DSN=4
GSGNAME=**NULL**
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 0

© Copyright IBM Corp. 1974, 2001 79

Hints and Tips
DSN=IMSVS.SLDSP.SYS3.D96296.T1151218.V06 UNIT=SYSDA
START = 96.296 11:51:21.8 FIRST DS LSN= 0000000000000001
STOP = 96.296 11:52:08.7 LAST DS LSN= 00000000000002B5
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 96.292 11:52:08.7

CKPTCT=1 CHKPT ID = 96.292 11:51:26.8

DSN=IMSVS.SLDSP.SYS3.D96296.T1152087.V00 UNIT=SYSDA
START = 96.296 11:52:08.7 FIRST DS LSN= 00000000000002B6
STOP = 96.296 11:52:51.6 LAST DS LSN= 000000000000036D
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 96.296 11:52:51.6

CKPTCT=0 CHKPT ID = 96.296 11:51:26.8

DSN=IMSVS.SLDSP.SYS3.D96296.T1152516.V00 UNIT=SYSDA
START = 96.296 11:52:51.6 FIRST DS LSN= 000000000000036E
STOP = 96.296 13:08:16.9 LAST DS LSN= 00000000000004E5
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 96.296 13:08:16.9

CKPTCT=2 CHKPT ID = 96.296 11:52:52.0

DSN=IMSVS.SLDSP.SYS3.D96296.T1152516.V01 UNIT=SYSDA
START = 96.296 13:08:16.9 FIRST DS LSN= 00000000000004E6
STOP = 96.296 13:08:18.4 LAST DS LSN= 0000000000000571
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 96.296 13:08:18.4

CKPTCT=0 CHKPT ID = 96.296 13:08:16.8

Below is the output that results from issuing the previous sample GENJCL.USER
command:
SLDSDD BEG=962961308169
END=962961308184
VOL=000000
UNT=SYSDA
DSN=IMSVS.SLDSP.SYS3.D96296.T1152516.V01

Adjusting GENMAX When It Is Reached or It Is Too High

Prior to image copy utility execution, verification exit processing may determine that
one of the following situations is true when image copy data sets are being reused:
v Situation 1- GENMAX Value is Too Low
– The GENMAX value was reached.
– The oldest image copy cannot be reused because it is within the recovery
period.
– No available image copies exist that can be used.
– Message DSP0063I was displayed.

See “Solutions for Situation #1” on page 81 on how to correct this.

v Situation 2 - GENMAX Value is Too High
– GENMAX has not been reached so the inuse image copy data sets cannot be
used.
– No available image copy data sets exist that can be used.
– Message DSP0084I was displayed.

80 DBRC Guide & Reference

Hints and Tips
– No recovery preiod is defined.

See “Solution for Situation #2” on how to correct this.

Solutions for Situation #1

Either of the following will solve situation number one above:
v Increase GENMAX and define additional image copy data sets.
v Change the recovery period to allow the oldest image copy data set to be used.

Issue the CHANGE.DBDS to increase the GENMAX and INIT.IC parameters to define
the additional image copy data sets:
1. Create a JCL job similar to one of the following jobs. These examples assume
that your DBD name is THISDB, that your area name is AREA1, and that your
previous GENMAX value was 2.

//CHNGDBDS JOB

//SYSIN DD *
CHANGE.DBDS DBD(THISDB) AREA(AREA1) -
GENMAX(4)
/*

//INITIC JOB

//SYSIN DD *
INIT.IC DBD(THISDB) DDN(DDN1) -
ICDSN(IMS.*.NEWICDSN)
INIT.IC DBD(THISDB) DDN(DDN1) -
(IMS.*.NEWICDSN2)
/*

Issue CHANGE.DBDS RECOVPD to reduce the recovery period.

//CHNGDBDS JOB
//SYSIN DD*
CHANGE.DBDS DBD(THISDB) AREA(AREA1) RECOVPD(10)
/*

2. Run the job.

3. Check the JES log to ensure that the job ran successfully.
4. Run a LIST command to see the new GENMAX value (optional).
5. Run your image copy job.

Solution for Situation #2

v Issue an INIT.IC command to define a new image copy data set for the
identified database data set or area data set
-OR-
v Issue a CHANGE.DBDS command to lower the GENMAX value.

Attention: If GENMAX is lowered using the CHANGE.DBDS command, the new

GENMAX value is recorded regardless of whether the oldest image copies are
undeletable, because they are within the recovery period.

Chapter 6. Hints and Tips for DBRC 81

Hints and Tips

Getting PRILOG Compression to Work

If your PRILOG is not getting compressed, do the following:
v Check the EARLIEST CHECKPOINT time stamp listed in the PRILOG.
If this time stamp is within the first DSN entry in the PRILOG, then compression
is not possible. Most often, the oldest checkpoint needed for restart causing the
problem is the checkpoint to rebuild the message queues. If so, take a SNAPQ
checkpoint. When the OLDS that records this SNAPQ checkpoint is archived, the
earliest checkpoint time stamp is updated.
v Review the allocation records for all databases listed in the LOGALL record that
is associated with this PRILOG.
If the oldest allocation time stamp is within the first DSN entry of the PRILOG,
then it is preventing compression.
Concurrent image copies (CICs) and Online image copies (OICs) update the
allocation time to reflect the earliest log that is needed for recovery. The
checkpoint IDs and checkpoint counts on the logs prior to the start of the CIC are
used to determine where the new allocation time is set. If the allocation times are
not being moved forward-in-time, ensure that checkpoint IDs and counts are
being recorded in the DSN entries.
Old allocations for any databases in the LOGALL record can cause compression
to fail. Image copy databases on a regular basis to allow old allocations to be
deleted.

PRILOG Record Sizes

DBRC ABENDs when the PRILOG record exceeds the maximum record size
defined for the RECONs. DBRC issues warning messages indicating that a
PRILOG record is approaching its maximum size. You can control the timing of
those messages, taking into account the typical rate at which your system fills
OLDSs and the average number of volumes in each archive data set.

2. PRILOG_header_length = 112 bytes

3. DS_entry_length = 120 bytes
4. Volume_entry_length = 40 bytes

82 DBRC Guide & Reference

Hints and Tips

Using NOTIFY.PRILOG to Close an Open Online PRILOG

During timestamp recoveries, when DBRC reports that there are open allocations
that are not needed for the recovery, it may be easier to close the open PRILOG
rather than deleting the individual allocations.

If an open PRILOG record is found for an online IMS subsystem, and the PRILOG
record is not for the current run of IMS, it indicates that the last OLDS for this online
IMS has not yet been archived. If the OLDS is no longer available and you need to
close the open PRILOG record, the following command may be used to create a
dummy DSN entry in the PRILOG:
NOTIFY.PRILOG DSN(DUMMY) STARTIME(960011314544) FIRSTREC(011) -
VOLSER(SC3390) SSID(IMSA)
NOTIFY.PRILOG STARTIME(960011314544) LASTREC(015) -
SSID(IMSA) RUNTIME(960021315001)
CHANGE.PRILOG STARTIME(960011314544) ERROR -
DSSTART(960021315000)

Below is the PRILOG as it appears in RECON prior to issuing the NOTIFY.PRILOG

command to close it:
PRILOG
START = 96.001 13:14:54.4 * SSID=IMSA VERSION=6.1
STOP = 00.000 00:00:00.0 #DSN=2
GSGNAME=**NULL**
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 0
EARLIEST CHECKPOINT = 96.001 13:14:54.9

DSN=LOG1 UNIT=3400
START = 96.001 13:14:54.4 FIRST DS LSN= 0000000000000001
STOP = 96.001 13:15:00.0 LAST DS LSN= 0000000000000005
FILE SEQ=0001 #VOLUMES=0001

VOLSER=SC3390 STOPTIME = 96.001 13:15:00.0

CKPTCT=0 CHKPT ID = 00.000 00:00:00.0

DSN=LOG2 UNIT=3400
START = 96.001 13:15:00.0 FIRST DS LSN= 0000000000000006
STOP = 96.002 13:15:00.0 LAST DS LSN= 000000000000000A
FILE SEQ=0001 #VOLUMES=0001

VOLSER=SC3390 STOPTIME = 96.002 13:15:00.0

CKPTCT=0 CHKPT ID = 00.000 00:00:00.0

Below is the PRILOG as it appears in RECON after issuing the NOTIFY.PRILOG

command to close it (differences are highlighted):
PRILOG
START = 96.001 13:14:54.4 * SSID=IMSA VERSION=6.1
STOP = 96.002 13:15:00.1 #DSN=3
GSGNAME=**NULL**
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 0
EARLIEST CHECKPOINT = 96.001 13:14:54.9

DSN=LOG1 UNIT=3400
START = 96.001 13:14:54.4 FIRST DS LSN= 0000000000000001
STOP = 96.001 13:15:00.0 LAST DS LSN= 0000000000000005
FILE SEQ=0001 #VOLUMES=0001

VOLSER=SC3390 STOPTIME = 96.001 13:15:00.0

CKPTCT=0 CHKPT ID = 00.000 00:00:00.0

DSN=LOG2 UNIT=3400

Chapter 6. Hints and Tips for DBRC 83

Hints and Tips
START = 96.001 13:15:00.0 FIRST DS LSN= 0000000000000006
STOP = 96.002 13:15:00.0 LAST DS LSN= 000000000000000A
FILE SEQ=0001 #VOLUMES=0001

VOLSER=SC3390 STOPTIME = 96.002 13:15:00.0

CKPTCT=0 CHKPT ID = 00.000 00:00:00.0

DSN=DUMMY ERROR UNIT=3400

START = 96.002 13:15:00.0 FIRST DS LSN= 000000000000000B
STOP = 96.002 13:15:00.1 LAST DS LSN= 000000000000000F
FILE SEQ=0001 #VOLUMES=0001

VOLSER=SC3390 STOPTIME = 96.002 13:15:00.1

CKPTCT=0 CHKPT ID = 00.000 00:00:00.0

Deleting Log Records

As time passes, the RECON accumulates old records associated with IMS log data
sets. You can use the DELETE.LOG command to eliminate unnecessary PRILOG
families and their associated LOGALL records.

Working with Subsystem Records (SSYS)

Have you ever wondered what those subsystem names represent in RECON? If
authorization for a database fails and you list the database and all the subsystem
records in the RECON, you may wonder how the subsystem names (SSIDs) were
created. The next section explains the naming conventions for the subsystem
records.

Naming Conventions for SSIDs in RECON Subsystem Records

The SSYS record is created when a signon call is issued to DBRC. The SSID must
be unique. Normal conventions for creating the subsystem name are:

84 DBRC Guide & Reference

Hints and Tips
IMS and DBCTL subsystems = IMSID value from IMSCTRL SYSGEN macro
(four characters)

BATCH and UTILITY SUBSYSTEMS = JOBNAME

XRF = RSENAME (Recovery Service Element) of the IMS systems

(active and alternate)

Exceptions include the following:

ONLINE IMAGE COPY - XXXTZZZZ where

XXXT is the DMB number of the database + DCB number translated

to 0-9,A-Z
ZZZZ is the control region IMSID

Online image copy is the only BMP that creates its own subsystem record in
RECON.

Batch Backout
If batch backout is processing a log created by a batch subsystem, the SSID that is
used is the job name of the subsystem that is being backed out. The job name of
the batch backout utility job is not used.

If batch backout is processing a log that was created by an online subsystem, the
job name of the backout utility job is used as the SSID.

Deleting a Subsystem Record

When you no longer need a particular subsystem record in RECON, the following
commands can be used to delete the SSYS:
CHANGE.SUBSYS SSID(XXXXX) STARTRCV
CHANGE.SUBSYS SSID(XXXXX) ENDRECOV <---(removes auth from DB)
DELETE.SUBSYS SSID(XXXXX)

Subsystem Record Size

The subsystem record grows in size, so maximum LRECL in the VSAM define
cluster should be large enough to hold the maximum SSYS size. If the maximum
LRECL is too small to hold the maximum SSYS size, IMS abends.

The record size for the subsystem record can be calculated using the following
formula:
72 + (number_of_db_authorized × 32)

Note: 72 = fixed portion of record

32 = information for each database authorized
(All numbers in decimal)

Chapter 6. Hints and Tips for DBRC 85

Hints and Tips

Removing Authorization Inconsistency between the SSYS from

DB/AREA Records
To change database authorization or if authorization fails, a LIST.DB shows that the
DB or area is authorized to a non-existent subsystem and backout is not required.
Use the command below to remove the authorization. You can also use the
command below to remove a database/area name from the list in a subsystem
record when a LIST.SUBSYS shows it authorized and a LIST.DB does not show it
authorized.
CHANGE.DB DBD(dbname) SSID(XXXX) UNAUTH (or)
CHANGE.DB DBD(dbname) AREA(areaname) SSID(XXXX) UNAUTH

Getting Change Accumulation to Start Processing Logs Again

Change accumulation erroneously stops processing logs and the source of the
problem is traced to an OLDS left in the ARC STARTED state. An IPL of MVS is
done on the CPU where the archive job was run and the status of the OLDS
remains in this state. GENJCL.ARCHIVE jobs do not include any OLDS in ARC
STARTED status. The online IMS that created the OLDS is not running on this
CPU.

If the online IMS is run on the same CPU as the archive job when IMS is restarted,
it resets the status of all OLDS in ARC STARTED status to ARC NEEDED. The
OLDS is included in the next archive job. To avoid this problem, run archive jobs on
the same CPU as their corresponding IMS systems.

In cases where manual intervention is required, use the following command to

change the status of the OLDS to archive needed (ARNEEDED):
CHANGE.PRILOG OLDS(DFSOLPXX) ARNEEDED SSID(XXXX)

Getting Change Accumulation Working When It States Nothing to

Process
Change accumulation has issued a message stating that it found no logs to
process. A review of the listing reveals that there are many logs that need to be
processed.

DBRC selects all logs needed to satisfy the allocations for each DBDS since the
effective image copy time. The logs are put in log volume start time order as a way
for DBRC to keep track of which logs it has processed. DBRC processes all
available logs and truncates the list of log volumes when it encounters a log in
error, an open log, or when it detects an unarchived OLDS. A message indicating
the condition that was encountered (such as an open log) is issued.

If the last change accumulation execution record shows that a SUBSET of logs was
input to it last, the STOPTIME reflects the start time of the first unavailable log
volume. Find this log volume time stamp in the RECON listing. If no log volume
exists with this start time, there is an unarchived OLDS.

The following time line illustrates this open OLDS condition:

T1--T2---T3--T4-T5--------T6--------T7---------T8----T9---

86 DBRC Guide & Reference

Hints and Tips
|---A1---D1--|--------------------A4-----------------// (open)
Log1 (DSN1) (OPEN OLDS)

|--A2--| |--A3-|
Log2 Log3

If GENJCL.CA is run at T7, it includes Log1(DSN1) and has a STOPTIME of T4 and

is a SUBSET. T4 is the start time of the first unavailable log. After this JCL is
executed, any attempts to run GENJCL.CA result in issuing two messages; one
stating that an unarchived OLDS exists and another stating that there are no logs to
process until the open OLDS is closed and archived.

Moving Log Data Sets

DBRC records information about an IMS log in the RECON. This information
includes the log data set name (DSN), its starting and ending times, and the volume
serial (VOLSER).

The best way to avoid lost logs is to use cataloged log data sets and the DBRC
CATDS option.

For non-cataloged log data sets, inform DBRC about changes by using the
CHANGE.PRILOG or CHANGE.SECLOG command.

Reorganizing RECON to Increase Maximum RECORDSIZE

The following actions may result in the need to increase the maximum
RECORDSIZE in your AMS (Access Method Services) format RECONs:
v Registering additional databases with DBRC or a change in workload that may
cause the number of databases authorized to a subsystem to increase. This may
cause the subsystem to grow beyond the current maximum RECORDSIZE.
v PRILOG compression is unable to compress the online PRILOG to keep it within
the current maximum RECORDSIZE.

A new instance of DBRC cannot be started if the RECORDSIZE for two RECONs
do not match. All batch activity must be quiesced. The online IMS subsystems can
remain active if the RECONs are dynamically allocated, otherwise they must be
shutdown.

Determine the status of the RECONs using one of the following methods:
v From online IMS, enter:
/RML DBRC='RECON STATUS'

v In batch, execute program DSPURX00 to do a LIST.RECON STATUS.

Example of current status: RECON1 Copy1
RECON2 Copy2
RECON3 Spare

If the online IMS subsystems are shut down, follow this procedure:

Chapter 6. Hints and Tips for DBRC 87

Hints and Tips
v Use the DBRC BACKUP.RECON command or Access Method Services (IDCAMS)
REPRO command (or both) to backup RECON1. If you are reorganizing the
RECON because message DSP0029I was received, you must use the IDCAMS
REPRO command to take the backup. The DFSMSdss (DFDSS) utility can be
used in place of REPRO.
v Delete and redefine RECON1, RECON2, and RECON3 with the larger maximum
RECORDSIZE.
v Copy the backup RECON into RECON1 and RECON2 using IDCAMS REPRO.

If the online IMS subsystems are active, follow this procedure:

v Delete and redefine the spare RECON using IDCAMS with a larger maximum
RECORDSIZE.
Example: RECON1 = Copy1 (RECORDSIZE 32K)
RECON2 = Copy2 (RECORDSIZE 32K)
RECON3 = Spare (RECORDSIZE 64K)

v Issue the online command to force a copy of the RECON2 to the spare RECON:
/RMC DBRC='RECON REPLACE(RECON1)'

RECON1 is discarded and deallocated.

v Issue the following command for ALL other online IMS subsystems that are
active:
/RML DBRC='RECON STATUS'

Status of RECONs RECON1 = discarded (RECORDSIZE 32K)

RECON2 = Copy1 (RECORDSIZE 32K)
RECON3 = Copy2 (RECORDSIZE 64K)

This forces all the online subsystems to deallocate RECON1.

v Delete and redefine RECON1 with the larger RECORDSIZE.
v Issue the following online command to force a copy of RECON3 to the spare
RECON:
/RMC DBRC='RECON REPLACE(RECON2)'

RECON2 is discarded and deallocated.

v For ALL other online IMS subsystems that are active, issue the following
command:
/RML DBRC='RECON STATUS'

Status of RECONs: RECON1 = Copy2 (RECORDSIZE 64K)

RECON2 = discarded (RECORDSIZE 32K)
RECON3 = Copy1 (RECORDSIZE 64K)

This forces all the online subsystems to deallocate RECON2.

v Delete and redefine RECON2 with the larger RECORDSIZE.
v Check the status of the RECONs by issuing the following command:

/RML DBRC='RECON STATUS'

88 DBRC Guide & Reference

Hints and Tips
Status of RECONs: RECON1 = Copy2 (RECORDSIZE 64K)
RECON2 = spare (RECORDSIZE 64K)
RECON3 = Copy1 (RECORDSIZE 64K)

Your reorganization is complete.

If you choose to reset the status of the RECONs so that RECON1 is Copy1,
RECON2 is Copy2 and RECON3 is the spare; do the following:
v Issue this online command to force a copy of RECON1:
/RMC DBRC='RECON REPLACE(RECON3)'

RECON3 is discarded and deallocated.

v For ALL other online IMS subsystems that are active, issue this command:

/RML DBRC='RECON STATUS'

Status of RECONs: RECON1 = Copy1 (RECORDSIZE 64K)

RECON2 = Copy2 (RECORDSIZE 64K)
RECON3 = discarded (RECORDSIZE 64K)

This forces all the online subsystems to deallocate RECON3.

v Delete and redefine RECON3 with the RECORDSIZE (64 KB).
v Check the status of the RECONs again by issuing the following command:

/RML DBRC='RECON STATUS'

Status of RECONs: RECON1 = Copy1 (RECORDSIZE 64K)

RECON2 = Copy2 (RECORDSIZE 64K)
RECON3 = spare (RECORDSIZE 64K)

Cataloging Data Sets

You can indicate whether image copy, change accumulation, and log data sets are
cataloged by using the CATDS or NOCATDS keywords on the CHANGE.RECON or
INIT.RECON command.

The CHANGE.RECON and INIT.RECON commands update the RECON header record
accordingly if you specify either CATDS or NOCATDS. The only difference between
the two commands in respect to cataloging is that INIT.RECON can be issued only
once per RECON.

To specify that these data sets are cataloged specify:

//CHGRECON JOB
.
.
.

//SYSIN DD *
CHANGE.RECON CATDS
/*

-OR-

Chapter 6. Hints and Tips for DBRC 89

Hints and Tips
//INITRCON JOB
.
.
.

//SYSIN DD *
INIT.RECON CATDS
/*

The data set must have been initialized as cataloged for CATDS to be effective with
the CHANGE.RECON command.

Specifying NOCATDS on the CHANGE.RECON or INIT.RECON command establishes

that these data sets, regardless of their cataloged status, are not to be treated as
cataloged.

To specify that these data sets are not to be treated as cataloged specify:
//CHGRECON JOB
.
.
.

//SYSIN DD *
CHANGE.RECON NOCATDS
/*

-OR-
//INITRCON JOB
.
.
.

//SYSIN DD *
INIT.RECON NOCATDS
/*

Performing Multiple Cold Starts in a Test Environment

Many times in a test environment, you may want to cold start IMS. In order to cold
start IMS the last OLDS must be closed. If you have no need to close the OLDS,
you can use the following commands to close the OLDS and mark it archived in
RECON so it may be reused:
NOTIFY.PRILOG STARTIME(960031314544) RUNTIME(960031314545) -
LASTREC(015) OLDS(DFSOLP02) SSID(IMSA)
CHANGE.PRILOG OLDS(DFSOLP02) ARCHIVED SSID(IMSA)

The entries for each OLDS (such as: DFSOLP00, DSPOLP01, and DSPOLD02) in
the PRIOLD record are built when the OLDSs are used (if they do not already exist
in RECON). If you also need to delete the OLDS from RECON, the following
commands can be used:
DELETE.LOG OLDS(DFSOLP00) SSID(IMSA)
DELETE.LOG OLDS(DFSOLP01) SSID(IMSA)
DELETE.LOG OLDS(DFSOLP02) SSID(IMSA) LASTCLOS

90 DBRC Guide & Reference

Hints and Tips
Note that the LASTCLOS is necessary to delete the last OLDS used by IMS. The
PRIOLD record is also deleted when the last DDNAME entry is removed.

The PRIOLD record before issuing the commands:

PRIOLD
SSID=IMSA # DD ENTRIES=3
EARLIEST CHECKPOINT = 96.001 14:22:22.2

DDNAME=DFSOLP00 DSN=IMSA.OLDP00
START = 96.001 13:14:54.4 FIRST DS LSN= 0000000000000001
STOP = 96.002 13:14:54.4 LAST DS LSN= 0000000000000005
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=96.001 13:14:54.4 ARCHIVE JOB NAME=JT185209
VERSION=6.1

DDNAME=DFSOLP01 DSN=IMSA.OLDP01
START = 96.002 13:14:54.4 FIRST DS LSN= 0000000000000006
STOP = 96.003 13:14:54.4 LAST DS LSN= 000000000000000A
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=96.001 13:14:54.4 ARCHIVE JOB NAME=JT185210
VERSION=6.1

DDNAME=DFSOLP02 DSN=IMSA.OLDP02
START = 96.003 13:14:54.4 FIRST DS LSN= 000000000000000B
STOP = 00.000 00:00:00.0 LAST DS LSN= 0000000000000000
STATUS=ACTIVE FEOV=NO AVAIL
PRILOG TIME=96.001 13:14:54.4 ARCHIVE JOB NAME=JT185211
VERSION=6.1

The PRIOLD record after issuing the commands to close and mark DFSOLP02 as
archived (with the differences highlighted):
PRIOLD
SSID=IMSA # DD ENTRIES=3
EARLIEST CHECKPOINT = 96.001 14:22:22.2

DDNAME=DFSOLP02 DSN=IMSA.OLDP02
START = 96.003 13:14:54.4 FIRST DS LSN= 000000000000000B
STOP = 96.003 13:14:54.5 LAST DS LSN= 000000000000000F
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=96.001 13:14:54.4 ARCHIVE JOB NAME=JT185211
VERSION=6.1

Avoiding Some Causes of RECON Enqueue Problems

The following section describes some reasons that you may experience RECON
enqueue problems and things to watch out for to avoid them.

Chapter 6. Hints and Tips for DBRC 91

Hints and Tips
In a Shared DASD Environment
Operating in a shared DASD environment, the most common cause of RECON
enqueue problems is failing to follow the recommendation to catalog each RECON
in its own ICF catalog on the same volume as the RECON.

If you catalog each RECON in its own ICF catalog on the same volume as the
RECON and still have problems; examine your GRS, (or equivalent) RESERVE
conversion list, to determine how you process SYSIGGV2 and DSPURI01
QNAMEs. A couple of combinations may lead to deadlocks.

In a Non-Shared DASD Environment

If you are operating in a non-shared DASD environment and are having problems,
this is probably not caused by deadlock but rather by contention and slow
performance. Here are a few things to look at in this situation:
1. Minimize the amount of time any job holds the RECON.
One way to minimize that time is to tune the LSR buffer pool DBRC uses when
accessing the RECONs. There is a CSECT, DSPBUFFS, that contains the
values used for online, batch, and a procedure in the IMS Version 7
Customization Guide on how to zap it to change the values. The defaults may
be low for your usage.
2. Analyze the other contents of the RECON volumes. Consider isolating the
RECON volumes, to prevent interference from other I/O activity (and vice
versa). Consider placing the RECONs on high performance cached DASD, or
perhaps solid state DASD.

92 DBRC Guide & Reference

Part 2. Command Reference
Chapter 7. DBRC Commands . . . . . . . . . . . . . . . . . . . 99
Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . 99
Separators . . . . . . . . . . . . . . . . . . . . . . . . . 100
Continuation Characters . . . . . . . . . . . . . . . . . . . . 100
Comments . . . . . . . . . . . . . . . . . . . . . . . . . 100
Commands . . . . . . . . . . . . . . . . . . . . . . . . . 100
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 100
DBRC Time Stamps . . . . . . . . . . . . . . . . . . . . . 101
Standard Time Stamp Format . . . . . . . . . . . . . . . . . 101
Specifying Zero Time Stamp Values. . . . . . . . . . . . . . . 105
Extrapolation of Two-digit Year Input . . . . . . . . . . . . . . 105
Time Stamp Conversions and Examples . . . . . . . . . . . . . 105
Standard Default Settings for Timestamp Values . . . . . . . . . . 106
DBRC Commands Affected by the Time Stamp Format . . . . . . . 106
Use of Time History Table (THT) . . . . . . . . . . . . . . . . 107
Using the Commands in This Book . . . . . . . . . . . . . . . . 107
Notational Conventions . . . . . . . . . . . . . . . . . . . . 107
How to Read the Syntax Diagrams . . . . . . . . . . . . . . . . 107
DBRC Online Command Syntax . . . . . . . . . . . . . . . . . . 110

Chapter 8. BACKUP Command . . . . . . . . . . . . . . . . . . 111

BACKUP.RECON . . . . . . . . . . . . . . . . . . . . . . . 111
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 111
Example of Creating Backups of a RECON . . . . . . . . . . . . . 111

Chapter 9. CHANGE Commands . . . . . . . . . . . . . . . . . 113

CHANGE.ADS . . . . . . . . . . . . . . . . . . . . . . . . 113
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 113
Example of Changing an ADS Record . . . . . . . . . . . . . . . 113
CHANGE.BKOUT . . . . . . . . . . . . . . . . . . . . . . . 114
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 114
Example of Using the CHANGE.BKOUT Command . . . . . . . . . . 116
CHANGE.CA . . . . . . . . . . . . . . . . . . . . . . . . . 116
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 116
Example of Changing a Change Accumulation Run Record . . . . . . . 117
CHANGE.CAGRP . . . . . . . . . . . . . . . . . . . . . . . 118
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 118
Examples of Using the CHANGE.CAGRP Command . . . . . . . . . 119
Example of Adding DBDSs to the Existing CA Group CAGRP1 . . . . . 119
Example of Deleting DBDSs from the CA Group CAGRP1 . . . . . . 120
Example of Changing a CA Group Record . . . . . . . . . . . . 120
CHANGE.DB . . . . . . . . . . . . . . . . . . . . . . . . . 120
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 121
Example of Changing a Record for a DB Identified with the DBD Parm 125
CHANGE.DBDS . . . . . . . . . . . . . . . . . . . . . . . . 126
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 127
Example of Changing a Record for a Fast Path DEDB . . . . . . . . . 132
CHANGE.DBDSGRP . . . . . . . . . . . . . . . . . . . . . . 132
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 133
Example of Changing a Group of DBDSs. . . . . . . . . . . . . . 134
CHANGE.IC . . . . . . . . . . . . . . . . . . . . . . . . . 134
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 135
Example of Changing an Image Copy Record . . . . . . . . . . . . 136

© Copyright IBM Corp. 1974, 2001 93

CHANGE.PRILOG (for OLDS) . . . . . . . . . . . . . . . . . . . 137
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 137
Example of Renaming an OLDS . . . . . . . . . . . . . . . . . 138
CHANGE.PRILOG (for RLDS) . . . . . . . . . . . . . . . . . . . 139
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 140
Examples of Using the CHANGE.PRILOG (for RLDS) Command . . . . . 142
Example of Changing Volume Serial Numbers . . . . . . . . . . . 142
Example of Marking Primary RLDS for Errors . . . . . . . . . . . 143
CHANGE.PRILOG (for SLDS and TSLDS) . . . . . . . . . . . . . . 143
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 144
Examples of Using CHANGE.PRILOG (for SLDS and TSLDS) . . . . . . 147
Example of Changing Volume Serial Numbers and Stop Time . . . . . 147
Example of Marking Primary SLDS as Normal . . . . . . . . . . . 147
CHANGE.RECON . . . . . . . . . . . . . . . . . . . . . . . 147
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 148
Suggestions for Time Zone Label Table Management . . . . . . . . . 155
Example of Updating the RECON Header Record . . . . . . . . . . 155
CHANGE.RECON (for THT or REPTHT) . . . . . . . . . . . . . . . 156
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 156
Example of Specifying a Replacement THT Entry. . . . . . . . . . . 156
CHANGE.SECLOG (for OLDS) . . . . . . . . . . . . . . . . . . 156
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 157
Example Showing a SECOLDS Error . . . . . . . . . . . . . . . 158
CHANGE.SECLOG (for RLDS) . . . . . . . . . . . . . . . . . . 158
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 159
Examples of Using CHANGE.SECLOG (for RLDS) . . . . . . . . . . 161
Example of Changing Volume Serial Numbers . . . . . . . . . . . 161
Example of Changing Volume Stop Times . . . . . . . . . . . . 162
CHANGE.SECLOG (for SLDS and TSLDS) . . . . . . . . . . . . . . 162
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 163
Examples of Using CHANGE.SECLOG (for SLDS and TSLDS) . . . . . 166
Example of Changing Volume Serial Numbers and Stop Time . . . . . 166
Example of Marking the Secondary SLDS as Normal . . . . . . . . 166
CHANGE.SG . . . . . . . . . . . . . . . . . . . . . . . . . 167
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 167
Example of Changing the Status of a Service Group . . . . . . . . . 167
CHANGE.SUBSYS . . . . . . . . . . . . . . . . . . . . . . . 168
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 168
Example of Identifying the IRLM . . . . . . . . . . . . . . . . . 169
CHANGE.UIC . . . . . . . . . . . . . . . . . . . . . . . . . 170
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 170
Example of Changing the Nonstandard ICDSN in RECON . . . . . . . 170

Chapter 10. DELETE Commands . . . . . . . . . . . . . . . . . 171

94 DBRC Guide & Reference

DELETE.CAGRP . . . . . . . . . . . . . . . . . . . . . . . 174
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 174
Example of Deleting CA Group Records . . . . . . . . . . . . . . 174
DELETE.DB . . . . . . . . . . . . . . . . . . . . . . . . . 174
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 174
Example of Deleting Records from RECON . . . . . . . . . . . . . 175
DELETE.DBDS . . . . . . . . . . . . . . . . . . . . . . . . 175
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 175
Example of Deleting Records for the DBDS . . . . . . . . . . . . . 175
DELETE.DBDSGRP . . . . . . . . . . . . . . . . . . . . . . 175
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 176
Example of Deleting a DBDS Group Record . . . . . . . . . . . . 176
DELETE.GSG . . . . . . . . . . . . . . . . . . . . . . . . . 176
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 176
Example of Deleting a Global Service Group Record . . . . . . . . . 176
DELETE.IC . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 177
Example of Deleting Information from an Image Copy Record . . . . . . 177
DELETE.LOG (for OLDS) . . . . . . . . . . . . . . . . . . . . 177
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 178
Example of Deleting an Interim OLDS Record . . . . . . . . . . . . 178
DELETE.LOG (for RLDS and SLDS) . . . . . . . . . . . . . . . . 178
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 179
Example of Deleting the Record of an RLDS and SLDS . . . . . . . . 180
DELETE.RECOV . . . . . . . . . . . . . . . . . . . . . . . 181
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 181
Example of Deleting a Recovery Record of the DBDS . . . . . . . . . 181
DELETE.REORG . . . . . . . . . . . . . . . . . . . . . . . 182
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 182
Example of Deleting a Reorganization Record of a DBDS . . . . . . . 182
DELETE.SG . . . . . . . . . . . . . . . . . . . . . . . . . 182
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 183
Example of Deleting a Global Service Group Record . . . . . . . . . 183
DELETE.SUBSYS . . . . . . . . . . . . . . . . . . . . . . . 183
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 183
Example of Deleting a Specified SUBSYS Record . . . . . . . . . . 183
DELETE.UIC . . . . . . . . . . . . . . . . . . . . . . . . . 184
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 184
Example of Deleting a Nonstandard Image Copy Data Set Record . . . . 184

Chapter 11. GENJCL Commands . . . . . . . . . . . . . . . . . 185

GENJCL.ARCHIVE . . . . . . . . . . . . . . . . . . . . . . . 185
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 185
Examples of Running the Log Archive Utility . . . . . . . . . . . . 188
Example with Primary OLDS Defined by the OLDS Parameter . . . . . 188
Example of the SSID IMSB OLDS Parameter Defining the Primary OLDS 188
Example for Unarchived Default Subsystem OLDSs . . . . . . . . . 188
GENJCL.CA . . . . . . . . . . . . . . . . . . . . . . . . . 189
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 189
Examples of Running the Change Accumulation Utility . . . . . . . . . 192
Example for the GRPNAME CA Group. . . . . . . . . . . . . . 192
Example of CAJCLA Generated Skeletal JCL . . . . . . . . . . . 192
Example of CAJCLB Generated Skeletal JCL . . . . . . . . . . . 192
GENJCL.CLOSE. . . . . . . . . . . . . . . . . . . . . . . . 193
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 193
Examples of Running the Log Recovery Utility . . . . . . . . . . . . 195

Part 2. Command Reference 95

Example When a Host Operating System Failed and /ERE Is Not
Possible . . . . . . . . . . . . . . . . . . . . . . . . 195
Example Using the CLOSE1 JCLPDS Member . . . . . . . . . . 195
GENJCL.IC. . . . . . . . . . . . . . . . . . . . . . . . . . 195
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 197
Examples of Running the Database Image Copy Utility. . . . . . . . . 200
Example for DBDS Defined by the DBD and DDN Parameters . . . . . 200
Example for All DBDSs in a Group with NOCIC . . . . . . . . . . 201
Example of Running the Database Image Copy 2 Utility with SMSCIC 201
Example of Running the Database Image Copy 2 Utility with SMSNOCIC 202
GENJCL.OIC . . . . . . . . . . . . . . . . . . . . . . . . . 202
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 203
Examples of Running the Online Database Image Copy Utility . . . . . . 206
Example Using JCLPDS Member OICJCL . . . . . . . . . . . . 206
Example Using JCLPDS Member OICJCL2 . . . . . . . . . . . . 207
GENJCL.RECEIVE . . . . . . . . . . . . . . . . . . . . . . . 207
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 208
Examples of Running the Database Recovery Utility to Receive an Image
Copy . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Example for the DBDS Identified by the DBD and DDN Parameters 210
Example for All DBDSs in a Group . . . . . . . . . . . . . . . 210
GENJCL.RECOV . . . . . . . . . . . . . . . . . . . . . . . 211
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 212
Examples of Running the Database Recovery Utility. . . . . . . . . . 215
Example for the DBDS Identified in the DBD and DDN Parameters . . . 216
Example for All DBDSs in a Group . . . . . . . . . . . . . . . 216
GENJCL.USER . . . . . . . . . . . . . . . . . . . . . . . . 216
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 217
Example of Running DBRC . . . . . . . . . . . . . . . . . . . 220

Chapter 12. INIT Commands . . . . . . . . . . . . . . . . . . . 221

INIT.ADS . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 221
Example of Creating a Record That Defines an ADS . . . . . . . . . 222
INIT.CA . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 222
Example of Creating a Record That Defines a CA Data Set . . . . . . . 223
INIT.CAGRP . . . . . . . . . . . . . . . . . . . . . . . . . 223
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 223
Example of Creating a CA Group. . . . . . . . . . . . . . . . . 224
INIT.DB . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 225
Example of Creating a SHARELVL 1 DB Record . . . . . . . . . . . 226
INIT.DBDS . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 227
Example of Identifying the DBDS to Initiate DBRC’s Control Over Recovery 231
INIT.DBDSGRP . . . . . . . . . . . . . . . . . . . . . . . . 231
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 232
Example of Creating a Group of DBDSs . . . . . . . . . . . . . . 232
INIT.GSG . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 233
Example of Creating a Global Service Group . . . . . . . . . . . . 233
INIT.IC . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 234
Example of Creating a Record That Defines the ICDSN . . . . . . . . 235
| INIT.PART . . . . . . . . . . . . . . . . . . . . . . . . . . 235

96 DBRC Guide & Reference

| Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 236
INIT.RECON . . . . . . . . . . . . . . . . . . . . . . . . . 239
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 239
Example of Initializing the RECON . . . . . . . . . . . . . . . . 243
INIT.SG . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 243
Examples of Creating Service Groups . . . . . . . . . . . . . . . 244

Chapter 13. LIST Commands . . . . . . . . . . . . . . . . . . 245

LIST.BKOUT . . . . . . . . . . . . . . . . . . . . . . . . . 245
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 245
Example of Running LIST.BKOUT . . . . . . . . . . . . . . . . 245
LIST.CAGRP . . . . . . . . . . . . . . . . . . . . . . . . . 245
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 246
Example of Specifying the CA Group and CA Records via GRPNAME 246
LIST.DB . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 247
Example of Displaying a Database and Its DBDS Records . . . . . . . 248
LIST.DBDS . . . . . . . . . . . . . . . . . . . . . . . . . . 248
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 249
Example of Displaying AREA Parameters. . . . . . . . . . . . . . 249
LIST.DBDSGRP . . . . . . . . . . . . . . . . . . . . . . . . 250
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 250
Example of Displaying the Members of a DBDS Group. . . . . . . . . 251
LIST.GSG . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 251
Example of Listing a Global Service Group . . . . . . . . . . . . . 252
LIST.HISTORY . . . . . . . . . . . . . . . . . . . . . . . . 252
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 253
Example of Displaying a DBDSs Activity History . . . . . . . . . . . 254
LIST.LOG (for a PRILOG Family). . . . . . . . . . . . . . . . . . 254
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 255
Example of Listing a PRILOG Family of Records . . . . . . . . . . . 255
LIST.LOG (for a Category of Records) . . . . . . . . . . . . . . . . 255
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 257
Example of Displaying RECON Records Specified by STARTIME . . . . . 258
Example of Displaying a Subsystem’s OLDS Records . . . . . . . . . 258
LIST.RECON . . . . . . . . . . . . . . . . . . . . . . . . . 258
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 259
Examples of Displaying the RECONs . . . . . . . . . . . . . . . 259
Example of Displaying the RECONs . . . . . . . . . . . . . . 259
Example of Displaying RECON Header and Status Information. . . . . 259
LIST.SUBSYS . . . . . . . . . . . . . . . . . . . . . . . . . 260
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 260
Example of Displaying All Online Subsystem Records . . . . . . . . . 261

Chapter 14. NOTIFY Commands . . . . . . . . . . . . . . . . . 263

Part 2. Command Reference 97

NOTIFY.IC . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 269
Example of Notifying DBRC of Concurrent Image Copy Completion . . . . 270
NOTIFY.PRILOG (for OLDS) . . . . . . . . . . . . . . . . . . . 271
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 271
Examples of Using the NOTIFY.PRILOG (for OLDS) Command . . . . . 273
Example of Creating a PRIOLDS for an Online Subsystem OLDS. . . . 273
Example of Adding Information about Two Primary OLDSs to RECON 274
Example of Creating a PRILOG to Record 2 OLDSs Opening and Closing 274
NOTIFY.PRILOG (for RLDS) . . . . . . . . . . . . . . . . . . . 274
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 275
Examples of Using the NOTIFY.PRILOG (for RLDS) Command . . . . . 278
Example of Adding Primary RLDS Information to RECON. . . . . . . 278
Example of Adding Interim-Primary RLDS Information to RECON . . . . 278
Example of Creating a PRILOG Record for 2 Tracking Log DSs . . . . 279
NOTIFY.PRILOG (for SLDS and TSLDS) . . . . . . . . . . . . . . . 279
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 279
Example of Adding Primary SLDS Information to RECON. . . . . . . . 282
NOTIFY.RECOV . . . . . . . . . . . . . . . . . . . . . . . . 283
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 283
Example of Adding DBDS Recovery Information to RECON . . . . . . . 285
NOTIFY.REORG . . . . . . . . . . . . . . . . . . . . . . . . 285
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 286
Example Adding DBDS Reorganization Information to RECON . . . . . . 288
NOTIFY.SECLOG (for OLDS) . . . . . . . . . . . . . . . . . . . 288
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 288
Examples of Using the NOTIFY.SECLOG (for OLDS) Command . . . . . 290
Example of Creating the ISECOLDS Record That Corresponds to the
OLDS . . . . . . . . . . . . . . . . . . . . . . . . . 290
Example of Creating a SECOLDS Record for 2 Secondary OLDSs . . . 290
NOTIFY.SECLOG (for RLDS) . . . . . . . . . . . . . . . . . . . 291
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 291
Examples of Using the NOTIFY.SECLOG (for RLDS) Command . . . . . 294
Example of Adding Secondary RLDS Information to RECON . . . . . 294
Example of Adding Interim Secondary RLDS Information to RECON 294
NOTIFY.SECLOG (for SLDS and TSLDS) . . . . . . . . . . . . . . 294
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 295
Example of Adding Secondary SLDS Information to RECON . . . . . . 298
NOTIFY.SUBSYS . . . . . . . . . . . . . . . . . . . . . . . 298
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 298
Example of Adding a New Subsystem Record to RECON. . . . . . . . 299
NOTIFY.UIC . . . . . . . . . . . . . . . . . . . . . . . . . 299
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 300
Example of Adding Nonstandard ICDSN Information to RECON . . . . . 301

Chapter 15. RESET Command . . . . . . . . . . . . . . . . . . 303

RESET.GSG . . . . . . . . . . . . . . . . . . . . . . . . . 303
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 303
Example of the RESET.GSG Command . . . . . . . . . . . . . . 304

98 DBRC Guide & Reference

Chapter 7. DBRC Commands
This section contains a description of the DBRC commands. Use these commands
to add to, change, and delete information in the RECON and to generate the JCL
and the control statements you need to run the various IMS utilities used in
database recovery.

In This Chapter:
v “Command Syntax”
v “DBRC Online Command Syntax” on page 110
v “Using the Commands in This Book” on page 107

Here is a summary of the DBRC commands:

v Use the BACKUP.RECON command to create a backup copy of the RECON.
v Use the CHANGE commands to modify information in the RECON.
v Use the DELETE commands to delete information from the RECON.
v Use the GENJCL commands to generate jobs for the various IMS recovery utilities.
v Use the INIT commands to create records in the RECON.
v Use the LIST commands to produce a formatted printout of all or selected parts
of the RECON.
v Use the NOTIFY commands to add to the RECON information that is normally
written there automatically.
v Use the RESET.GSG command after an unplanned RSR takeover to remove
obsolete recovery information about RSR-covered databases and areas from the
original active site RECONs.

You can also execute these commands online with the /RMxxxxxx command.

CICS users can execute DBRC commands using the CICS-supplied transaction
CDBM, that provides a command interface to DBCTL.

Related Reading:
v See the command chapters for valid parameters and usage notes for each
command. See IMS Version 7 Command Reference for online command syntax.
v See CICS/ESA-CICS Supplied Transactions for a description of CDBM, and
CICS/ESA-CICS IMS Database Control Guide for details of the DBCTL and
DBRC commands you can use with the CDBM transaction.
v See “Using the Commands in This Book” on page 107 for information the syntax
diagrams and notation used in this book.
v See “Data Set Naming Conventions” on page 21 for information on naming
conventions.

Command Syntax
All DBRC commands adhere to the syntax described here. This syntax is standard,
command-language syntax and is similar to that of TSO and Access Method
Services.

You can enter commands in uppercase, lowercase, or mixed case format. DBRC
translates most command input into uppercase format before processing, regardless

© Copyright IBM Corp. 1974, 2001 99

Command Syntax
of the format that is used. However, DBRC does not translate keyword values and
string values into uppercase format. For example, the ’value’ portion of the
USERKEYS parameter on GENJCL commands, and the UDATA parameter on the
NOTIFY.UIC and CHANGE.UIC commands are processed in the exact format in
which they are entered.

Separators
A blank, a comma, or a comment can be interchanged in a command wherever a
separator is needed. More than one separator can be used between parameters.

Continuation Characters
Continuation characters are used to continue commands and comments that do not
fit on a single line of input.

The two continuation characters used by DBRC are the minus sign (−) and the plus
sign (+):
+ Deletes the leading separators from the continued line.
− Does not delete the leading separators from the continued line.

Comments
Comments consist of alphanumeric character strings beginning with the symbols (/*)
and ending with the symbols (*/).

A comment is assumed to have ended if the end of a line is reached before the
character string (*/) is encountered and if the last character in the line is not a
continuation character.

Commands
A command consists of a verb, a modifier, and, in most cases, a list of parameters.
Exactly one period (.) follows the verb, with no other characters between the verb
and the modifier.

Commands can be entered anywhere in columns 1 through 72 of the DBRC SYSIN

input stream. Commands can be continued on multiple lines by entering a
continuation character as the last non-blank character of the command line.

Columns 73 through 80 of the SYSIN input stream are ignored.

Parameters
There are no positional parameters in DBRC commands. The keyword parameters
are of the following types:
A keyword by itself
A keyword with a value:
keyword(v)

A keyword with a list of values:

keyword(v1,v2..)

A keyword with a repeating list of values:

keyword((v1,v2..),(v1,v2..)..)

100 DBRC Guide & Reference

Command Syntax
When you enter a repeating list of values only once for this type of keyword, you
can omit the outer set of parentheses like this:
keyword(v1,v2)

Restrictions: For DBRC parameters:

v Certain keywords require values in a specific form.
v The format for hexadecimal input is X'xxx', where X'x' can be any of the
characters 0-9 and A-F.
v Any character can be part of a character string.
v A character string that contains special characters must be enclosed in
apostrophes.
v Data set names, data set ddnames, and volume serial numbers can include
hyphens.
v Data set names follow the conventions specified in the MVS JCL manuals.

A character string enclosed in single quotation marks (for example, ('c...c') can be
continued only with a minus continuation character, because separators are
meaningful in a character string between single quotation marks. Such a character
string is assumed to be ended if the end of a line is reached before the ending
quotation mark is encountered and the last non-blank character in the line is not a
minus continuation character. The maximum length of a character string is 255
characters.

Except where otherwise noted, optional keywords with values have the following
defaults.
Numeric values 0
Character values blank

If a particular parameter is encountered more than once within a command, the last
occurrence of the parameter is used. If mutually exclusive parameters are
encountered within a command, the last occurrence is used.

DBRC Time Stamps

Time stamps are points in time recorded in the RECON. Correctly interpreting time
stamp formats found in RECON listings, messages, and dumps will help you enter
the appropriate time stamp in commands.

Standard Time Stamp Format

Certain parameters require a time stamp, which may be entered in one of the
following formats:
Compressed: yydddhhmmsst [offset]
Punctuated: [yy]yy|ddd|hh|mm|ss|t [offset]
where:
yyyy Is the year (0000 to 9999)
ddd Is the day (000 to 366)
hh Is the hour (0 to 23)
mm Is the minute (0 to 59)
ss Is the second (0 to 59)

Chapter 7. DBRC Commands 101

Command Syntax
t Is the tenth of a second (0 to 9)
| Can be any non-numeric character delimiter including blank
except the single quotation mark. If the time stamp
contains any blanks, commas, or parentheses, it must be
enclosed in single quotation marks. For example,
LIST.LOG STARTIME('94.252 08:24:45.7 -8')

or
LIST.LOG STARTIME('94,252 08:24:45.7 PST')

offset Can be one of the following:

1. Omitted. The current TIMEZIN value is used.
Related Reading: See “CHANGE.RECON” on
page 147 for more information on the TIMEZIN
parameter.
2. A numeric offset in the form ±h[h[:mm]] or ±h[h[mm]]
that, when added to UTC, gives local time. h[h] is a
numeric value from 0 to 14. For the compressed format
if mm is specified, then hh must also be specified. mm
is a value from the set {00, 15, 30, 45}.
±hh:mm is valid only between the values -11:45 to
+14:45.
±hhmm is valid only between the values -1145 to
+1445.
3. A symbolic time zone label.

The time stamp value might have elements truncated on the right, in which case the
omitted element’s digits are assumed to be zeros.

If only two digits are entered for the year, the two high order digits are extrapolated
by using the sliding-window method described in “Extrapolation of Two-digit Year
Input” on page 105.

The same time stamp value could be entered in the following ways:
942520824457
942520824457-0800
94.252/08:24:45.7

or with blank, commas, or parentheses:

'94.252 08:24:45.7 -8' '94/252-08.24.45.7 -8:00'
'94,252 08:24:45.7 PST' '94/252-16.24.45.7 UTC'
'1994 252 16.24.45.7 +0'

TIMEFMT Parameter Sublist:

TIMEFMT(sublist)
An optional parameter you use to define the form in which time stamps appear
in messages, displays, and listings from DBRC. The five values are positional.
Each is optional and can be omitted by including only the comma.

102 DBRC Guide & Reference

Command Syntax
The format of the TIMEFMT parameter sublist is as follows:

OO TIMEFMT ( ) OP
,
offset , A
offset_display

form ,
,
year_size ,
duration precision

If items of the sublist are omitted, the current values from the RECON header are
used.
offset
Specifies the offset that is to be applied to the UTC internal time before display.
U None-that is, display UTC when the event occurred.
O Offset of origin-that is, display local time when and where the event
occurred.
L Current local offset-that is, display the current-local-time equivalent.
offset_display
Specifies the display format of the offset that is appended to the time
L Specifies that the offset is to be displayed in label format, if a label has
been defined for it. If no label is defined, the offset is displayed in numeric
format.
O Specifies that the offset is to be displayed in the numeric (+|- HH:MM)
format.
N Specifies that no time zone information is to be displayed.
form
Specifies whether the time stamp is to be displayed in punctuated or
compressed form.
P Specifies that the time stamp is to be displayed in punctuated form.
C Specifies that the time is to be displayed in compressed form.
year_size
Specifies whether all four digits of the year are to be displayed or only the two
low-order digits.
2 Only the units and tens digits of the year are displayed.
4 All four digits of the year are to be displayed.
duration
Specifies the scope of these choices to be either limited to the current job or
used as global overrides to the system defaults. The duration subparameter
can only be specified on a CHANGE.RECON command.
PERM
Indicates that the specified options are to be in effect for any subsequent

Chapter 7. DBRC Commands 103

Command Syntax
DBRC utility job running with the same RECON; that is, these values
become the defaults for subsequent jobs.
TEMP
Indicates that the specified options are in effect only for the job in which the
command is entered. If neither PERM nor TEMP is coded, TEMP is
assumed.

Besides its use on the CHANGE.RECON command, the TIMEFMT parameter can
be coded on any LIST.xxx or GENJCL.xxx DBRC command. It can also be
specified in a skeletal JCL member as:
%SET TIMEFMT(....)

Here is an example of the %SET keyword in skeletal JCL.

%SET TIMEFMT(,N)
%SELECT RLDS(%SSID,LAST)
LOGEND =%LOGETIM
%ENDSEL

And here is what the output from the preceding example of %SET would render:
LOGEND =960111315000

Related Reading: See “Using the %SET TIMEFMT Keyword” on page 318 for
more examples of %SET output specifications.
precision
Coded only on a %SET statement in skeletal JCL as a number from 1 to 6. You
can use it to control the number of low-order digits contained in time stamps
that are output by GENJCL. The default is 1, which gives tenths of seconds.
DBRC normally ignores digits of a lower order than tenths of seconds. Full
timestamp precision is not required nor accepted for IMS utility JCL; it is only
intended for GENJCL output generated for user-specified purposes (normally
GENJCL.USER).
(As with other parameters, coding a null value causes the corresponding
TIMEFMT value to be reset to the GENJCL default. TIMEFMT() resets all values.)

TIMEFMT Subparameter Order of Precedence: The order of precedence of the

TIMEFMT subparameters, from lowest to highest, is as follows:
1. RECON defaults
The RECON defaults are established by the INIT.RECON command. These
defaults can be reset using the PERM option of the CHANGE.RECON command.
2. Job-level override
The RECON defaults can be overridden for the following commands in a SYSIN
command stream using either PERM or TEMP options of the CHANGE.RECON
command.
3. %SET statements in skeletal JCL members
The TIMEFMT settings in a %SET statement override the GENJCL default
settings, as well as settings from a previous %SET statement in the same
member.
4. Command override
The TIMEFMT settings in a DBRC command override all of the above settings
within the scope of that command invocation. For example, a GENJCL.xxx
command TIMEFMT setting overrides the TIMEFMT settings on any %SET
statement in the applicable skeletal JCL member.

104 DBRC Guide & Reference

Command Syntax
When coded on any command other than CHANGE.RECON, the last parameter,
duration, has no meaning; any TIMEFMT values coded override the values that are
currently in effect only for the duration of the command. For any omitted values, the
values currently in effect from the most recent CHANGE.RECON command with a
PERM duration, which override the INIT.RECON defaults, remain in effect.

Default Settings:

The values set in the RECON by INIT.RECON or the upgrade utility are
TIMEFMT(O,N,P,2).

The defaults used by GENJCL commands are TIMEFMT(O,O,C,2,1).

Recommendation: If your installation operates multiple IMS systems with different

time zones and they share data and a RECON; use UTC or LOC for RECON listings,
at least, so that all the time stamps listed have a common base.

Specifying Zero Time Stamp Values

A zero time stamp is valid only where explicitly allowed for a command keyword
value. A zero time stamp value, where permitted, can be entered in either
punctuated or compressed format, or can be condensed into a single digit. For
example, you can specify a zero time stamp in the following ways:
000000000000
'00 000 00:00:00.0'
0

If an offset value is given, it is ignored.

Extrapolation of Two-digit Year Input

Input time stamps on DBRC commands are accepted with the two-digit year
notation. In this case the century digits are derived for the use of the internal time
stamp. The century digits in the internal time stamp are determined from the two
entered digits by the following process:
The entered year digits are compared to a sliding window of 100 years. The
lower limit of the window is the current year minus 70. The upper limit is the
current year plus 29. A “breakpoint” is defined as the two low-order digits of the
lower limit.
If the entered digits are equal to, or greater than, the breakpoint; the century
digits of the lower limit are used. Otherwise, the century digits of the upper limit
are used. The upper and lower limits of the window and the breakpoint are
established when IMS is initialized. When the year changes, these values are
recomputed.

Time Stamp Conversions and Examples

Assume that local time is PST, offset -08:00, for the examples below:

An event occuring at 1998.030 10:00:0.1 -08:00 (punctuated format) yyyy ddd hh

mm ss t or 98030100001 -0800 (compressed format) yydddhhmmsst is recorded in
12 bytes in RECON as
1998030F|18000012|3456032d|
yyyyddd hhmmsstx xxxxfqqs
hh UTC, 8 hours later than local time
x xxxx
Low-order digits ignored by DBRC (except for GENJCL.USER output with
precision)

Chapter 7. DBRC Commands 105

Command Syntax
fqqs Offset:
f Flag bits, normally 0
qq Quarter hours (32/4=8)
s Sign (D is negative, C is positive)

Note: Offset is always added to UTC to obtain local time. To botain UTC from local
time, reverse the sign and add. Timestamp from a record in RECON, that is
PRILOG, lists as:
’1998.030 10:0:00.1 -08:00’

When the timestamp above is entered in a command with the quotes, DBRC finds
the record in RECON with the recorded timeas :
1998030F 18000012 3456032D

DBRC ignores the low-order time digits and the offset when searching. The UTC
date and time is determined.

If no offset is supplied in the timestamp, DBRC uses the TIMEZIN value which may
not be correct if a clock change has occurred since the time when the record was
written in RECON.

With the wrong offset supplied in a command, DBRC does not find the record.

Timestamp supplied and wrong offset is used:

’1998.030 16:00:00.1 -02:00’

DBRC determines an incorrect search time:

1998030F 18000012 3456008D

Timestamps from different RECON listings, even with timestamps displayed in

different formats, may be used freely, so long as the offsets are included.

Standard Default Settings for Timestamp Values

The RECON dataset timestamp formats are the standard default.

From the RECON header:

TIMEZIN=%SYS

OUTPUT FORMAT: DEFAULT = LOCORG NONE PUNC YY No user-defined labels

are defined.

Listing an allocation record without offset values lists the timestamp as:
99.027 19:03:47.0

The allocation record was written prior to daylight savings change. The timestamp is
entered on a command to list the record without an offset. With TIMEZIN=%SYS
set in RECON, the offset is obtained from current MVS clock which has changed.
The record is not found in RECON.

DBRC Commands Affected by the Time Stamp Format

These DBRC commands have time stamps as part of their syntax.

Related Reading: See “Standard Time Stamp Format” on page 101 for more
information on the standard time stamp format.

106 DBRC Guide & Reference

Command Syntax
CHANGE.BKOUT CHANGE.CA CHANGE.IC
CHANGE.PRILOG CHANGE.SECLOG CHANGE.UIC
DELETE.ALLOC DELETE.CA DELETE.IC
DELETE.LOG DELETE.RECOV DELETE.REORG
DELETE.UIC GENJCL.CA GENJCL.RECOV
GENJCL.USER LIST.HISTORY LIST.LOG
NOTIFY.ALLOC NOTIFY.BKOUT NOTIFY.CA
NOTIFY.IC NOTIFY.PRILOG NOTIFY.RECOV
NOTIFY.REORG NOTIFY.SECLOG NOTIFY.UIC

Use of Time History Table (THT)

DBRC uses the time history table to calculate time stamp offsets when lower
releases that do not contain offsets in their time stamps access a RECON that uses
time stamp offsets. If a time history table exists in RECON and DBRC already uses
offsets in its timestamps, the time history table is not used to calculate time stamp
offsets.

Using the Commands in This Book

The following sections describe how the commands are presented in this book.

Notational Conventions
DBRC commands generally have both required and optional parameters.

The following list of symbols is used to define the format of the DBRC commands.
The symbols, however, should not be used in an actual command unless indicated:
v A vertical bar (|) separates a pair of mutually exclusive parameters in a
command; the last one is used by DBRC.
v An ellipsis (...) indicates that multiple entries of the type immediately preceding
the ellipsis are allowed.
v Other punctuation (parentheses, commas, and spaces) must be entered exactly
as shown.
v Boldface type indicates the exact characters to be entered. Such items must be
entered exactly as shown.
v Lowercase words (for example, name) indicate parameters for which you supply
the value.
v A default value is indicated in one of two ways. In a syntax diagram, the default
appears above the horizontal line. In text, the default parameter is indicated by
underscored text and may be noted in a separate paragraph. If the parameter is
omitted, the default is assumed.

How to Read the Syntax Diagrams

The following rules apply to the syntax diagrams used in this book:
Arrow symbols
Read the syntax diagrams from left to right, from top to bottom, following
the path of the line.
))─── Indicates the beginning of a statement.
───) Indicates that the statement syntax is continued on the next line.
)─── Indicates that a statement is continued from the previous line.
───)+ Indicates the end of a statement.

Chapter 7. DBRC Commands 107

Command Syntax
Diagrams of syntactical units other than complete statements start with the
O─── symbol and end with the ───O symbol.
Conventions
v Keywords, their allowable synonyms, and reserved parameters, appear in
uppercase for MVS and OS/2 operating systems, and lowercase for
UNIX operating systems. These items must be entered exactly as shown.
v Variables appear in lowercase italics (for example, column-name). They
represent user-defined parameters or suboptions.
v When entering commands, separate parameters and keywords by at
least one blank if there is no intervening punctuation.
v Enter punctuation marks (slashes, commas, periods, parentheses,
quotation marks, equal signs) and numbers exactly as given.
v Footnotes are shown by a number in parentheses, for example, (1).
v A symbol indicates one blank position.
Required items
Required items appear on the horizontal line (the main path).

OO REQUIRED_ITEM OP

Optional Items
Optional items appear below the main path.

OO REQUIRED_ITEM OP
optional_item

If an optional item appears above the main path, that item has no effect on
the execution of the statement and is used only for readability.

optional_item
OO REQUIRED_ITEM OP

Multiple required or optional items

If you can choose from two or more items, they appear vertically in a stack.
If you must choose one of the items, one item of the stack appears on the
main path.

OO REQUIRED_ITEM required_choice1 OP
required_choice2

If choosing one of the items is optional, the entire stack appears below the
main path.

OO REQUIRED_ITEM OP
optional_choice1
optional_choice2

108 DBRC Guide & Reference

Command Syntax
Repeatable items
An arrow returning to the left above the main line indicates that an item can
be repeated.

OO REQUIRED_ITEM S repeatable_item OP

If the repeat arrow contains a comma, you must separate repeated items
with a comma.

OO REQUIRED_ITEM S repeatable_item OP

A repeat arrow above a stack indicates that you can specify more than one
of the choices in the stack.
Default keywords
IBM-supplied default keywords appear above the main path, and the
remaining choices are shown below the main path. In the parameter list
following the syntax diagram, the default choices are underlined.

default_choice
OO REQUIRED_ITEM OP
optional_choice
optional_choice

IMS-specific syntax information

Fragments
Sometimes a diagram must be split into fragments. The fragments
are represented by a letter or fragment name, set off like this: | A |.
The fragment follows the end of the main diagram. The following
example shows the use of a fragment.

OO STATEMENT item 1 item 2 A OP

item 3 KEYWORD
item 4 item 5

item 6

Substitution-block
Sometimes a set of several parameters is represented by a
substitution-block such as <A>. For example, in the imaginary
/VERB command you could enter /VERB LINE 1, /VERB EITHER
LINE 1, or /VERB OR LINE 1.

Chapter 7. DBRC Commands 109

Command Syntax
OO /VERB LINE line# OP
<A>

where <A> is:

OO EITHER OP
OR

Parameter endings
Parameters with number values end with the symbol '#', parameters
that are names end with 'name', and parameters that can be
generic end with '*'.

OO /MSVERIFY MSNAME msname OP

SYSID sysid#

The MSNAME keyword in the example supports a name value and

the SYSID keyword supports a number value.

DBRC Online Command Syntax

Related Reading: See IMS Version 7 Command Reference for details on DBRC
commands that can be entered online.

110 DBRC Guide & Reference

Chapter 8. BACKUP Command
The BACKUP command creates backup copies of the RECON.

BACKUP.RECON
RECON1
OO BACKUP.RECON OP
RECON2
BOTH

Use the BACKUP.RECON command to create backup copies of the RECON from the
Copy1 RECON. The command first opens the RECON and any needed cleanup is
done. The command then invokes the IDCAMS REPRO command, using its normal
defaults, to create the backup copy. Any restrictions applicable to the normal use of
the REPRO command apply to this command. The data set receiving the backup copy
must be empty.

If your RECON RECORDSIZE is greater than 32 KB, the BACKUP.RECON

command will fail if the back up is to a sequential data set. Do the following to back
up a sequential file (on tape for instance):
1. Create a backup KSDS using the BACKUP.RECON command
2. Use DFSMSdss to copy the backed-up KSDS to the sequential file
first create a backup KSDS using the BACKUP.RECON command

Parameters
RECON1 | RECON2 | BOTH
A required parameter that specifies the backup data set to which the RECON is
copied.
RECON1
Copies RECON to the backup data set specified by the BACKUP1 DD
statement of your JCL.
RECON2
Copies RECON to the backup data set specified by the BACKUP2 DD
statement of your JCL.
BOTH
Copies RECON to the data sets specified by the BACKUP1 and BACKUP2
DD statements of your JCL.

Example of Creating Backups of a RECON

In this example, two backup copies of the Copy1 RECON are created.
//BKUP JOB
//BACKUP1 DD . . .
//BACKUP2 DD . . .
.
.
.

//SYSIN DD *
BACKUP.RECON BOTH
/*

© Copyright IBM Corp. 1974, 2001 111

BACKUP
To create a sequential backup, the BACKUPx DD statement must include
appropriate DCB parameters. The BLKSIZE specified must be larger than the
maximum RECORDSIZE defined in the RECON, but less than 32K. For example,
DCB=(RECFM=VB,LRECL=32756,BLKSIZE=32760).

112 DBRC Guide & Reference

Chapter 9. CHANGE Commands
Use the CHANGE commands to change information in the RECON.

CHANGE.ADS
OO CHANGE.ADS ADDN(name) AREA(name) DBD(name) O
ADDNNEW(name)

UNAVAIL
O OP
ADSN(name) AVAIL

Use the CHANGE.ADS command to change DEDB ADS information in RECON. The
CHANGE.ADS command fails if you issue it while the area is in use.

To create an ADS entry see “INIT.ADS” on page 221.

Parameters
ADDN(name)
Required parameter you use to specify the area data set ddname of the ADS
being changed.
AREA(name)
Required parameter you use to identify the ADS being changed, by area name.
DBD(name)
Required parameter you use to identify the ADS being changed, by database
name
ADDNNEW(name)
Optional parameter you use to identify the ADS being changed, by new
ddname.
ADSN(name)
Optional parameter you use to identify the ADS being changed, by new data set
name.
AVAIL | UNAVAIL
Mutually exclusive, optional parameters you use to change the ADS record to
indicate its availability.
AVAIL
Indicates that the ADS is available. The CHANGE.ADS AVAIL command fails if
the area needs to be recovered.
UNAVAIL
Indicates that the ADS is unavailable.

If neither AVAIL nor UNAVAIL is specified but ADSN is specified, the value
defaults to UNAVAIL.

Example of Changing an ADS Record

In this example, an ADS record in RECON is being changed.

© Copyright IBM Corp. 1974, 2001 113

CHANGE.ADS
//CHGADS JOB
.
.
.

//SYSIN DD *
CHANGE.ADS DBD(DBD001) AREA(AREA002) -
ADSN(ADSN004) ADDN(ADDN004)
/*

CHANGE.BKOUT
OO CHANGE.BKOUT SSID(name) UOR(uor) UORTIME(time stamp) O

O O
DELETE( UOR ) PSB(name) ,
ALL
, DBD( S name )

S name

O OP
,

BKO( S name )

Use the CHANGE.BKOUT command to add, change, or delete a unit of recovery (UOR)
in the backout record that is associated with a specified subsystem.

Recommendation: Use the CHANGE.BKOUT command when a dynamic backout

failure has occurred and certain known backout records are invalid. Using the
CHANGE.BKOUT command incorrectly can result in a loss of recovery integrity.

Parameters
SSID(name)
Required parameter that specifies the subsystem for which the backout record
is to be changed. The name is an alphanumeric string, with up to eight
characters, that represents any valid subsystem name.
UOR(uor)
Required parameter that you use in conjunction with the UORTIME parameter
to identify a unit of recovery in the backout record. The recovery token (uor) is
16-byte field that describes a specific UOR in the backout record. The value for
this parameter must be expressed as 32 hexadecimal digits.
This parameter can specify a unit of recovery that currently exists in the
backout record or one that is to be added to the record.
UORTIME(time stamp)
Required parameter that specifies the time of the UOR described above. The
value is the beginning time of the UOR (found in the X'5607' log record). The
time stamp must be in standard form.
DELETE(UOR | ALL | name...)
Optional parameter used to delete some or all of the information related to the
unit of recovery that is specified by the required parameters described above.

114 DBRC Guide & Reference

CHANGE.BKOUT
UOR
Deletes the entire UOR defined by the required UOR and UORTIME
parameters described above. If you do not specify DELETE(UOR),
CHANGE.BKOUT assumes you are changing an existing UOR or adding a UOR
that is not currently in the backout record.
If you specify DELETE(UOR), all other optional parameters are ignored.
If the UOR does not exist in the backout record, the command fails.
ALL
Specifies that the database entries for the specified UOR and UORTIME
are deleted, but that the UOR prefix information is left intact, if you also
specify database names in the DBD parameter, the BKO parameter, or
both. If you do not specify database names in DBD or BKO, CHANGE.BKOUT
acts as if DELETE(UOR) is specified. You can use the ALL option to replace,
or substantially alter, a database list within a UOR entry of a backout record
without disturbing the control data in the UOR’s prefix. You can also use the
ALL option to delete all database entries in the UOR except those that are
listed in the DBD or BKO parameters.
name
Specifies up to eight database names for use with the DELETE parameter.
Use a comma to separate each specified name. If you list all of the
databases associated with the specified unit of recovery, CHANGE.BKOUT acts
as if DELETE(ALL) is specified.
If any listed database name is not in the specified UOR, the command fails.

The following optional parameters can only be used if you do not specify
DELETE(UOR). If the UOR already exists in the backout record, you must provide at
least one of the optional parameters. If the UOR does not exist in the backout
record, it is added. In this case, you must specify the PSB and either the DBD
parameter or the BKO parameter.

You can specify either the BKO parameter, the DBD parameter, or both. However,
the same database name cannot appear in both the BKO and the DBD parameters,
because a database cannot be both backed out and require a backout at the same
time.
PSB(name)
Optional parameter that identifies the PSB associated with the UOR. To add a
UOR to the backout record, you must specify PSB(name). If the UOR defined
by the required parameters already exists in the backout record, the specified
PSB name replaces the current PSB name.
DBD(name...)
Optional parameter that identifies databases associated with the specified UOR.
Up to eight database names can be listed with the DBD parameter. The
database names listed here identify the databases that require backout for this
unit of recovery. This parameter can be used to change the status of an existing
database entry to backout required.
BKO(name...)
Optional parameter that identifies databases to which the UOR applies. Use
BKO to identify databases that have already been backed out from this UOR.
Up to eight database names can be specified with the BKO parameter. This
parameter can be used to change the status of an existing database entry to
backout completed.

Chapter 9. CHANGE Commands 115

CHANGE.BKOUT
Example of Using the CHANGE.BKOUT Command
//CHGBKOUT JOB
.
.
.

//SYSIN DD *
CHANGE.BKOUT SSID(SYS3)—
UOR(E2E8E2F34040400000000600000003)—
UORTIME(930931345027) DELETE(ALL)—
DBD(DATA1,DATA2,DATA3C)—
BKO(DATA4,DATA5,DATA3A)
/*

CHANGE.CA
OO CHANGE.CA GRPNAME(name) RECTIME(time stamp) O
CADSN(name)

O O
FILESEQ(value) INVALID 3400
VALID UNIT( unittype )

O OP
, COMP
SUBSET
VOLLIST( S volser )

Use the CHANGE.CA command to change information about a specified run of the
Change Accumulation (CA) utility for an identified CA group in RECON.

Parameters
GRPNAME(name)
Required parameter you use to specify the name of the CA group for which
information is to be changed.
RECTIME(time stamp)
Required parameter you use to identify the change accumulation run record that
you are changing.
Use the STOP time marked with an asterisk (*) from the listing of the CA
record. The time stamp must be in standard form (see “Standard Time Stamp
Format” on page 101).
CADSN(name)
Optional parameter you use to specify the new name of the change
accumulation data set in the identified record.
FILESEQ(value)
Optional parameter you use to specify a new file sequence number that is to be
recorded in the identified record.
INVALID | VALID
Mutually exclusive, optional parameters you use to specify whether a change
accumulation data set is to be used as input for a subsequent run of change
accumulation or database recovery.

116 DBRC Guide & Reference

CHANGE.CA
INVALID
Specifies that the change accumulation data set is not to be used as input
for a subsequent run of change accumulation or database recovery. If an
invalidated change accumulation data set is subsequently reused for output
by change accumulation, it is automatically marked as valid and is used.
See “INIT.CAGRP” on page 223 for an explanation of the REUSE
parameter.
VALID
Specifies that the previously invalidated change accumulation data set is
available for use as input to a subsequent run of change accumulation or
database recovery. Use this parameter only if the change accumulation
data set was previously marked as invalid and is now valid.

Specifying the INVALID parameter causes the STOPTIME and RUNTIME of the
change accumulation record to be swapped. This prevents duplicate records in
the RECON. Specifying the VALID parameter causes the STOPTIME and
RUNTIME to be swapped back.
UNIT(3400 | unittype)
Optional parameter you use to change the unit type of the volumes on which
the change accumulation data set resides. The unit type can be up to eight
alphanumeric characters long.
VOLLIST(volser)
Optional parameter that can be listed, that you use to replace the volume serial
numbers of the change accumulation data set in the specified change
accumulation run record. You can substitute up to 255 volume serial numbers in
the variable field; each can be up to six alphanumeric characters long.
SUBSET | COMP
Mutually exclusive, optional parameters you use to indicate the change
accumulation status.
SUBSET
Indicates that when the CA was created, a subset of logs were processed
and the CA’s stop time is the start time of the first unprocessed log volume.
COMP
Indicates that when the CA was created, a complete set of logs were
processed and the CA’s stop time is the stop time of the last log volume
that was processed.

You do not need to use this parameter under normal conditions. Checking is not
done to verify that the use of this parameter is consistent with the value of the
CA stop time. This parameter value is used by the GENJCL.CA and GENJCL.RECOV
processes. Incorrect use can result in invalid generated JCL.

Example of Changing a Change Accumulation Run Record

In this example, a change accumulation run record in RECON is being changed.
The INVALID parameter indicates that the identified data set is not to be used as
input to a subsequent run of a utility. The VOLLIST, FILESEQ, and CADSN
parameters indicate additional fields in the record that are to be changed.
//CHGCA JOB
.
.
.

//SYSIN DD *

Chapter 9. CHANGE Commands 117

CHANGE.CA
CHANGE.CA GRPNAME(CAGRP2) RECTIME(820650204335) -
INVALID CADSN(IMS.CAGRP2.CA.CADSN2) -
VOLLIST(VOLCA1) FILESEQ(4)
/*

CHANGE.CAGRP
OO CHANGE.CAGRP GRPNAME(name) O
,

ADD( S (dbname,ddname) )
,

DELETE( S (dbname,ddname) )

O OP
CAJCL(member) DEFLTJCL(member) GRPMAX(value) NOREUSE
NODEFLT REUSE

Use a CHANGE.CAGRP command to modify information contained in a specified CA

group record in RECON. You can change the names of DBDSs that are members
of a CA group with this command.

Restriction: Index and ILDS DBDSs are not recoverable, and changes to them
are not logged. The CHANGE.CAGRP command does not support these data sets.

Parameters
GRPNAME(name)
Required parameter you use to specify the name of the CA group whose record
you want to modify.
ADD(dbname,ddname) | DELETE(dbname,ddname)
Mutually exclusive, optional parameters you use to specify the member you
want to add to or delete from the specified CA group.
ADD
Specifies members you are adding to the identified CA group. A group
cannot have more than 2000 members.
DELETE
Specifies members you are deleting from the identified CA group. When
you have deleted a member from a CA group, DBRC has no knowledge of
previous change accumulation activities on that DBDS.

Specify a list of one or more members in the variable field; each member is a
pair of names enclosed in parentheses. dbname is the member’s database
name. ddname is the symbolic name of the DD statement.

If you delete all the members of a group, the record of that group is deleted
from RECON.
CAJCL(member)
Optional parameter you use to change the name of a member of a partitioned

118 DBRC Guide & Reference

CHANGE.CAGRP
data set of skeletal JCL. The member is used to generate the JCL for a run of
the Change Accumulation utility when you issue a GENJCL.CA command for the
specified CA group.
DEFLTJCL(member) | NODEFLT
Mutually exclusive, optional parameters you use to specify the implicit skeletal
JCL default member for the CA group.
DEFLTJCL
Specifies an implicit skeletal JCL default member for the CA group.
GENJCL.CA uses the default member you specify in order to resolve
keywords you have defined. For more information, see “GENJCL.CA” on
page 189.
NODEFLT
Specifies that no skeletal JCL default member is to be used for the CA
group.
GRPMAX(value)
Optional parameter you use to modify the number of change accumulation data
sets to be maintained for the specified CA group. The value you substitute in
the variable field must be a decimal number from 2 to 1024.
If you are increasing the GRPMAX value and REUSE is specified, you should
use the INIT.CA command to add additional change accumulation data sets. If
the number of data sets does not equal GRPMAX, reuse does not take place
and you eventually run out of available data sets for the utility.
NOREUSE | REUSE
Mutually exclusive, optional parameters you use to indicate whether change
accumulation data sets should be reused.
NOREUSE
Indicates that change accumulation data sets that were already used for the
specified CA group cannot be reused as output data sets in subsequent
runs of the Change Accumulation utility. Any existing, unused change
accumulation run records for the specified CA group are deleted when you
specify the NOREUSE keyword.
REUSE
Indicates that change accumulation data sets that were already used for the
specified CA group can be reused as output data sets in subsequent runs
of the Change Accumulation utility.
If GRPMAX is higher than the number of existing data sets for the group,
you should use the INIT.CA command to add additional data sets;
otherwise reuse does not take place. See the explanation for GRPMAX on
page 119.

For additional information about reusing change accumulation data sets, see
the explanation of the REUSE parameter “INIT.CAGRP” on page 223.

Examples of Using the CHANGE.CAGRP Command

Here are several examples of things you can do using the CHANGE.CAGRP command.

Example of Adding DBDSs to the Existing CA Group CAGRP1

In this example, the DBDSs identified by the dbname and ddname parameters are
to be added to the existing CA group, CAGRP1.

Chapter 9. CHANGE Commands 119

CHANGE.CAGRP
//CHGCAGRP JOB
.
.
.

//SYSIN DD *
CHANGE.CAGRP GRPNAME(CAGRP1) ADD((DB1,DD1),(DB2,DD2))

Example of Deleting DBDSs from the CA Group CAGRP1

In this example, the DBDSs identified by the dbname and ddname parameters are
to be deleted from the CA group, CAGRP1.
//CHGCAGRP JOB
.
.
.

//SYSIN DD *
CHANGE.CAGRP GRPNAME(CAGRP1) DELETE((DB3,DD3),(DB4,DD4))

Example of Changing a CA Group Record

In this example, a CA group record in RECON is being changed. The changes are
made to prevent the reuse of CA data sets by the Change Accumulation utility. It
also renames the member of the partitioned data set of skeletal JCL that is used for
generating the JCL that is needed for the Change Accumulation utility for this CA
group.
//CHGCAGRP JOB
.
.
.

//SYSIN DD *
CHANGE.CAGRP GRPNAME(CAGRP3) NOREUSE CAJCL(JCLCA)
/*

CHANGE.DB
ALL
OO CHANGE.DB DBD(name) O
AUTH NOBACK
NOAUTH BACKOUT(value) SSID(name)

O O
PINIT READON SHARELVL( 0 ) NONRECOV TYPEFP
NOPINIT READOFF 1 RECOVABL TYPEIMS
2
3

O OP
GSGNAME(gsgname) RCVTRACK
NOTCOVER DBTRACK

Or:

ACTIVE
OO CHANGE.DB UNAUTH DBD(name) SSID(name) OP
AREA(name) TRACKING

120 DBRC Guide & Reference

CHANGE.DB
Use a CHANGE.DB command to change the information about a database or a Fast
Path DEDB area. This information is contained in a database record or area record
in RECON. If you specify the parameters SHARELVL, TYPEFP, or TYPEIMS while
the database or an area of the DEDB is in use, the command fails.

You can also use CHANGE.DB to remove a rare authorization inconsistency between
the subsystem (SSYS) record and the data base or area (DB/AREA) record. This
inconsistency occurs when either the SSYS record still has an entry for the
DB/AREA in its authorized data bases/areas list but the DB/AREA record no longer
contains the SSID entry in its associated subsystem information list or the SSID
entry is still in the DB/AREA but the SSYS record either no longer exists in RECON
or no longer contains an entry for the DB/AREA. Use the AUTH parameter with the
syntax shown above.

Restrictions: The following restrictions apply when you use the UNAUTH
parameter:
v Only the DBD, AREA, SSID, and ACTIVE | TRACKING parameters are valid with
UNAUTH. If any other parameters are specified, the command fails.
v If AREA, ACTIVE, or TRACKING is specified without UNAUTH, the command
fails.
v If the inconsistency between the SSYS and DB/AREA records as described
above does not exist then the command fails.
v The ACTIVE or TRACKING parameter must match the SS ROLE field in the
associated subsystem information entry of the specified database or area. If
these do not match, the command fails.

Parameters
DBD(name) | ALL
Mutually exclusive, required parameters you use to identify the database for
which the record is to be changed.
DBD
Specifies that you are changing the record of a single database.
For HALDBs, specifies the name of a HALDB partition or the HALDB
master (if you want to change all partitions of the HALDB master). For
HALDBs, you can use the CHANGE.DB command only as follows:

CHANGE.DB TYPE=HALDB TYPE=PART

Restriction: If you specify the UNAUTH parameter, you must specify the
DBD name. The ALL parameter is not valid with UNAUTH.
ALL
Specifies that you are changing all the databases registered in RECON.

Chapter 9. CHANGE Commands 121

CHANGE.DB
If any of the DBs are HALDB masters or partitions, and you have specified
any of the restricted parameters (for example, the PINIT or NOPINIT
parameters), a warning message is issued and command processing
continues.
AUTH | NOAUTH
Mutually exclusive, optional parameters you use to specify whether the
database is authorized to participate in data sharing.
AUTH
Indicates that authorization processing for data sharing is permitted for the
database.
NOAUTH
Indicates that authorization processing for data sharing is prohibited for the
database.
GSGNAME(gsgname) | NOTCOVER
Mutually exclusive, optional parameters you use to assign the remote site
recovery attributes of a DL/I database.
GSGNAME
Assigns the database to a global service group (GSG).
NOTCOVER
Discontinues remote site recovery for the database.

You cannot use CHANGE.DB to change the state of a database from

non-RSR-covered to RSR-covered. Message DSP1044I is issued if you attempt
to change the covered state of the database with this command. In order to
change a database from not covered to covered, issue the following two
commands for the database:
v DELETE.DB
v INIT.DB

Neither GSGNAME nor NOTCOVER can be specified for Fast Path DEDBs. For
DL/I databases, neither GSGNAME nor NOTCOVER can be specified while the
database is in use. A non-recoverable database cannot be assigned to a GSG.
NOBACK | BACKOUT(value)
Mutually exclusive, optional parameters you use to specify whether the
database needs backout by any subsystem. Do not use these parameters for a
DEDB.
NOBACK
Indicates that the specified subsystem does not need to back out the
database. You use this parameter to delete backout information in the
specified database record.
If the held AUTH state and ENCODED state are zero, and if the
BACKOUT-NEEDED flag is on, using the NOBACK parameter causes the
associated subsystem information to be deleted from the database record.
BACKOUT
Indicates that the specified subsystem needs to back out the database the
specified number of times. You need to specify the subsystem name with
the SSID parameter. If you do not specify the SSID parameter with the
BACKOUT parameter, this command fails.

122 DBRC Guide & Reference

CHANGE.DB
SSID(name)
Required parameter specifying which subsystem encountered the backout
errors.
name is any valid subsystem name.
With UNAUTH, SSID indicates which entry is to be removed from the
associated subsystem information list of the database specified with the
DBD parameter, or which SSYS record is to be changed by removing the
specified DB/AREA from the authorized data bases/areas list.
SSID is required with either the BACKOUT or UNAUTH parameters If
coded without either BACKOUT or UNAUTH, the command fails.
NONRECOV | RECOVABL
Mutually exclusive, optional parameters used to specify whether update logs of
the specified database are recorded in the RECON. These parameters work
with a specified DBD(name) and do not work if ALL is specified.
If the database is registered as RECOVABL, VIO data sets cannot be used for
the output log (IEFRDER) in any job that updates the database. Temporary log
data sets, such as VIO, are deleted at job termination. Therefore, they are not
usable for recovery.
NONRECOV
Specifies that no recovery is to be performed on the database. These
parameters are meaningful for TYPEIMS databases only, and are rejected
for TYPEFP databases.
NONRECOV cannot be specified for an RSR-covered database.
RECOVABL
Specifies that the database is recoverable and all updates performed for the
DBDSs are to be registered in the RECON.
PINIT | NOPINIT
Mutually exclusive, optional parameters used to specify whether a HALDB
partition needs to be initialized. Use this parameter after deleting and redefining
one or more partition data sets without changing the database definition.
If the database specified by DBD parameter is a HALDB master, the change is
made to all partitions. Otherwise, only the partition that is specified is changed.
Restriction: The PINIT|NOPINIT parameters are not valid with ALL.
PINIT
Indicates that the partition needs to be initialized using the DB
Prereorganization utility or the HALDB Partition Data Set Initialization utility.
NOPINIT
Indicates that the partition does not need to be initialized.
RCVTRACK | DBTRACK
Mutually exclusive, optional parameters you use to specify the type of RSR
tracking (shadowing) for a database that is assigned to a GSG.
RCVTRACK
Indicates recovery-readiness tracking.
DBTRACK
Indicates database-readiness tracking.

Chapter 9. CHANGE Commands 123

CHANGE.DB
Neither RCVTRACK nor DBTRACK can be specified for Fast Path DEDBs. For
DL/I databases, RCVTRACK or DBTRACK can only be specified if the
database is assigned to a GSG and is not currently in use.
READON | READOFF
Mutually exclusive, optional parameters you use to specify whether the
database can be restricted to read only processing only. Do not use either
parameter for a DEDB.
READON
Specifies that the database can be authorized only for read processing.
READOFF
Specifies that the database can be authorized for both read processing and
update processing.
SHARELVL(0 | 1 | 2 | 3)
Optional parameter you use to specify the level of data sharing for which
authorized subsystems can share a database. You cannot specify this
parameter for authorized DL/I databases.
The numbers 0, 1, 2, and 3 define the four types of data sharing levels.
0 Indicates that the database cannot be shared.
1 Indicates that the database can be shared by one IMS subsystem
authorized for update and other IMS subsystems authorized only for
read processing (no integrity processing). 1 can also indicate that the
database can be shared by multiple IMS subsystems that have been
authorized only for read processing. Level 1 is known as database-level
sharing.
2 Indicates that the database can be shared by multiple, concurrent
subsystems that have been authorized for update in a single-host
processor environment. Level 2 is known as intrahost, block-level
sharing.
3 Indicates that the database can be shared by multiple, concurrent
subsystems that have been authorized for update in a multiple-host
processor environment. Level 3 is known as interhost, block-level
sharing.

For more information on data sharing levels and dynamic allocation, see IMS
Version 7 Utilities Reference: System.

Restrictions:
v The SHARELVL parameter must be greater than 0 for concurrent image
copies.
v If you are using IRLM, and have specified SHARELVL 2 or 3, ensure that the
VSAM SHAREOPTIONS (3 3) parameter is also specified.
For more information on coordinating VSAM data set definitions with share
options, see IMS Version 7 Administration Guide: System.
v The SHARELVL parameter applies to all areas in the DEDB.
v If you change a DEDB from level 0 or 1 to level 2 or 3, the first coupling
facility structure name (CFSTR1) for all VSO areas in the DEDB is set to the
name of the area. If you change a DEDB from level 2 or 3 to level 0 or 1,
DBRC resets any specified coupling facility structure names to zeros and

124 DBRC Guide & Reference

CHANGE.DB
resets the LKASID parameter to NOLKASID. See “CHANGE.DBDS” on
page 126 for explanations of the CFSTR1, LKASID, and NOLKASID
parameters.
TYPEFP | TYPEIMS
Mutually exclusive, optional parameters you use to change the RECON record
structure to a Fast Path DEDB or a DL/I database.
TYPEFP
Specifies that the database is a Fast Path DEDB and that the record
structure in RECON must be changed from IMS to Fast Path. TYPEFP
cannot be specified for an RSR-covered DL/I database.
TYPEIMS
Specifies that the database is a DL/I database and that the record structure
in RECON must be changed from Fast Path to IMS. TYPEIMS cannot be
specified if any area of a DEDB is covered by RSR.
UNAUTH
Removes an entry from the associated subsystem information list in the
database specified by the DBD parameter, or removes an entry from the
authorized data bases/areas list in the SSYS record specified by the SSID
parameter. You must specify the following parameters when you use UNAUTH:
DBD(name) For the database name
AREA If the database is a Fast Path DEDB
SSID(name) For the IMS subsystem ID
TRACKING If the IMS subsystem is an RSR tracking subsystem
AREA(name)
Required when UNAUTH is specified for a Fast Path DEDB. The name is the
name of the DEDB area. If you specify AREA without UNAUTH, the command
fails.
ACTIVE | TRACKING
Indicates the role of the specified subsystem when UNAUTH is specified. These
parameters are ignored unless UNAUTH is specified.
ACTIVE
Specifies that the subsystem is an RSR active subsystem.
TRACKING
Specifies that the subsystem is an RSR tracking subsystem.

Example of Changing a Record for a DB Identified with the DBD Parm

This example specifies changes to be made to a record in RECON for the database
identified with the DBD parameter. The level of data sharing is specified, and the
database needs one backout.
//CHGDB JOB
.
.
.

//SYSIN DD *
CHANGE.DB DBD(THISDBD) NOAUTH READOFF SHARELVL(2) -
BACKOUT(1) SSID(IMSID1)
/*

Chapter 9. CHANGE Commands 125

CHANGE.DBDS

CHANGE.DBDS
OO CHANGE.DBDS DBD(name) DDN(name) O
AREA(name) ,

ADDEQE( S value )
,

DELEQE( S value )

O O
CFSTR1(name) CFSTR2(name) AUTH DDNNEW(name)
NOCFSTR2 NOAUTH AREANEW(name)

O O
DEFLTJCL(member) DSN(name) GENMAX(value) GSGNAME(gsgname)
NODEFLT NOTCOVER

O O
ICJCL(member) ICON NOREUSE OICJCL(member) LKASID
ICOFF REUSE NOLKASID

O O
PRELOAD
NOPREL

O O
PREOPEN RCVTRACK RECOV RECOVJCL(member)
NOPREO DBTRACK NORECOV

O OP
RECOVPD(value) RECVJCL(member) VSO
NOVSO

Use a CHANGE.DBDS command to change the information about a DBDS. This

information is contained in a DBDS record in RECON. If you specify DSN,
DDNNEW, or AREANEW while the database or an area of a DEDB is in use, the
command fails.

Restrictions for HALDBs: For HALDBs, you can use this command only as
follows:

CHANGE.DBDS TYPE=PART Data TYPE=PART Index/ILDS

126 DBRC Guide & Reference

Parameters
DBD(name)
Required parameter you use to identify by its database name the DBDS or
DEDB area whose record is to be changed.
DDN(name) | AREA(name)
Mutually exclusive, required parameters you use to identify the DBDS or DEDB
area whose record is to be changed. When you specify DDN, you specify the
ddname of the DBDS. When you specify AREA, you specify the name of the
area.
ADDEQE(value) | DELEQE(value)
Mutually exclusive, optional parameters you use to change the error queue
elements of a DBDS.
ADDEQE
Adds error queue elements to a DBDS. Error queue elements indicate that
an I/O error occurred on the data set and that the data set therefore needs
to be recovered. Processing continues except for that part of the data set
described by the error queue element. Error queue elements can be added
only when the DBDS is not in use. The value specified in the variable field
is one or more 4-byte hexadecimal values enclosed in quotes; for example,
ADDEQE(X'00002345', X'00012345', ...).
DELEQE
Deletes error queue elements from a DBDS. Deletion of error queue
elements indicates that recovery processing has occurred on that data set.
Error queue element deletions can be done only when the DBDS is not in
use. The value specified in the variable field is one or more 4-byte
hexadecimal values enclosed in quotes; for example, DELEQE(X'00002345',
X'00012345', ...).

When you add an EQE to a database, the RECOV-NEEDED flag is

automatically turned on. When you delete an EQE, and no other EQE flags
exist for the database, the RECOV needed flag is turned off. Do not specify
RECOV or NORECOV when specifying the ADDEQE or DELEQE parameters.

Chapter 9. CHANGE Commands 127

CHANGE.DBDS
CFSTR1(name)
Optional parameter you specify to change the name of the first coupling facility
structure for the identified VSO area. Adhere to the MVS coupling facility
structure naming conventions. This parameter is valid only for VSO areas of
DEDBs that are defined with SHARELVL(2 | 3). The area name is the default if
the area is changed to VSO and the DEDB is SHARELVL(2 | 3). CFSTR1 is not
allowed if the area is authorized, unless it is also being changed from NOVSO
to VSO.
CFSTR2(name) | NOCFSTR2
Mutually exclusive, optional parameters you use to update or remove the name
of the second coupling facility structure for the identified VSO area. These
parameters are valid only for VSO areas of DEDBs that are defined with
SHARELVL(2 | 3). These parameters are allowed for an authorized area only if
it is being changed from NOVSO to VSO.
CFSTR2(name)
Specifies the new name of the second coupling facility structure. Adhere to
the MVS coupling facility structure naming conventions.
Related Reading: See IMS Version 7 Administration Guide: Database
Manager for details on coupling facility structure naming conventions.
NOCFSTR2
Removes the name of the second coupling facility structure (CFSTR2).
AUTH | NOAUTH
Mutually exclusive, optional parameters you use to specify whether the area is
available for authorization processing. The AUTH and NOAUTH parameters are
valid only if you have specified the AREA parameter.
AUTH
Specifies that the area is available for authorization processing.
NOAUTH
Specifies that authorization processing is prohibited for the area.

If you specify the CHANGE.DBDS AREA(name) RECOV command, all ADSs that
belong to that area are set to unavailable status at the same time.
DDNNEW(name) | AREANEW(name)
Mutually exclusive, optional parameters you use to change either the database
ddname of the specified DBDS or the area name of the specified Fast Path
DEDB area in RECON.
When you specify this parameter, the new ddname replaces the existing
ddname for all records in RECON that correspond to the specified DBDS.
You must supply a ddname for the IMS DBDLIB data set in the JCL for the
CHANGE.DBDS command. The new ddname must be defined in the IMS DBD
library and its numeric data set identifier must be unchanged; it also cannot
already exist in RECON.
AREANEW is valid only if you have specified the AREA parameter.
DEFLTJCL(member) | NODEFLT
Mutually exclusive, optional parameters you use to specify an implicit skeletal
JCL default member for the DBDS.
DEFLTJCL
Specifies the new implicit skeletal JCL default member for the DBDS. The

128 DBRC Guide & Reference

CHANGE.DBDS
specified member is used by the GENJCL.IC, GENJCL.OIC, and GENJCL.RECOV
commands to resolve keywords you have defined.
NODEFLT
Removes the default JCL name from the DBDS record when you do are not
using a default JCL member.
DSN(name)
Optional parameter you use to change the data set name of the identified
DBDS. You cannot use this parameter for a DEDB area.
GENMAX(value)
Optional parameter you use to change the maximum number of image copy
data sets DBRC is to maintain for the specified DBDS or DEDB area. value
must be a decimal number from 2 to 255.
If the value you specify is smaller than the number of image copy data sets
currently existing for the specified DBDS, records of image copy data sets that
are beyond the recovery period are deleted from RECON until the number
reaches the specified GENMAX value. Records of image copy data sets with
the oldest time stamps are deleted until the number that remains equals the
specified GENMAX value.
If you are increasing the GENMAX value and REUSE is specified, you should
use the INIT.IC command to create additional image copy records in RECON.
If the number of data sets does not equal GENMAX, reuse does not take place
and you eventually run out of available data sets for the utility.
GSGNAME(gsgname) | NOTCOVER
Mutually exclusive, optional parameters you use to assign the remote site
recovery attributes of a DEDB area.
GSGNAME
Assigns the area to a global service group (GSG).
NOTCOVER
Discontinues remote site recovery for the area.

GSGNAME and NOTCOVER are only valid if AREA is specified.

You cannot use CHANGE.DBDS to change the state of an area from

non-RSR-covered to RSR-covered. Message DSP1044I is issued if you attempt
to change the covered state of the area with this command. In order to change
an area from non-RSR-covered to RSR-covered, issue the following two
commands for the area:
v DELETE.DBDS
v INIT.DBDS
ICJCL(member)
Optional parameter you use to change the name of the member of the
partitioned data set of skeletal JCL. The GENJCL.IC command uses this name to
generate the JCL for a run of the Database Image Copy utility for the specified
DBDS or DEDB area.
ICON | ICOFF
Mutually exclusive, optional parameters you use to specify whether a database
needs an image copy.

Chapter 9. CHANGE Commands 129

CHANGE.DBDS
ICON
Specifies that a DBDS needs to have an image copy taken. In the
associated database record, a counter increases to indicate how many
DBDSs need an image copy.
ICOFF
Specifies that a DBDS does not need an image copy. In the associated
database record, a counter decreases to indicate the number of DBDSs
that need an image copy.
NOREUSE | REUSE
Mutually exclusive, optional parameters you use to indicate whether image copy
data sets can be reused for subsequent image copy jobs.
NOREUSE
Indicates that image copy data sets already used for the specified DBDS or
DEDB area are not to be reused for subsequent image copies. Any existing,
unused image copy data set records for the specified DBDS or DEDB area
are deleted.
REUSE
Indicates that image copy data sets already used for the specified DBDS or
DEDB area can be made available for reuse by subsequent image copies.
You cannot specify REUSE if RECON contains any nonstandard image
copy data set records for the DBDS or DEDB area.
If GENMAX is higher than the number of existing data sets for the group,
you should use the INIT.IC command to add additional data sets;
otherwise reuse does not take place. See the explanation for 129.

For additional information about reusing image copy data sets, see “INIT.DBDS”
on page 227 for an explanation of the REUSE parameter.
OICJCL(member)
Optional parameter you use to change the name of the partitioned data set
member of skeletal JCL. You cannot use this parameter for a DEDB area. The
GENJCL.OIC command uses this name to generate the JCL for a run of the
Online Database Image Copy utility for the specified DBDS.
LKASID | NOLKASID
Mutually exclusive optional parameters you use to specify whether local data
caching for the specified area is to be used for buffer lookaside on read
requests. The LKASID option is valid only for VSO areas that are specified as
SHARELVL(2 | 3). These parameters are allowed for an authorized area only if
it is being changed from NOVSO to VSO.
LKASID
Indicates that buffer lookaside is to be performed on read requests for this
area.
NOLKASID
Indicates that buffer lookaside is not to be performed on read requests for
this area.
PRELOAD | NOPREL
Mutually exclusive, optional parameters you use to specify whether a VSO
DEDB area is to be loaded the next time it is opened.
PRELOAD
Indicates that the area is to be loaded into the data space the next time it is
opened. Selecting this option also causes the area to be preopened.

130 DBRC Guide & Reference

CHANGE.DBDS
NOPREL
Indicates that the VSO area is not to be loaded into the data space the next
time it is opened. CIs are copied into a data space when they are read for
the first time.
PREOPEN | NOPREO
Mutually exclusive, optional parameters you use to specify whether a VSO
DEDB area is to be opened either, after the first checkpoint following the next
control region initialization, or when the next /STA AREA command is processed.
PREOPEN
Indicates that the area is to be opened the next time the control region is
started or a /STA AREA command is processed. This option is valid for both
VSO and non-VSO areas.
NOPREO
Indicates that the area is not to be preopened the next time the control
region is started or a /STA AREA command is processed. You cannot specify
this parameter with the PRELOAD parameter.
RCVTRACK | DBTRACK
Mutually exclusive, optional parameters you use to specify the type of RSR
tracking (shadowing) for an area assigned to a GSG.
RCVTRACK
Indicates recovery-readiness tracking.
DBTRACK
Indicates database-readiness tracking.

Restriction:

RCVTRACK and DBTRACK can only be specified if AREA is specified and the
area is assigned to a GSG.
RECOV | NORECOV
Mutually exclusive, optional parameters you use to specify whether a DBDS or
DEDB area needs to be recovered.
RECOV
Specifies that the DBDS or area needs to be recovered. A
RECOVER-NEEDED counter in the associated database record is
increased to indicate the number of DBDSs that need to be recovered.
NORECOV
Specifies that the DBDS or DEDB area does not need to be recovered. A
RECOVERY-NEEDED counter in the associated database record is
decreased to indicate the number of DBDSs that have been recovered.
RECOVJCL(member)
Optional parameter you use to change the name of a member of the partitioned
data set of skeletal JCL. The GENJCL.RECOV command uses the member to
generate the JCL for a run of DBRC for the specified DBDS or DEDB area.
RECOVPD(value)
Optional parameter you use to change the recovery period of the image copies
for a specified DBDS or DEDB area.
value must be a number from 0 to 999 that represents the number of days the
image copies are to be kept in RECON. A 0 indicates no recovery period.

Chapter 9. CHANGE Commands 131

CHANGE.DBDS
RECVJCL(member)
Optional parameter you use to specify the name of the skeletal JCL member to
be used for the GENJCL.RECEIVE command.
RECVJCL can be specified for both RSR-covered and non-RSR-covered DL/I
DBDSs and Fast Path areas.
VSO | NOVSO
Mutually exclusive, optional parameters you use to specify whether an area
resides in virtual storage the next time the control region is initialized or when
the next /STA AREA command is processed.
VSO
Indicates that the area is to reside in virtual storage. Areas defined with
SHARELVL(0 | 1) are read into and written from an MVS data space. Areas
defined with SHARELVL(2 | 3) use the coupling facility to share data
between connected subsystems.
NOVSO
Indicates that this area is not to reside in virtual storage.
If an area was previously specified as SHARELVL(2 | 3), changing the area
to NOVSO clears the coupling facility structure names and resets the
LKASID setting to NOLKASID. NOVSO cannot be specified if the area is in
use.

Example of Changing a Record for a Fast Path DEDB

This example specifies changes to be made to the record in RECON for the Fast
Path DEDB that is identified by the DBD and AREA parameters. The image copy
data sets for the specified DEDB area are not reused, and the maximum number of
images that DBRC maintains is two. In addition, the image copy data sets for the
specified DBDS are kept in RECON for at least 15 days.
//CHGDBDS JOB
.
.
.

//SYSIN DD *
CHANGE.DBDS DBD(DB3) AREA(DD3) NOREUSE -
GENMAX(2) RECOVPD(15)
/*

CHANGE.DBDSGRP
OO CHANGE.DBDSGRP GRPNAME(name) O

132 DBRC Guide & Reference

CHANGE.DBDSGRP
,

O ADDDB( S dbname ) OP
,

DELDB( S dbname )
,

ADDMEM( S (dbname,ddname) )
,

DELMEM( S (dbname,ddname) )
,

ADDRECOV( S (dbname ) )
,areaname
,

DELRECOV( S (dbname ) )
,areaname

Use a CHANGE.DBDSGRP command to change the information about a DBDS or

database group. This information is contained in a DBDS group record in RECON.

Parameters
GRPNAME(name)
Required parameter you use to identify the DBDSGRP to be changed. A record
with that name must already exist.
ADDDB(dbname)
DELDB(dbname)
ADDMEM(dbname,ddname)
DELMEM(dbname,ddname)
ADDRECOV(dbname,areaname)
DELRECOV(dbname,areaname)
Mutually exclusive, optional parameters you use to identify the member or
members to be added to or deleted from the group. A member can belong to
any number of DBGRPs and DBDSGRPs, but can belong to only one
RECOVGRP.
ADDDB
DELDB
Identifies one or more databases or DEDB areas by name. The group must
have been defined as a database group.
ADDMEM
DELMEM
Identifies one or more DBDSs or DEDB areas, each by a pair of names
enclosed in parentheses, where dbname is the database name and
ddname is the DD statement name or the DEDB name. The group must
have been defined as a DBDS group.

Chapter 9. CHANGE Commands 133

CHANGE.DBDSGRP
ADDRECOV(dbname,areaname)
Identifes one or more DBs or DEDB areas, where dbname is the database
name, and areaname is the DD statement name or the DEDB name, to be
added to a recovery group. A recovery group is a group of full-function
databases or DEDB areas that you consider to be related. If you use the
ORS (Online Recovery Service) to perform a TSR (Time Stamp Recovery)
on one of the members of the group, ORS requires you to recover all
members of the group to the same time. A recovery group can otherwise be
used like a DB group.
Related Reading: See IMS Version 7 Administration Guide: Database
Manager for complete information about ORS, its components, and how it
works.
If a DEDB area is to be added to the recovery group, both dbname and
areaname must be specified. If the group specified is not a recovery group,
the command fails with message DSP0077I.
A database or area can belong to only one recovery group. If any of the
members specified by ADDRECOV already belong to another recovery
group, the command fails with message DSP0078I.
DELRECOV(dbname,areaname)
Identifies one or more DBs or DEDB areas to be deleted from a recovery
group. If a DEDB area is to be deleted from the recovery group, both
dbname and areaname must be specified. If the group specified is not a
recovery group, the command fails with message DSP0077I.

If you delete all the members of a group, the record of that group is deleted from
RECON.

Example of Changing a Group of DBDSs

In this example, a group of DBDSs is changed.
//CHGDBGRP JOB
.
.
.

//SYSIN DD *
CHANGE.DBDSGRP GRPNAME(GRP1) -
ADDMEM((DB1,DD1),(DB2,DD2))
/*

CHANGE.IC
OO CHANGE.IC DBD(name) DDN(name) RECTIME(time stamp) O
AREA(name)

O O
FILESEQ(value) FILESEQ2(value) ICDSN(name) ICDSN2(name)

O O
INVALID INVALID2 RECDCT(value) 3400
VALID VALID2 UNIT( unittype )

134 DBRC Guide & Reference

CHANGE.IC
O O
3400 ,
UNIT2( unittype )
VOLLIST( S volser )

O OP
, STOPTIME(time stamp)

VOLLIST2( S volser )

Use a CHANGE.IC command to modify information contained in an image copy

record in RECON.

Parameters
DBD(name)
Required parameter you use to identify the database name of the DBDS whose
image copy record is to be modified.
DDN(name) | AREA(name)
Mutually exclusive, required parameters you use to identify the name of the
DBDS or DEDB area to which the image copy record being modified is related.
RECTIME(time stamp)
Required parameter you use to identify the specific image copy data set record
to be changed.
Use the Run time marked with an asterisk (*) from the listing of the IMAGE
record. The time stamp must be in standard form (see “Standard Time Stamp
Format” on page 101
FILESEQ(value)
Optional parameter you use to change the file sequence number in the record
of the identified image copy data set.
FILESEQ2(value)
Optional parameter you use to change or add the file-sequence number in the
record of the identified duplicate image copy data set.
ICDSN(name)
Optional parameter you use to change the data set name of the identified
image copy data set.
ICDSN2(name)
Optional parameter you use to change or add the data set name of the
identified duplicate image copy data set in an image copy record.
To change the name of the duplicate image copy data set, a record of the first
image copy data set must exist in RECON.
INVALID | VALID
Mutually exclusive, optional parameters you use to prevent or permit the use of
an image copy data set as input to a subsequent run of an image copy job or
DBRC.
INVALID
Prevents the use of the specified image copy data set as input to a
subsequent run of DBRC or an image copy job. If the invalidated image

Chapter 9. CHANGE Commands 135

CHANGE.IC
copy data set is reused, it is automatically marked as valid. (See
“INIT.DBDS” on page 227 for an explanation of the REUSE parameter.)
VALID
Permits the use of a previously invalidated image copy data set as input to
a subsequent run of DBRC or an image copy job.
INVALID2 | VALID2
Mutually exclusive, optional parameters you use to prevent or permit the use of
a duplicate image copy data set as input to a subsequent run of the Database
Image Copy utility or DBRC.
INVALID2
Prevents the use of the specified, duplicate image copy data set as input to
a subsequent run of the Database Image Copy utility or DBRC. If the
invalidated, duplicate image copy data set is subsequently reused, it is
automatically marked as valid. (See “INIT.DBDS” on page 227 for an
explanation of the REUSE parameter.)
VALID2
Permits the use of a previously invalidated, duplicate image copy data set
as input to a subsequent run of the Database Image Copy utility or DBRC.
If both INVALID2 and VALID2 are specified, the last one specified is used.
RECDCT(value)
Optional parameter you use to change the count of the records in the
corresponding image copy data set in the specified image copy record.
CHANGE.ICvalue must be a decimal number up to 2 147 483 647.
UNIT(3400 | unittype)
Optional parameter you use to change the unit type that is recorded in the
specified image copy record. The unit type can be up to eight alphanumeric
characters.
UNIT2(3400 | unittype)
Optional parameter you use to change the unit type that is recorded in the
specified duplicate image copy record. The unit type can be up to eight
alphanumeric characters.
VOLLIST(volser)
Optional parameter you use to change, in the image copy record, the volume
serial numbers of the volumes on which the identified image copy data set
resides.
VOLLIST2(volser)
Optional parameter you use to change or add, in the image copy record, the
volume serial numbers of the volumes on which the identified duplicate image
copy data set resides.
STOPTIME(time stamp)
Optional parameter you use to specify the time when an image copy has
completed. The time stamp must be in standard form (see “Standard Time
Stamp Format” on page 101) and cannot be less than the image copy start
time. If this is an HSSP CIC that is in progress, specifying a valid stop time
terminates the HSSP CIC and resets the in-progress indicators in the IC record
and the DBDS record.

Example of Changing an Image Copy Record

In this example, information in an image copy record that is identified by the DBD,
DDN, and RECTIME parameters is to be changed in RECON. The new data set

136 DBRC Guide & Reference

CHANGE.IC
names of both image copy data sets (specified in the ICDSN and ICDSN2
parameters) follow the default naming convention. The volume serial numbers on
which the image copy data sets reside are also to be changed as specified in the
VOLLIST and VOLLIST2 parameters.
//CHGIC JOB
.
.
.

//SYSIN DD *
CHANGE.IC DBD(DBDKSDS1) DDN(DDNKSDS1) -
ICDSN(IMS.DBDKSDS1.DDNKSDS1.IC.ICDSN02) -
ICDSN2(IMS.DBDKSDS1.DDNKSDS1.IC2.ICDSN02) -
VOLLIST(ICVOL1,ICVOL2,ICVOL3) FILESEQ2(2) -
VOLLIST2(ICVOL4) RECTIME(820921314143)
/*

CHANGE.PRILOG (for OLDS)

OO CHANGE.PRILOG OLDS(ddname) O
ARNEEDED AVAIL DSN(name)
ARSCHED UNAVAIL
ARSTART
ARCHIVED

O OP
ERROR SSID(name)
NORMAL

Use a CHANGE.PRILOG (for OLDS) command to change information in the RECON

about a PRIOLDS. You cannot change the archive status after an OLDS has been
archived.

Parameters
OLDS(ddname)
Required parameter you use to specify the OLDS for which the RECON record
is to be changed.
ARNEEDED | ARSCHED | ARSTART | ARCHIVED
Mutually exclusive, optional parameters you use to change the archive status of
an OLDS.
ARNEEDED
Indicates that the OLDS was closed by IMS and needs to be archived.
ARSCHED
Indicates that the GENJCL.ARCHIVE command has been issued for the OLDS.
ARSTART
Indicates that the Log Archive utility is currently archiving the OLDS.
ARCHIVED
Indicates that the OLDS has been archived and is available for reuse.
AVAIL | UNAVAIL
Mutually exclusive, optional parameters you use to change the PRIOLDS to
indicate its availability.

Chapter 9. CHANGE Commands 137

CHANGE.PRILOG (for OLDS)
AVAIL
Indicates that the OLDS contains valid data and can be used as input to the
Log Archive utility.
UNAVAIL
Indicates that the OLDS contains invalid data and should not be used as
input to the Log Archive utility.
DSN(name)
Optional parameter you use to change the name of a primary OLDS. name can
be up to 44 characters long.
ERROR | NORMAL
Mutually exclusive, optional parameters you use to change the specified
PRIOLDS to indicate whether it contains errors.
ERROR
Changes the RECON record to indicate that a specified OLDS contains
errors, so IMS is unable to close the OLDS properly. Close the OLDS
before it is used as input to the Log Archive utility.
If you use dual logging, the subsystem uses the data in the error-free OLDS
(in other words, the SECOLDS) to close the OLDS marked in error.
If you do not use dual logging, the subsystem uses the next-OLDS to close
the OLDS that is marked in error.
NORMAL
Changes the record of the PRIOLDS, which was previously marked as
containing errors, to indicate that the data set is now available for use as
input to any log utility. When you specify NORMAL for an OLDS, the record
immediately indicates that neither the secondary OLDS nor the next-OLDS
is needed in order to close the specified OLDS.

DBRC selects the required log data sets from the PRILOG (or SECLOG)
records. These can contain RLDS entries, SLDS entries, or both. If you issue a
CHANGE.PRILOG RLDS ERROR command, DBRC automatically uses the
corresponding SECLOG entry, if one exists. If a SECLOG entry does not exist,
or if it is marked in error, the GENJCL commands that require log data for this
time frame fail.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the OLDS for which the RECON record is to be changed. The SSID is
an eight—character string consisting of any alphanumeric characters that
represent a valid IMS subsystem identification name.
If you do not specify SSID, DBRC uses the default subsystem identifier in the
RECON header record. Use the INIT.RECON or CHANGE.RECON command to set
the default subsystem identifier in the RECON header record. If you have not
specified a default in the RECON header record, you must specify SSID.

Example of Renaming an OLDS

In this example, the IMS online subsystem, IMSA, that creates the PRIOLDS,
renames an OLDS.
//CHGPRILG JOB
.
.
.

138 DBRC Guide & Reference

CHANGE.PRILOG (for OLDS)
//SYSIN DD *
CHANGE.PRILOG OLDS(DFSOLP02) -
DSN(IMS.NEWLOG) SSID(IMSA)
/*

CHANGE.PRILOG (for RLDS)

OO CHANGE.PRILOG RLDS STARTIME(time stamp) O
DSN(name)

O O
, ,

CHKPTCT( S value ) CHKPTID( S chkptid )

O O
DSSTART(time stamp) ERROR FILESEQ(value) GAP( ON )
NORMAL OFF

O O
GSG(gsgname) ,

NEWTIME( S time stamp )

O O
, ,

NEWVOL( S volser ) OLDVOL( S volser )

O O
PREVGAP( ON ) ,
OFF
RUNTIMES( S time stamp )

O OP
3400 ,
UNIT( unittype )
VOLLIST( S volser )

You can use the CHANGE.PRILOG (for RLDS) command to change information in the
RECON about a primary RLDS (or an SLDS that a batch subsystem created). Use
the NOTIFY.PRILOG (for RLDS) command to add a PRILOG record or to add data set
entries to an existing PRILOG record.

With the exception of the GSG name and the gap information, all the information
you can change resides in a data set entry of the PRILOG record. Each
CHANGE.PRILOG command you issue changes only one data set entry. If the log
has multiple data sets, you must use the DSSTART parameter to identify the data
set entry to be changed. (Note that if you are only changing the GSG or the gap
information, you must still specify DSSTART if the log has more than one data set.)

Chapter 9. CHANGE Commands 139

CHANGE.PRILOG (for RLDS)
If the PRILOG record represents log data which was received by an RSR tracking
site from an active IMS subsystem, none of the keywords FILESEQ, NEWTIME,
NEWVOL, OLDVOL, RUNTIMES, CHKPTID, UNIT, or VOLLIST can be specified.
Log data sets received at a tracking site must be cataloged.

Parameters
RLDS
Optional parameter you use to specify that a PRILOG record is to be changed.
STARTIME(time stamp)
Required parameter you use to specify the starting time stamp of the PRILOG
record that is to be changed. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).
DSN(name)
Optional parameter you use to change data set name. name can be up to 44
characters.
CHKPTCT(value)
Optional parameter you use to change the number of checkpoints completed on
each volume of the data set. Specify a value for each volume designated in the
OLDVOL or NEWVOL parameters. If OLDVOL is specified without NEWVOL,
the number of values for CHKPTCT equals the number of volume serial
numbers that appear with OLDVOL. If NEWVOL is specified, the number of
values for CHKPTCT equals the number of volume serial numbers that appear
in NEWVOL.
The values for CHKPTCT are:
0 No checkpoints on the volume
1 A single checkpoint on the volume
2 More than one checkpoint on the volume
CHKPTID(chkptid)
Optional parameter you use to change the oldest checkpoint ID for any active
PST on each volume of the data set. Specify one checkpoint ID for each
volume listed in OLDVOL or NEWVOL. If OLDVOL is specified without
NEWVOL, the number of checkpoint IDs equals the number of volumes listed in
OLDVOL. If NEWVOL is specified, the number of checkpoint IDs equals the
number of volumes listed in NEWVOL.
The checkpoint ID must be in standard form for a time stamp (see “Standard
Time Stamp Format” on page 101). You can specify a zero time value.
DSSTART(time stamp)
is a parameter you use to specify the starting time of the data set entry to be
changed. The DSSTART parameter is required if the PRILOG has multiple data
set entries; it is optional if the PRILOG has only one data set entry. The time
stamp must be in standard form (see “Standard Time Stamp Format” on
page 101).
ERROR | NORMAL
Mutually exclusive, optional parameters you use to change the data set entry to
indicate whether it contains errors.
ERROR
changes the data set to indicate that it contains errors and should not be
used as input to any DBRC-controlled run of a recovery utility.

140 DBRC Guide & Reference

CHANGE.PRILOG (for RLDS)
NORMAL
changes a data set which was previously marked as containing errors to
indicate that it is now available for use as input to any recovery utility.
FILESEQ(value)
Optional parameter you use to specify the file sequence number on the volume.
Specify this parameter only if you specify a VOLLIST parameter. The value you
substitute in the variable field must be a decimal number from 1 to 9999.
GAP(ON | OFF)
Optional parameter you use to set (ON) or reset (OFF) the GAP flag in a
tracking PRILOG record.
GSG(gsgname)
Optional parameter you use to change the global service group (GSG) name in
the PRILOG record.
| NEWTIME(time stamp)
| Optional parameter you use to change the stop times of any but the last volume
| of the data set. If you specify NEWTIME, you must also specify OLDVOL and
| NEWVOL. The parameter sets NEWTIME OLDVOL NEWVOL and RUNTIMES
| VOLLIST are mutually exclusive.
| If you specify NEWTIME, you must specify one less time stamp than the
| number of volume serial numbers specified in NEWVOL. This is because the
| stop time of the last volume specified in NEWVOL cannot be changed with this
| command. (See “NOTIFY.PRILOG (for RLDS)” on page 274 to see how to
| specify the stop time of the final volume.) Each time stamp is used as the
| volume stop time of the corresponding volume serial number specified by
| NEWVOL. If not specified, the stop time of the new volume is the same as the
| stop time of the last-specified old volume.
| Each time stamp you specify must be greater than the previous time stamp.
| The first time stamp in NEWTIME must be greater than or equal to the stop
| time of the volume immediately preceding the changed volumes. Each time
| stamp must be in standard form (see “Standard Time Stamp Format” on
| page 101).
NEWVOL(volser)
Optional parameter you use to change the volume serial number of one or more
volumes of the data set. If you specify NEWVOL, you must also specify
OLDVOL (described below).
The volume serial numbers you specify in NEWVOL replace the corresponding
volume serial numbers specified in the OLDVOL parameter. You do not need to
specify the same number of volume serial numbers in NEWVOL and OLDVOL.
You cannot specify a volume serial number in NEWVOL that is the same as
one which already exists in the PRILOG record.
You can specify from 1 to 255 volume serial numbers.
Use the NEWTIME parameter to change the time stamps as well as the serial
numbers of the volumes.
OLDVOL(volser)
Optional parameter you use to change the volume serial number of one or more
volumes of the data set. If you specify OLDVOL, you must also specify
NEWVOL, CHKPTCT, or CHKPTID.
The volume serial numbers you specify are those of the volumes being
changed. Each volume serial number specified in OLDVOL must match a
volume serial number in the PRILOG record.

Chapter 9. CHANGE Commands 141

CHANGE.PRILOG (for RLDS)
You can specify from 1 to 255 volume serial numbers.
PREVGAP(ON | OFF)
Optional parameter you use to set (ON) or reset (OFF) the PREV-GAP flag in a
tracking PRILOG record.
RUNTIMES(time stamp)
Optional parameter you use to change the stop times of any but the last volume
of the data set. This parameter is provided for compatibility with previous
releases of DBRC. You should use the new parameter set, NEWTIME OLDVOL
NEWVOL, to change the stop times of log volumes. If you do specify
RUNTIMES, you must also specify VOLLIST. The parameter sets, NEWTIME
OLDVOL NEWVOL and RUNTIMES VOLLIST, are mutually exclusive.
You can specify up to 255 time stamps on the RUNTIMES parameter. Each
time stamp must be in standard form (see “Standard Time Stamp Format” on
page 101).
Each time stamp in the variable field must correspond to a volume in the
variable field of the VOLLIST parameter. The variable fields of the RUNTIMES
and VOLLIST keywords must each contain the same number of entries. Each
time stamp in the variable field of the RUNTIMES parameter must be greater
than the previous time stamp.
The first time stamp in the variable field of the RUNTIMES parameter must be
greater than the time stamp specified for the STARTIME parameter. The last
time stamp in the variable field of the RUNTIMES parameter must be equal to
the stop time of the corresponding primary RLDS as specified in the record
being changed. You cannot use this command to change the stop time of the
primary RLDS. For information about closing open recovery logs, see
“NOTIFY.PRILOG (for RLDS)” on page 274.
UNIT(3400 | unittype)
Optional parameter you use to change the unit type of the device on which the
data set resides. The unit type can be up to eight alphanumeric characters long.
VOLLIST(volser)
Optional parameter you use to change the record of the volume serial numbers
of the volumes that contain the data set. This parameter is provided for
compatibility with previous releases of DBRC. Use the new parameter set
NEWTIME OLDVOL NEWVOL to change the volume serial numbers of volumes
in the data set.
If you specify the VOLLIST parameter, you must also specify the RUNTIMES
parameter. See the description of the RUNTIMES parameter under
“Parameters” on page 140 for an explanation of how the two parameters
interact. The parameter sets, NEWTIME OLDVOL NEWVOL and RUNTIMES
VOLLIST, are mutually exclusive.

Examples of Using the CHANGE.PRILOG (for RLDS) Command

Here are some examples of using the CHANGE.PRILOG (for RLDS) command.

Example of Changing Volume Serial Numbers

In this example, some volume serial numbers are changed for a log which contains
a single data set. The example PRILOG record in RECON has six
volumes—VOL001, VOL002, VOL003, VOL004, VOL005, and VOL006—and a start
time of 842331243299. The serial numbers of the third and fourth volumes can be
changed with the following command:

142 DBRC Guide & Reference

CHANGE.PRILOG (for RLDS)
//CHGPRILG JOB
.
.
.

//SYSIN DD *
CHANGE.PRILOG RLDS STARTIME(842331243299) -
OLDVOL(VOL003,VOL004) -
NEWVOL(VOL007,VOL008,VOL009)
/*

Example of Marking Primary RLDS for Errors

In this example, one data set of a log is being marked as containing errors.
//CHGPRILG JOB
.
.
.

//SYSIN DD *
CHANGE.PRILOG RLDS STARTIME(840541212120) -
DSSTART(840541212120) ERROR
/*

CHANGE.PRILOG (for SLDS and TSLDS)

OO CHANGE.PRILOG SLDS STARTIME(time stamp) O
TSLDS DSN(name)

O O
, ,

CHKPTCT( S value ) CHKPTID( S chkptid )

O O
DSSTART(time stamp) ERROR FILESEQ(value) GSG(gsgname)
NORMAL

O O
, ,

NEWTIME( S time stamp ) NEWVOL( S volser )

O O
, ,

OLDVOL( S volser ) RUNTIMES( S time stamp )

O OP
SSID(name) 3400 ,
UNIT( unittype )
VOLLIST( S volser )

You can use the CHANGE.PRILOG (for SLDS) command to change information in the
RECON about a primary SLDS for an online system. You can use the
CHANGE.PRILOG (for TSLDS) command to change information in the RECON about a

Chapter 9. CHANGE Commands 143

CHANGE.PRILOG (for SLDS and TSLDS)
primary SLDS for an RSR tracking subsystem. Use CHANGE.PRILOG (for RLDS) to
change information about an SLDS that a batch subsystem created, because DBRC
considers such data to be an RLDS. Use the NOTIFY.PRILOG (for SLDS) command
to add a PRISLD record or to add data set entries to an existing PRISLD record.

With the exception of the GSG name, all the information you can change resides in
a data set entry of the PRISLD record. Each CHANGE.PRILOG command you
issue changes only one data set entry. If the log has multiple data sets, you must
use the DSSTART parameter to identify the data set entry to be changed. (Note
that if you are only changing the GSG, you must still specify DSSTART if the log
has more than one data set.)

If the PRISLD record represents log data that was received by an RSR tracking site
from an active IMS subsystem, none of the keywords FILESEQ, NEWTIME,
NEWVOL, OLDVOL, RUNTIMES, CHKPTID, UNIT, or VOLLIST can be specified.
Log data sets received at a tracking site must be cataloged.

Parameters
SLDS
Required parameter you use to specify that an PRISLD record is to be
changed.
TSLDS
Required parameter you use to specify that a PRITSLDS record is to be
changed at an RSR tracking subsystem. If you do not specify SLDS or TSLDS,
the default is RLDS.
STARTIME(time stamp)
Required parameter you use to specify the starting time stamp of the PRISLD
record that is to be changed. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).
DSN(name)
Optional parameter you use to change data set name. name can be up to 44
characters.
CHKPTCT(value)
Optional parameter you use to change the number of checkpoints completed on
each volume of the data set. Specify a value for each volume designated in the
OLDVOL or NEWVOL parameters. If OLDVOL is specified without NEWVOL,
the number of values for CHKPTCT equals the number of volume serial
numbers that appear with OLDVOL. If NEWVOL is specified, the number of
values for CHKPTCT equals the number of volume serial numbers that appear
in NEWVOL.
The values for CHKPTCT are:
0 No checkpoints on the volume
1 A single checkpoint on the volume
2 More than one checkpoint on the volume
CHKPTID(chkptid)
Optional parameter you use to change the oldest checkpoint ID for any active
PST on each volume of the data set. Specify one checkpoint ID for each
volume listed in OLDVOL or NEWVOL. If OLDVOL is specified without
NEWVOL, the number of checkpoint IDs equals the number of volumes listed in
OLDVOL. If NEWVOL is specified, the number of checkpoint IDs equals the
number of volumes listed in NEWVOL.

144 DBRC Guide & Reference

CHANGE.PRILOG (for SLDS and TSLDS)
The checkpoint ID must be in standard form for a time stamp (see “Standard
Time Stamp Format” on page 101). You can specify a zero time value.
DSSTART(time stamp)
is a parameter you use to specify the starting time of the data set entry to be
changed. The DSSTART parameter is required if the PRISLD or PRITSLDS has
multiple data set entries. The parameter is optional if the PRISLD or PRITSLDS
has only one data set entry. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).
ERROR | NORMAL
Mutually exclusive, optional parameters you use to change the data set entry to
indicate whether it contains errors.
ERROR
is used to change the data set entry to indicate that it contains errors.
NORMAL
is used to change a data set entry which was previously marked as
containing errors to indicate that it is normal.
FILESEQ(value)
Optional parameter you use to specify the file sequence number on the volume.
Specify this parameter only if you specify a VOLLIST parameter. The value you
substitute in the variable field must be a decimal number from 1 to 9999.
GSG(gsgname)
Optional parameter you use to change the global service group (GSG) name in
the PRISLD record. GSG cannot be specified for PRITSLDS records.
| NEWTIME(time stamp)
| Optional parameter you use to change the stop times of any but the last volume
| of the data set. When you specify NEWTIME, you must also specify OLDVOL
| and NEWVOL. The parameter sets, NEWTIME OLDVOL NEWVOL and
| RUNTIMES VOLLIST, are mutually exclusive.
| When you specify NEWTIME, you must specify one less time stamp than the
| number of volume serial numbers specified in NEWVOL. This is because the
| stop time of the last volume specified in NEWVOL cannot be changed with this
| command. (See “NOTIFY.PRILOG (for SLDS and TSLDS)” on page 279 to learn
| how to specify the stop time of the final volume.) Each time stamp is used as
| the volume stop time of the corresponding volume serial number specified by
| NEWVOL. If not specified, the stop time of the new volume is the same as the
| stop time of the last—specified old volume.
| Each time stamp you specify must be greater than the previous time stamp.
| The first time stamp in NEWTIME must be greater than or equal to the stop
| time of the volume prior to the changed volumes. Each time stamp must be in
| standard form (see “Standard Time Stamp Format” on page 101).
NEWVOL(volser)
Optional parameter you use to change the volume serial number of one or more
volumes of the data set. When you specify NEWVOL, you must also specify
OLDVOL.
The volume serial numbers you specify in NEWVOL replace the corresponding
volume serial numbers specified in the OLDVOL parameter. You do not need to
specify the same number of volume serial numbers in NEWVOL and OLDVOL.
You cannot specify a volume serial number in NEWVOL that is the same as
one that already exists in the PRISLD or PRITSLDS record.
You can specify from 1 to 255 volume serial numbers.

Chapter 9. CHANGE Commands 145

CHANGE.PRILOG (for SLDS and TSLDS)
Use the NEWTIME parameter if you want to change the time stamps as well as
the serial numbers of the volumes.
OLDVOL(volser)
Optional parameter you use to change the volume serial number of one or more
volumes of the primary SLDS or TSLDS. When you specify OLDVOL, you must
also specify NEWVOL, CHKPTCT, or CHKPTID (all described above).
The volume serial numbers you specify are those of the volumes to be
changed. Each volume serial number specified must match a volume serial
number in the PRISLD or PRITSLDS record.
You can specify from 1 to 255 volume serial numbers.
RUNTIMES(time stamp)
Optional parameter you use to change the stop times of any but the last volume
of the data set. This parameter is provided for compatibility with previous
releases of DBRC. You should use the new parameter set NEWTIME OLDVOL
NEWVOL to change the stop times of log volumes. If you do specify
RUNTIMES, you must also specify VOLLIST. The parameter sets, NEWTIME
OLDVOL NEWVOL and RUNTIMES VOLLIST, are mutually exclusive.
You can specify up to 255 time stamps on the RUNTIMES parameter. Each
time stamp must be in standard form. (See “Standard Time Stamp Format” on
page 101).
Each time stamp in the variable field must correspond to a volume in the
variable field of the VOLLIST parameter. The variable fields of the RUNTIMES
and VOLLIST keywords must each contain the same number of entries. Each
time stamp in the variable field of the RUNTIMES parameter must be greater
than the previous time stamp.
The first time stamp in the variable field of the RUNTIMES parameter must be
greater than the time stamp specified for the STARTIME parameter. The last
time stamp in the variable field of the RUNTIMES parameter must be equal to
the stop time of the corresponding primary SLDS or TSLDS as specified in the
record being changed. You cannot use this command to change the stop time
of the primary SLDS or TSLDS. For information about closing open system
logs, see “NOTIFY.PRILOG (for SLDS and TSLDS)” on page 279.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the SLDS or TSLDS for which the RECON record is to be changed.
The SSID is an eight-character string consisting of any alphanumeric characters
that describe a valid IMS subsystem identification name. If you do not specify
SSID, DBRC uses the default subsystem identifier in the RECON header
record. Use the INIT.PRILOG or CHANGE.PRILOG command to set the default
subsystem identifier in the RECON header record. If you have not specified a
default in the RECON header record, you must specify SSID.
UNIT(3400 | unittype)
Optional parameter you use to change the unit type of the device on which the
data set resides. The unit type can be up to eight alphanumeric characters long.
VOLLIST(volser)
Optional parameter you use to change the record of the volume serial numbers
of the volumes that contain the data set. This parameter is provided for
compatibility with previous releases of DBRC. You should use the new
parameter set, NEWTIME OLDVOL NEWVOL, to change the volume serial
numbers of volumes in the data set.

146 DBRC Guide & Reference

CHANGE.PRILOG (for SLDS and TSLDS)
If you specify the VOLLIST parameter, you must also specify the RUNTIMES
parameter. See the above description of the RUNTIMES parameter for an
explanation of how the two parameters interact. The parameter sets, NEWTIME
OLDVOL NEWVOL and RUNTIMES VOLLIST, are mutually exclusive.

Examples of Using CHANGE.PRILOG (for SLDS and TSLDS)

Here are some examples of using the CHANGE.PRILOG (for SLDS and TSLDS)
command.

Example of Changing Volume Serial Numbers and Stop Time

In this example, some volume serial numbers and a volume stop time for a log
which contains a single data set. The example PRISLD record in RECON has a
start time of 832331243299 and six volumes (VOL001, VOL002, VOL003, VOL004,
VOL005, and VOL006). The fourth volume has been copied to new volumes
VOL007 and VOL008, with the new volume stop time 832331248325 for VOL007.
The PRISLD record could be updated with the following command:
//CHGPRILG JOB
.
.
.

//SYSIN DD *
CHANGE.PRILOG SLDS STARTIME(832331243299) -
OLDVOL(VOL004) -
NEWVOL(VOL007,VOL008) -
NEWTIME(832331248325)
/*

Example of Marking Primary SLDS as Normal

In this example, the first data set of a primary SLDS is marked as normal.
//CHGPRILG JOB
.
.
.

//SYSIN DD *
CHANGE.PRILOG SLDS STARTIME(820541212120) -
DSSTART(820541212120) NORMAL
/*

CHANGE.RECON
OO CHANGE.RECON O
CATDS DASDUNIT( unittype )
NOCATDS

O O
DUAL FORCER NOCHECK LISTDL
REPLACE(RECONn) NOFORCER CHECK17 NOLISTDL
CHECK44

O O
LOGALERT( dsnum,volnum ) LOGRET(’time_interval’) NOCOEX
COEX

Chapter 9. CHANGE Commands 147

CHANGE.RECON
O O
SSID(name) SIZALERT( dsnum,volnum,percent ) STARTNEW
NONEW

O O
TAPEUNIT(unittype) TRACEON
TRACEOFF

O O
,

TIMEZONE( S (label )
,offset )

O O
TIMEZIN(offset_rep ,duration) TIMEFMT(sublist)

O OP
UPGRADE

Notes:
1 The offset subparameter of the TIMEZONE parameter must be omitted in
order to delete an entry.

Use a CHANGE.RECON command to update options in the RECON status record.

Parameters
CATDS | NOCATDS
Mutually exclusive, optional parameters you use to modify the status of whether
image copy, change accumulation, and log data sets are cataloged.
CATDS
Specifies that these data sets are cataloged. If the data set is allocated by
the catalog and the CATDS option is used, DBRC bypasses volume serial
and file sequence verification for the data set.
For CATDS option to be effective, the data set must be cataloged, and
VOLSER information for the data set must be omitted from the JCL. If the
data set is cataloged, CATDS is specified, and VOLSER information is
included in the JCL, DBRC ignores CATDS and allocates the data set by
the JCL. Normal VOLSER and file sequence checking occurs.
If the data set is not cataloged, CATDS is not effective, and DBRC allocates
the data set by the JCL, with VOLSER and file sequence checking.
Attention: The CATDS option affects restart of IMS from SLDS data sets.
Since the CATDS option indicates the SLDS are under the control of a
catalog management system, the VOLSER is not passed back to IMS for
data set allocation. If the SLDS data sets are not cataloged, IMS restart
fails.
NOCATDS
Specifies that these data sets, regardless of their cataloged status, are not

148 DBRC Guide & Reference

CHANGE.RECON
to be treated as cataloged. In addition to data set name checking, DBRC
verifies that the volume serial and file sequence numbers specified in the
JCL are the same as the information recorded in the RECON.
DASDUNIT(unittype)
Optional parameter you use to change the unit type of the DASD device that
holds the records for log data sets. The unit type can be up to eight
alphanumeric characters long.
DUAL | REPLACE(RECONn)
Mutually exclusive, optional parameters you use to reestablish dual mode or to
replace an active RECON data set with the spare RECON:
DUAL
Causes DBRC to enter dual-RECON mode. If DBRC is already using two
RECONs, the dual parameter is ignored. If DBRC is using one RECON, it
attempts to use a spare RECON. If no spare RECON is available, dual
mode is not entered; however, any other optional parameters are
processed.
You are not required to use the DUAL parameter to cause DBRC to enter
dual-RECON mode. If as a result of a permanent I/O error on a RECON,
for example, DBRC is reduced to the use of a single RECON, it
automatically reenters dual-RECON mode as soon as it becomes aware of
the existence of a spare RECON. However, in installations that use DBRC
for log control only, it can be some time before DBRC becomes aware of a
recently created spare RECON. Use the CHANGE.RECON command with the
DUAL parameter to cause DBRC to enter dual-RECON mode immediately.
REPLACE
Causes DBRC to replace an active RECON with a spare RECON. When
you specify this parameter, you can reorganize the RECON data sets
online.
Related Reading: See “Chapter 3. Initializing and Maintaining the
RECON” on page 45 for more information about using REPLACE.
For RECONn, specify the DD statement of the RECON you want replaced.
For n, you can specify 1, 2, or 3. If you specify a RECON that is not active
or if no spare RECON is available, the replace does not take place;
however, any other optional parameters that are specified on the command
are executed.
FORCER | NOFORCER
Mutually exclusive, optional parameters you use to specify whether all
databases must be registered in RECON.
FORCER
Specifies that all databases must be registered in RECON. If a job tries to
access an unregistered database, the database authorization call from IMS
to DBRC fails.
NOFORCER
Specifies that databases do not have to be registered in RECON.

DBRC checks this parameter during initialization and it remains in effect for as
long as the subsystem runs. If you change this parameter while the control
region is active, the change does not take effect until restart or initialization,
although the change appears in a listing of the RECON.

Chapter 9. CHANGE Commands 149

CHANGE.RECON
LISTDL | NOLISTDL
Mutually exclusive, optional parameters you use to specify whether data set
names that are deleted from the RECON (by the DELETE.LOG command or by an
archive job log compression) are listed in the job output. The setting specified
on this command can be overridden by the DELETE.LOG command. There is no
way to override the setting for log compression during an archive job.
LISTDL
Specifies that deleted data set names are to be listed in the job output.
NOLISTDL
Specifies that deleted data set names are not to be listed in the job output.

There is no default for this parameter. If neither is specified, the current setting
is unchanged.
NOCHECK | CHECK17 | CHECK44
Mutually exclusive, optional parameters you use to change the type of
comparison of log data set names that is done by DBRC.
NOCHECK
Specifies that the data set name you specify as input to DBRC has a new
high-level qualifier and is longer than 17 characters. With NOCHECK,
DBRC does not compare the log data set name that is recorded in RECON
with the name on the appropriate DD statement.
CHECK17
Verifies that the last 17 characters of a log data set name are consistent
with RECON. If the name in RECON does not match the name on the
appropriate DD statement, the utility stops.
CHECK44
Verifies the 44-character log data set name is consistent with RECON. If
the name in RECON does not match the name on the appropriate log DD
statement, the utility stops.
LOGALERT(dsnum,volnum)
Optional parameter you use to define the threshold that triggers the DSP0287W
message. Message DSP0287W displays when you just have time to shut down
an online IMS subsystem before it terminates abnormally because the PRILOG
record size exceeds the maximum RECORDSIZE (as specified on the DEFINE
CLUSTER command when the RECON data set was created).
dsnum,volnum
These values apply only to PRILOG-family records. The message is
issued when both of the following conditions are true:
v A new OLDS data set opens.
v When there will no longer be room in the PRILOG record to
successfully archive all OLDSs currently needing to be archived
(including the new one) plus dsnum more, assuming each OLDS
uses volnum volumes.
The values that you enter, based on your knowledge of the rate at
which the subsystem normally fills OLDSs, should be calculated to give
you sufficient time to effect a normal shutdown of the online IMS
subsystem.

All values must be supplied. A zero (0) in any position means that the existing
value in the RECON record is not to be changed.

150 DBRC Guide & Reference

CHANGE.RECON
See Figure 10 on page 54 for an illustration of how LOGALERT affects the
PRILOG record.

The default values in a new RECON or one that has been upgraded from an
earlier release are (3,16), and are set during INIT.RECON command processing.
LOGRET(time interval)
Optional parameter you use to change the retention period for log data sets.
Definitions:
v The retention period is the minimum amount of time in which a log
becomes inactive after it is opened. (It is then eligible to be deleted.)
v The time interval is a partial, punctuated time stamp representing a time
interval (days, hours, minutes, seconds and tenths of a second) instead of
date and time. The time stamp for this command follows the format described
in “Standard Time Stamp Format” on page 101 except that the year
subparameter element is omitted. Valid intervals range from a tenth of a
second to 365 days.
Because the time interval is treated as a time stamp, the message DSP0106I
can be issued for incorrect values. Some examples of valid time intervals
include:
LOGRET(365)
LOGRET('030 12.00')
LOGRET('000 00:00:08.0')
LOGRET('000 00,00,00,1')

The following shows two different formats for equivalent time stamp
specifications. Both are valid.
LOGRET(030) LOGRET('030') = 30 days
LOGRET('010 12,30') LOGRET('010 12:30') = 10 days, 12 hours, 30 seconds

Related Reading:
v See “DELETE.LOG (for RLDS and SLDS)” on page 178 for a more
information on deleting inactive logs.
NOCOEX | COEX
Mutually exclusive, optional parameters you use to specify whether pre-version
6 and version 7 RECONs may coexist.
NOCOEX
Use this keyword if you no longer intend to run any pre-version 6 jobs
against the RECON. It disables coexistence with pre-version 6 IMS,
removing limitations when the local clock is changed (such as for daylight
savings time). You should be sure that the decision to use the NOCOEX
keyword is appropriate. It is possible to reverse this decision but, see the
Attention description below.
COEX
Allows you to reverse the effect of the NOCOEX keyword, again enabling
coexistence with pre-version 6 RECONs.
Attention: Use this keyword with extreme caution. If the local clock has
been changed since coexistence was disabled, or if you have used the
NOCOEX keyword to recover from an ABEND U2475, in version 6 or
version 7 (not recommended), endless loops and other unpredictable
malfunctions in your pre-version 6 systems may result.

Chapter 9. CHANGE Commands 151

CHANGE.RECON
SSID(name)
Optional parameter you use to change the name of the IMS subsystem to be
used as the subsystem ID for the following commands:
v CHANGE.PRILOG
v CHANGE.SECLOG
v DELETE.LOG
v GENJCL.ARCHIVE
v GENJCL.CLOSE
v NOTIFY.PRILOG
v NOTIFY.SECLOG
The SSID is an eight-character string of any alphanumeric characters that
comprise a valid IMS subsystem identification name.
SIZALERT(dsnum,volnum,percent)
Optional parameter you use to define thresholds that trigger messages to warn
you that a record has grown unusually large. The decimal threshold values that
you supply for SIZALERT are:
dsnum,volnum
These values apply only to PRILOG-family records. The message
DSP0387I is issued when both of the following conditions are true:
v When a new OLDS data set opens.
v All currently open OLDSs, including the new one, have been
archived, there will no longer be room in the record for dsnum data
set entries of volnum volumes each, or the record size will exceed
percent percent of the defined RECORDSIZE.
The values you that enter, based on your knowledge of the rate at
which the subsystem normally fills OLDSs, should be calculated to give
you sufficient time to take corrective action and avoid a shutdown of the
online IMS subsystem.
percent
This value applies to all records. The threshold is reached when a
record exceeding percent percentage of the defined RECORDIZE is
written to the RECON.

The messages that are triggered by these threshold values are:

v DSP0387I for PRILOG-family records. This message is issued at OLDS open
or switch when, after all open OLDSs have been archived, the log record
size would reach one of the thresholds.
v DSP0007I for all records. This message is issued when a record has been
written that exceeds the percent threshold.

The default values (for example, from the INIT.RECON command) in a new
RECON or one that has been upgraded from an earlier release are (15,16,95).

All values must be supplied. A zero (0) in any position means that the existing
value in the RECON record is not to be changed.

See Figure 10 on page 54 for an illustration of how SIZALERT affects the

PRILOG record.

152 DBRC Guide & Reference

CHANGE.RECON
STARTNEW | NONEW
Mutually exclusive, optional parameters you use to specify whether new jobs
are to be started when fewer than two RECONs are available.
STARTNEW
Specifies that new jobs are to be started.
NONEW
Specifies that new jobs are not to be started.
TAPEUNIT(unittype)
Optional parameter you use to specify the unit type of the tape device that
holds the records for log data sets. The unit type can be up to eight
alphanumeric characters long.
TRACEON | TRACEOFF
Mutually exclusive, optional parameters you use to specify whether to start or
stop external tracing.
TRACEON
Starts external tracing. If you specify this parameter, the specified
Generalized Trace Facility (GTF) must be active for USR-type records.
TRACEOFF
Stops external tracing. If you specify this parameter, DBRC only does
internal tracing.
TIMEZONE((label offset),(label offset))
Optional parameter that alters the time zone label table. This parameter is used
to define one or more symbolic time zone labels. Because most people do not
readily associate a numeric offset with a time zone, TIMEZONE allows you to
define symbolic labels, like PST (Pacific Standard Time), for numeric offsets,
such as -8.
The time zone label table can contain up to 32 entries, each of which is
composed of a label and an offset.
Related Reading: See “Suggestions for Time Zone Label Table Management”
on page 155 for more information about the TIMEZONE parameter.
label
An alphanumeric value of up to five characters, the first of which must be
alphabetic. Lower-case characters are translated to upper case.
offset
A signed-decimal value in the form of ± [h]h[:mm] that meets the
requirements of a valid time stamp offset. See “Standard Time Stamp
Format” on page 101 for a description of valid offset formats. The offset is
the value that, when added to UTC, gives local time. For example, the
value to use for PST (Pacific Standard Time) is -8. The value for JST
(Japan Standard Time) is +9.
Adding, replacing, and deleting entries from the stored list is supported as
follows:
v Adding an entry to the stored table is accomplished when an input list
entry contains both a label that does not exist in the RECON and a valid
offset value.
v Replacing an entry to the stored table is accomplished when the input
entry contains both a label that matches an existing label in the table and
a valid offset value.

Chapter 9. CHANGE Commands 153

CHANGE.RECON
v Deleting an entry to the stored table is accomplished when the input
entry is a label that matches an existing label in the table and no offset
value was specified. If the offset is omitted, and the label is not found in
the table, the table is not altered.

The labels in the table must be unique. Information about the use of labels
versus offsets is presented in, “Suggestions for Time Zone Label Table
Management” on page 155.
TIMEZIN(offset_rep [,duration])
Optional parameter you use to define a default time zone value for time stamps
that are entered without time zone information on subsequent DBRC
commands.
offset_rep
The default time zone value. It may be one of the following choices:
label
A Time Zone label that has been previously defined using the
TIMEZONE parameter.
offset
A numeric offset value in the same form as defined above for the
TIMEZONE parameter.
%SYS
A keyword used to designate that the offset is to be derived from the
current offset found in the MVS CVT control block. This is the initial
default for DBRC.
duration
Specifies the duration of the offset_rep choice
PERM
Indicates that the label or offset default is to be in effect for any
subsequent DBRC command running with the same RECON.
TEMP
Indicates that the label or offset default is in effect only for the job in
which the command is entered.
TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear
from DBRC in messages, displays, and listings. See “Standard Time Stamp
Format” on page 101 for examples of the different output forms. The five values
are positional. Each is optional and can be omitted by including only the
comma.
The format of the TIMEFMT parameter sublist is presented in detail in
“TIMEFMT Parameter Sublist” on page 102.
UPGRADE
Optional parameter that you use to upgrade all IMS Version 6 RECON records
during excecution of the CHANGE.RECON command. You do not need to shut down
other IMS subsystems that share the RECON, although they might have to wait
for the command to complete.
Restriction: You can issue the CHANGE.RECON UPGRADE command only in the
batch command utility. You cannot issue it from an online IMS.
CHANGE.RECON UPGRADE upgrades the RECON in two stages: first, Copy 1 and
then Copy 2.

154 DBRC Guide & Reference

CHANGE.RECON
Message DSP0250l indicates the beginning of the first stage. Any failure during
this stage causes DBRC to reconfigure the RECONs, discarding Copy 1. If a
failure occurs during the first stage, you need to rerun the CHANGE.RECON
UPGRADE command.
After successful completion of the first stage, message DSP0251l indicates that
the second stage is beginning. Any failure during this stage causes DBRC to
reconfigure the RECONs, discarding Copy 2. However, if there is a failure
during the second stage, you do NOT need to rerun the CHANGE.RECON UPGRADE
command.
You can use the CHANGE.RECON UPGRADE command in either nonconcurrent or
concurrent mode. The mode is determined by the environment at the time you
issue the command.
Nonconcurrent
No other jobs are currently accessing the RECON.
Before issuing the CHANGE.RECON UPGRADE command, you might
want to create a backup copy of the RECON in case the upgrade and
the RECON recovery procedures fail, which can happen if you have not
allocated two RECONs and a spare.
Concurrent
Other jobs are currently accessing the RECON. These jobs can be
either pre-version 6 or Version 6, and must have the respective Version
7 SPE applied. Two RECONs plus a spare must be allocated for a
concurrent upgrade.

Suggestions for Time Zone Label Table Management

The same offset should not be designated by more than one label because DBRC
always uses the first occurrence in the in the table when outputting a time stamp.

The practicality of using the label format is affected by the scope of the IMS
installation. For those operating solely in a single time zone, use of labels
eliminates the need for the operator to know the exact offset to UTC at all times
during the year. For multiple time zone operation, the use of offsets rather than
labels, is suggested (though not mandatory). The time zone label table may not be
practical if offsets are not unique from one zone to the next when daylight saving
time adjustments are taken into account. Changing the table when daylight saving
time switches are made, would add to the confusion, so in that case, use numeric
offset values for cross time zone operation.

Example of Updating the RECON Header Record

In this example, you are:
v Forcing all databases to be registered
v Changing the default subsystem ID to IMSB
v And changing the log retention period to 7 days
//CHGRECON JOB
.
.
.

//SYSIN DD *
CHANGE.RECON SSID(IMSB) FORCER LOGRET(’007’)
/*

Chapter 9. CHANGE Commands 155

CHANGE.RECON (for THT or REPTHT)

OO CHANGE.RECON OP
THT
REPTHT

Use a CHANGE.RECON (for THT or REPTHT) command to specify whether an

additional new time history table (THT) is created or the existing entry is replaced.

These parameters are mutually exclusive with one another and all other
CHANGE.RECON parameters and subparameters. So, to affect the time history table
with CHANGE.RECON, enter only THT or REPTHT.

Parameters
THT | REPTHT
Mutually exclusive, optional parameters you use to specify whether an
additional new Time history table is created or the existing entry is replaced,
when the current THT entry differs from the current MVS offset.
THT
Generates a new THT entry if the current MVS offset from UTC differs from
the current THT entry.
REPTHT
Replaces the current THT entry. Use this keyword only if you have
previously changed the clock incorrectly and generated a new THT entry,
then corrected the clock. This keyword can only be used if neither of the
following are true:
v The RECON has been updated by Version 6 DBRC (except by your
command)
v The RECON has been accessed by a pre-Version 6 version since you
generated the current THT entry
Otherwise, you must use the THT keyword to create a new THT entry.

Example of Specifying a Replacement THT Entry

In this example, you replace the THT entry that you created after an incorrect clock
change.
//CHGRECON JOB
.
.
.

//SYSIN DD *
CHANGE.RECON REPTHT
/*

CHANGE.SECLOG (for OLDS)

156 DBRC Guide & Reference

CHANGE.SECLOG (for OLDS)
OO CHANGE.SECLOG OLDS(ddname) O
AVAIL DSN(name) ERROR
UNAVAIL NORMAL

O OP
SSID(name)

Use a CHANGE.SECLOG (for OLDS) command to change information in RECON about

a secondary OLDS.

Parameters
OLDS(ddname)
Required parameter you use to specify the OLDS for which the RECON record
is to be changed. Failure to specify this parameter results in an RLDS being
changed.
AVAIL | UNAVAIL
Mutually exclusive, optional parameters you use to change the SECOLDS to
indicate its availability.
AVAIL
Indicates that the OLDS contains valid data and that it can be used as input
to the Log Archive utility.
UNAVAIL
Indicates that the OLDS contains invalid data and it should not be used as
input to the Log Archive utility.
DSN(name)
Optional parameter you use to change the name of a secondary OLDS. The
name you substitute in the variable field can be up to 44 characters long.
ERROR | NORMAL
Mutually exclusive, optional parameters you use to change the specified
SECOLDS record to indicate whether it contains errors.
ERROR
Changes the RECON record to indicate that a specified OLDS contains
errors, so IMS is unable to close the OLDS properly. The OLDS must be
closed before it can be used as input to the Log Archive utility.
When you use dual logging, you use ERROR to change a specified
SECOLDS record to indicate that it contains errors. The subsystem uses
the data in the error-free OLDS to close the OLDS that is marked ERROR.
NORMAL
Changes the SECOLDS record, which was previously marked as containing
errors, to indicate that the data set is now available for use as input to any
log utility. When you specify NORMAL for a secondary OLDS, the record
immediately indicates that the next primary OLDS is no longer needed in
order to close the corresponding primary OLDS.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the OLDS for which the RECON record is to be changed.
The SSID is an eight-character string consisting of any alphanumeric characters
that comprise a valid IMS subsystem identification name. If you do not specify

Chapter 9. CHANGE Commands 157

CHANGE.SECLOG (for OLDS)
SSID, DBRC uses the default subsystem identifier in the RECON header
record. Use the INIT.RECON or CHANGE.RECON command to set the default
subsystem identifier in the RECON header record. If you have not specified a
default in the RECON header record, you must specify SSID.

Example Showing a SECOLDS Error

In this example, a SECOLDS that IMS online subsystem IMSA created is known to
be in error.
//CHGSECLG JOB
.
.
.

//SYSIN DD *
CHANGE.SECLOG OLDS(DFSOLS02) -
SSID(IMSA) ERROR
/*

CHANGE.SECLOG (for RLDS)

RLDS
OO CHANGE.SECLOG STARTIME(time stamp) O
DSN(name)

O O
, ,

CHKPTCT( S value ) CHKPTID( S chkptid )

O O
DSSTART(time stamp) ERROR FILESEQ(value) GSG(gsgname)
NORMAL

O O
, ,

NEWTIME( S time stamp ) NEWVOL( S volser )

O O
, ,

OLDVOL( S volser ) RUNTIMES( S time stamp )

O OP
3400 ,
UNIT( unittype )
VOLLIST( S volser )

You can use the CHANGE.SECLOG (for RLDS) command to change information in the
RECON about a primary RLDS (or an SLDS that a batch subsystem created). Use
the NOTIFY.SECLOG (for RLDS) command to add a SECLOG record or to add data
set entries to an existing SECLOG record.

158 DBRC Guide & Reference

CHANGE.SECLOG (for RLDS)
With the exception of the GSG name, all the information you can change resides in
a data set entry of the SECLOG record. Each CHANGE.SECLOG command you
issue changes only one data set entry. If the log has multiple data sets, you must
use the DSSTART parameter to identify the data set entry to be changed. (Note
that if you are only changing the GSG you must still specify DSSTART if the log has
more than one data set.)

If the SECLOG record represents log data that was received by an RSR tracking
site from an active IMS subsystem, none of the keywords FILESEQ, NEWTIME,
NEWVOL, OLDVOL, RUNTIMES, CHKPTID, UNIT, or VOLLIST can be specified.
Log data sets received at a tracking site must be cataloged.

Parameters
RLDS
Is the parameter you can use to specify that a SECLOG record is to be
changed. Since RLDS is the default, if you do not specify a record type as the
first parameter for CHANGE.SECLOG, RLDS is assumed.
STARTIME(time stamp)
Required parameter you use to specify the starting time stamp of the SECLOG
record that is to be changed. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).
DSN(name)
Optional parameter you use to change data set name. name can be up to 44
characters.
CHKPTCT(value)
Optional parameter you use to change the number of checkpoints completed on
each volume of the data set. Specify a value for each volume designated in the
OLDVOL or NEWVOL parameters. If OLDVOL is specified without NEWVOL,
the number of values for CHKPTCT equals the number of volume serial
numbers that appear with OLDVOL. If NEWVOL is specified, the number of
values for CHKPTCT equals the number of volume serial numbers that appear
in NEWVOL.
The values for CHKPTCT are:
0 No checkpoints on the volume
1 A single checkpoint on the volume
2 More than one checkpoint on the volume
CHKPTID(chkptid)
Optional parameter you use to change the oldest checkpoint ID for any active
PST on each volume of the data set. Specify one checkpoint ID for each
volume listed in OLDVOL or NEWVOL. If OLDVOL is specified without
NEWVOL, the number of checkpoint IDs equals the number of volumes listed in
OLDVOL. If NEWVOL is specified, the number of checkpoint IDs equals the
number of volumes listed in NEWVOL.
The checkpoint ID must be in standard form for a time stamp (see “Standard
Time Stamp Format” on page 101). You can specify a zero time value.
DSSTART(time stamp)
Is a parameter you use to specify the starting time of the data set entry to be
changed. The DSSTART parameter is required if the SECLOG has multiple

Chapter 9. CHANGE Commands 159

CHANGE.SECLOG (for RLDS)
data set entries; it is optional if the SECLOG has only one data set entry. The
time stamp must be in standard form (see “Standard Time Stamp Format” on
page 101).
ERROR | NORMAL
Mutually exclusive, optional parameters you use to change the data set entry to
indicate whether it contains errors.
ERROR
changes the data set to indicate that it contains errors and should not be
used as input to any DBRC-controlled run of a recovery utility.
NORMAL
changes a data set which was previously marked as containing errors to
indicate that it is now available for use as input to any recovery utility.
FILESEQ(value)
Optional parameter you use to specify the file sequence number on the volume.
Specify this parameter only if you specify a VOLLIST parameter. The value you
substitute in the variable field must be a decimal number from 1 to 9999.
GSG(gsgname)
Optional parameter you use to change the global service group (GSG) name in
the SECLOG record.
NEWTIME(time stamp)
Optional parameter you use to change the stop times of any but the last volume
of the data set. If you specify NEWTIME, you must also specify OLDVOL and
NEWVOL. The parameter sets NEWTIME OLDVOL NEWVOL and RUNTIMES
VOLLIST are mutually exclusive.
If you specify NEWTIME, you must specify one less time stamp than the
number of volume serial numbers specified in NEWVOL. This is because the
stop time of the last volume specified in NEWVOL cannot be changed with this
command. (See “NOTIFY.PRILOG (for RLDS)” on page 274 to see how to
specify the stop time of the final volume.) Each time stamp is used as the
volume stop time of the corresponding volume serial number specified by
NEWVOL. If not specified, the stop time of the new volume is the same as the
stop time of the last-specified old volume.
| Each time stamp you specify must be greater than the previous time stamp.
| The first time stamp in NEWTIME must be greater than or equal to the stop
| time of the volume immediately preceding the changed volumes. Each time
| stamp must be in standard form (see “Standard Time Stamp Format” on
| page 101).
NEWVOL(volser)
Optional parameter you use to change the volume serial number of one or more
volumes of the data set. If you specify NEWVOL, you must also specify
OLDVOL (described below).
The volume serial numbers you specify in NEWVOL replace the corresponding
volume serial numbers specified in the OLDVOL parameter. You do not need to
specify the same number of volume serial numbers in NEWVOL and OLDVOL.
You cannot specify a volume serial number in NEWVOL that is the same as
one which already exists in the SECLOG record.
You can specify from 1 to 255 volume serial numbers.
Use the NEWTIME parameter to change the time stamps as well as the serial
numbers of the volumes.

160 DBRC Guide & Reference

CHANGE.SECLOG (for RLDS)
OLDVOL(volser)
Optional parameter you use to change the volume serial number of one or more
volumes of the data set. If you specify OLDVOL, you must also specify
NEWVOL, CHKPTCT, or CHKPTID.
The volume serial numbers you specify are those of the volumes being
changed. Each volume serial number specified in OLDVOL must match a
volume serial number in the SECLOG record.
You can specify from 1 to 255 volume serial numbers.
RUNTIMES(time stamp)
Optional parameter you use to change the stop times of any but the last volume
of the data set. This parameter is provided for compatibility with previous
releases of DBRC. You should use the new parameter set, NEWTIME OLDVOL
NEWVOL, to change the stop times of log volumes. If you do specify
RUNTIMES, you must also specify VOLLIST. The parameter sets, NEWTIME
OLDVOL NEWVOL and RUNTIMES VOLLIST, are mutually exclusive.
You can specify up to 255 time stamps on the RUNTIMES parameter. Each
time stamp must be in standard form (see “Standard Time Stamp Format” on
page 101).
Each time stamp in the variable field must correspond to a volume in the
variable field of the VOLLIST parameter. The variable fields of the RUNTIMES
and VOLLIST keywords must each contain the same number of entries. Each
time stamp in the variable field of the RUNTIMES parameter must be greater
than the previous time stamp.
The first time stamp in the variable field of the RUNTIMES parameter must be
greater than the time stamp specified for the STARTIME parameter. The last
time stamp in the variable field of the RUNTIMES parameter must be equal to
the stop time of the corresponding secondary RLDS as specified in the record
being changed. You cannot use this command to change the stop time of the
secondary RLDS. For information about closing open recovery logs, see
“NOTIFY.PRILOG (for RLDS)” on page 274.
UNIT(3400 | unittype)
Optional parameter you use to change the unit type of the device on which the
data set resides. The unit type can be up to eight alphanumeric characters long.
VOLLIST(volser)
Optional parameter you use to change the record of the volume serial numbers
of the volumes that contain the data set. This parameter is provided for
compatibility with previous releases of DBRC. Use the new parameter set
NEWTIME OLDVOL NEWVOL to change the volume serial numbers of volumes
in the data set.
If you specify the VOLLIST parameter, you must also specify the RUNTIMES
parameter. See the description of the RUNTIMES parameter under
“Parameters” on page 140 for an explanation of how the two parameters
interact. The parameter sets, NEWTIME OLDVOL NEWVOL and RUNTIMES
VOLLIST, are mutually exclusive.

Examples of Using CHANGE.SECLOG (for RLDS)

Here are some examples of using the CHANGE.SECLOG (for RLDS) command.

Example of Changing Volume Serial Numbers

In this example, some volume serial numbers are changed. The example SECLOG
record in RECON has one data set with six volumes—VOL001, VOL002, VOL003,

Chapter 9. CHANGE Commands 161

CHANGE.SECLOG (for RLDS)
VOL004, VOL005, and VOL006—and a start time of 832331243299. The serial
numbers of the third and fourth volumes are replaced with three others by the
following command:
//CHGSECLG JOB
.
.
.

//SYSIN DD *
CHANGE.SECLOG RLDS STARTIME(832331243299) -
OLDVOL(VOL003,VOL004) -
NEWVOL(VOL007,VOL008,VOL009)
/*

Example of Changing Volume Stop Times

In this example, STARTIME identifies the SECLOG record and DSSTART identifies
its first data set entry, of which the data set name and the stop times of three
volumes are to be changed.
//CHGSECLG JOB
.
.
.

//SYSIN DD *
CHANGE.SECLOG RLDS STARTIME(840541212120) -
DSSTART(840541212120) -
DSN(IMS.SECLOG.SEC001.DSN) -
VOLLIST(VOL001,VOL002,VOL993) -
RUNTIMES(840541212122,840541313133,840541515150)
/*

CHANGE.SECLOG (for SLDS and TSLDS)

OO CHANGE.SECLOG SLDS STARTIME(time stamp) O
TSLDS DSN(name)

O O
, , DSSTART(time stamp)

CHKPTCT( S value ) CHKPTID( S chkptid )

O O
ERROR FILESEQ(value) GSG(gsgname) ,
NORMAL
NEWTIME( S time stamp )

O O
, ,

NEWVOL( S volser ) OLDVOL( S volser )

O O
, SSID(name) 3400
UNIT( unittype )
RUNTIMES( S time stamp )

162 DBRC Guide & Reference

CHANGE.SECLOG (for SLDS and TSLDS)
O OP
,

VOLLIST( S volser )

You can use the CHANGE.SECLOG (for SLDS) command to change information in the
RECON about a secondary SLDS for an online system. You can use the
CHANGE.SECLOG (for TSLDS) command to change information in the RECON about a
secondary SLDS for an RSR tracking subsystem. Use CHANGE.SECLOG (for RLDS) to
change information about an SLDS that a batch subsystem created, because DBRC
considers such data to be an RLDS. Use the NOTIFY.SECLOG (for SLDS) command
to add a SECSLD record or to add data set entries to an existing SECSLD record.

With the exception of the GSG name, all the information you can change resides in
a data set entry of the SECSLD record. Each CHANGE.SECLOG command you
issue changes only one data set entry. If the log has multiple data sets, you must
use the DSSTART parameter to identify the data set entry to be changed. (Note
that if you are only changing the GSG, you must still specify DSSTART if the log
has more than one data set.)

If the SECSLD record represents log data that was received by an RSR tracking
site from an active IMS subsystem, none of the keywords FILESEQ, NEWTIME,
NEWVOL, OLDVOL, RUNTIMES, CHKPTID, UNIT, or VOLLIST can be specified.
Log data sets received at a tracking site must be cataloged.

Parameters
SLDS
Required parameter you use to specify that an SECSLD record is to be
changed.
TSLDS
Required parameter you use to specify that a SECTSLDS record is to be
changed at an RSR tracking subsystem. If you do not specify SLDS or TSLDS,
the default is RLDS.
STARTIME(time stamp)
Required parameter you use to specify the starting time stamp of the SECSLD
record that is to be changed. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).
DSN(name)
Optional parameter you use to change data set name. name can be up to 44
characters.
CHKPTCT(value)
Optional parameter you use to change the number of checkpoints completed on
each volume of the data set. Specify a value for each volume designated in the
OLDVOL or NEWVOL parameters. If OLDVOL is specified without NEWVOL,
the number of values for CHKPTCT equals the number of volume serial
numbers that appear with OLDVOL. If NEWVOL is specified, the number of
values for CHKPTCT equals the number of volume serial numbers that appear
in NEWVOL.
The values for CHKPTCT are:
0 No checkpoints on the volume

Chapter 9. CHANGE Commands 163

CHANGE.SECLOG (for SLDS and TSLDS)
1 A single checkpoint on the volume
2 More than one checkpoint on the volume
CHKPTID(chkptid)
Optional parameter you use to change the oldest checkpoint ID for any active
PST on each volume of the data set. Specify one checkpoint ID for each
volume listed in OLDVOL or NEWVOL. If OLDVOL is specified without
NEWVOL, the number of checkpoint IDs equals the number of volumes listed in
OLDVOL. If NEWVOL is specified, the number of checkpoint IDs equals the
number of volumes listed in NEWVOL.
The checkpoint ID must be in standard form for a time stamp (see “Standard
Time Stamp Format” on page 101). You can specify a zero time value.
DSSTART(time stamp)
Is a parameter you use to specify the starting time of the data set entry to be
changed. The DSSTART parameter is required if the SECSLD or SECTSLDS
has multiple data set entries. The parameter is optional if the SECSLD or
SECTSLDS has only one data set entry. The time stamp must be in standard
form (see “Standard Time Stamp Format” on page 101).
ERROR | NORMAL
Mutually exclusive, optional parameters you use to change the data set entry to
indicate whether it contains errors.
ERROR
Is used to change the data set entry to indicate that it contains errors.
NORMAL
Is used to change a data set entry which was previously marked as
containing errors to indicate that it is normal.
FILESEQ(value)
Optional parameter you use to specify the file sequence number on the volume.
Specify this parameter only if you specify a VOLLIST parameter. The value you
substitute in the variable field must be a decimal number from 1 to 9999.
GSG(gsgname)
Optional parameter you use to change the global service group (GSG) name in
the SECSLD record. GSG cannot be specified for SECTSLDS records.
NEWTIME(time stamp)
Optional parameter you use to change the stop times of any but the last volume
of the data set. When you specify NEWTIME, you must also specify OLDVOL
and NEWVOL. The parameter sets, NEWTIME OLDVOL NEWVOL and
RUNTIMES VOLLIST, are mutually exclusive.
When you specify NEWTIME, you must specify one less time stamp than the
number of volume serial numbers specified in NEWVOL. This is because the
stop time of the last volume specified in NEWVOL cannot be changed with this
command. (See “NOTIFY.PRILOG (for SLDS and TSLDS)” on page 279 to learn
how to specify the stop time of the final volume.) Each time stamp is used as
the volume stop time of the corresponding volume serial number specified by
NEWVOL. If not specified, the stop time of the new volume is the same as the
stop time of the last—specified old volume.
| Each time stamp you specify must be greater than the previous time stamp.
| The first time stamp in NEWTIME must be greater than or equal to the stop
| time of the volume prior to the changed volumes. Each time stamp must be in
| standard form (see “Standard Time Stamp Format” on page 101).

164 DBRC Guide & Reference

CHANGE.SECLOG (for SLDS and TSLDS)
NEWVOL(volser)
Optional parameter you use to change the volume serial number of one or more
volumes of the data set. When you specify NEWVOL, you must also specify
OLDVOL.
The volume serial numbers you specify in NEWVOL replace the corresponding
volume serial numbers specified in the OLDVOL parameter. You do not need to
specify the same number of volume serial numbers in NEWVOL and OLDVOL.
You cannot specify a volume serial number in NEWVOL that is the same as
one that already exists in the SECSLD or SECTSLDS record.
You can specify from 1 to 255 volume serial numbers.
Use the NEWTIME parameter if you want to change the time stamps as well as
the serial numbers of the volumes.
OLDVOL(volser)
Optional parameter you use to change the volume serial number of one or more
volumes of the secondary SLDS or TSLDS. When you specify OLDVOL, you
must also specify NEWVOL, CHKPTCT, or CHKPTID (all described above).
The volume serial numbers you specify are those of the volumes to be
changed. Each volume serial number specified must match a volume serial
number in the SECSLD or SECTSLDS record.
You can specify from 1 to 255 volume serial numbers.
RUNTIMES(time stamp)
Optional parameter you use to change the stop times of any but the last volume
of the data set. This parameter is provided for compatibility with previous
releases of DBRC. You should use the new parameter set NEWTIME OLDVOL
NEWVOL to change the stop times of log volumes. If you do specify
RUNTIMES, you must also specify VOLLIST. The parameter sets, NEWTIME
OLDVOL NEWVOL and RUNTIMES VOLLIST, are mutually exclusive.
You can specify up to 255 time stamps on the RUNTIMES parameter. Each
time stamp must be in standard form. (See “Standard Time Stamp Format” on
page 101).
Each time stamp in the variable field must correspond to a volume in the
variable field of the VOLLIST parameter. The variable fields of the RUNTIMES
and VOLLIST keywords must each contain the same number of entries. Each
time stamp in the variable field of the RUNTIMES parameter must be greater
than the previous time stamp.
The first time stamp in the variable field of the RUNTIMES parameter must be
greater than the time stamp specified for the STARTIME parameter. The last
time stamp in the variable field of the RUNTIMES parameter must be equal to
the stop time of the corresponding secondary SLDS or TSLDS as specified in
the record being changed. You cannot use this command to change the stop
time of the secondary SLDS or TSLDS. For information about closing open
system logs, see “NOTIFY.PRILOG (for SLDS and TSLDS)” on page 279.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the SLDS or TSLDS for which the RECON record is to be changed.
The SSID is an eight-character string consisting of any alphanumeric characters
that describe a valid IMS subsystem identification name. If you do not specify
SSID, DBRC uses the default subsystem identifier in the RECON header
record. Use the INIT.SECLOG or CHANGE.SECLOG command to set the default

Chapter 9. CHANGE Commands 165

CHANGE.SECLOG (for SLDS and TSLDS)
subsystem identifier in the RECON header record. If you have not specified a
default in the RECON header record, you must specify SSID.
UNIT(3400 | unittype)
Optional parameter you use to change the unit type of the device on which the
data set resides. The unit type can be up to eight alphanumeric characters long.
VOLLIST(volser)
Optional parameter you use to change the record of the volume serial numbers
of the volumes that contain the data set. This parameter is provided for
compatibility with previous releases of DBRC. You should use the new
parameter set, NEWTIME OLDVOL NEWVOL, to change the volume serial
numbers of volumes in the data set.
If you specify the VOLLIST parameter, you must also specify the RUNTIMES
parameter. See the above description of the RUNTIMES parameter for an
explanation of how the two parameters interact. The parameter sets, NEWTIME
OLDVOL NEWVOL and RUNTIMES VOLLIST, are mutually exclusive.

Examples of Using CHANGE.SECLOG (for SLDS and TSLDS)

Here are some examples of using the CHANGE.SECLOG (for SLDS and TSLDS)
command.

Example of Changing Volume Serial Numbers and Stop Time

In this example, some volume serial numbers and a volume stop time of an
SECSLD are changed. The example SECSLD record in RECON has six volumes
(VOL001, VOL002, VOL003, VOL004, VOL005, and VOL006) and a start time of
832331243299. The fourth volume has been copied to new volumes VOL007 and
VOL008 with the new volume stop time 832331248325 for VOL007. The SECSLD
record is updated with the following command:
//CHGPRILG JOB
.
.
.

//SYSIN DD *
CHANGE.SECLOG SLDS STARTIME(832331243299) -
OLDVOL(VOL004) -
NEWVOL(VOL007,VOL008) -
NEWTIME(832331248325)
/*

Example of Marking the Secondary SLDS as Normal

In this example, the first and only data set of a secondary SLDS is being marked as
normal.
//CHGPRILG JOB
.
.
.

//SYSIN DD *
CHANGE.SECLOG SLDS STARTIME(840541212120) -
DSSTART(840541212120) NORMAL
/*

166 DBRC Guide & Reference

CHANGE.SG

CHANGE.SG
OO CHANGE.SG SGNAME(sgname) GSGNAME(gsgname) OP
ACTIVE LOCAL NORTA
TRACKING NONLOCAL

Use a CHANGE.SG command to change the role of a service group (SG). The role of
a service group cannot be changed while a subsystem is signed on to its global
service group.

This command fails if RSRFEAT=NO is specified in the IMSCTRL macro.

If two SG entries are present at the time this command is issued, the other SG is
assigned the complementary attributes of the SG that is named in the command.

Example:

This command changes SG1 to a tracking role:

CHANGE.SG SGNAME(SG1) GSGNAME(GSG1) TRACKING

In this case, SG2 is automatically changed to an active role.

Parameters
SGNAME(sgname)
Required parameter you use to specify the service group name.
GSGNAME(gsgname)
Required parameter you use to specify the global service group name.
ACTIVE | TRACKING
Optional parameter you use to specify the new role of the service group. This
parameter is sometimes referred to as the STATUS parameter.
LOCAL | NONLOCAL
Optional parameter you use to specify whether the service group is local or
nonlocal for this set of RECONs. This parameter is sometimes referred to as
the LOCALE parameter.
NORTA
Optional parameter you use to specify that you do not want to continue a
remote takeover that is currently in progress. This parameter turns off takeover
indicators in the RECON. This parameter is valid for either the active or tracking
subsystem.
When you specify the NORTA parameter, you must specify the appropriate
STATUS parameter (either ACTIVE or TRACKING), and you cannot specify the
LOCALE parameter (LOCAL | NONLOCAL).
If you use NORTA when no remote takeover is in progress, message DSP0144I
is issued. You should wait to receive a takeover-in-progress message before
using NORTA.

Example of Changing the Status of a Service Group

In this example, the Service Group’s role or status is changed to ACTIVE.

Chapter 9. CHANGE Commands 167

CHANGE.SG
//CHGSG
. JOB
.
.

//SYSIN DD *
CHANGE.SG SGNAME() GSGNAME(GSG1) ACTIVE
/*

CHANGE.SUBSYS
ALL
OO CHANGE.SUBSYS SSID(name) O
BACKIRLM(name) IRLMID(name) NORMAL
NOBACKUP ABNORMAL

O OP
STARTRCV TRACKING
ENDRECOV

Use a CHANGE.SUBSYS command to modify information that is contained in a

subsystem record in RECON.

Parameters
SSID(name) | ALL
Required parameter you use to specify the subsystem you are using. The SSID
is an eight-character string consisting of any alphanumeric characters that
comprise a valid MVS or IMS subsystem identification name. If you specify ALL,
the requested processing is done for every subsystem that communicates with
the specified Internal Resource Lock Manager (IRLM).
BACKIRLM(name) | NOBACKUP
Mutually exclusive, optional parameters you use to change the specification of
the alternate subsystem.
BACKIRLM
Adds an alternate subsystem IRLM ID to the active subsystem record.
When you specify BACKIRLM, you must also specify IRLMID. DBRC
locates the specified subsystem record and adds or changes the IRLM ID
of the alternate subsystem.
NOBACKUP
Deletes the IRLM ID of the alternate subsystem from the active subsystem
record. This also resets the flags in the subsystem record to indicate that
the alternate subsystem is signed on. This command might be required
prior to restarting the alternate subsystem.

Restriction: You cannot use NORMAL or ABNORMAL, or STARTRCV or

ENDRECOV with this parameter.
IRLMID(name)
Optional parameter you use to specify the name of the IRLM with which the
subsystem is communicating. The IRLMID is a five-character string consisting of
any alphanumeric characters.
Restriction: You cannot change the IRLM ID. Specify the IRLM ID in order to
change processing mode of a subsystem.

168 DBRC Guide & Reference

CHANGE.SUBSYS
NORMAL | ABNORMAL
Mutually exclusive, optional parameters you use to specify the status of the
subsystem.
NORMAL
Specifies that normal processing is to continue for the subsystem.
ABNORMAL
Indicates that the subsystem has abnormally ended. When ABNORMAL is
specified, DBRC does the following:
v Removes authorization for any databases that have not been updated
but are authorized for the specified subsystem
v Flags the identified subsystem entry as having been abnormally ended
v Turns off the recovery-processing-started flag
v If the subsystem is batch and no databases were updated, then the
subsystem record is deleted.

Restriction: If you specify STARTRCV or ENDRECOV, you cannot specify

ABNORMAL.
STARTRCV | ENDRECOV
Mutually exclusive, optional parameters you use to specify whether a signon
recovery has completed successfully.
STARTRCV
Indicates a signon recovery start.
ENDRECOV
removes authorization for all databases that the specified subsystem
authorized.

If you want to delete all database authorizations from a subsystem, you must
issue the CHANGE.SUBSYS STARTRCV command and then issue the
CHANGE.SUBSYS ENDRECOV command. These two commands simulate the
signon recovery start and signon recovery complete calls.

Recommendation: Do not use this sequence of commands unless an

abnormal end occurred. Otherwise, you remove authorization for the databases
that an active subsystem is currently using.

If, after using STARTRCV | ENDRECOV and DELETE.SUBSYS commands,

subsystem information is still associated with the database, a CHANGE.DB
command with the NOBACK parameter is required in order to clear the
remaining subsystem ID from the database record.
TRACKING
Specifies that information about the RSR tracking subsystem is to be changed.
Attention: If you specify TRACKING, do not specify STARTRCV or
ENDRECOV.

Example of Identifying the IRLM

In this example, IRLMID identifies the IRLM that is communicating with the
subsystem identified in the SSID parameter. In addition, ABNORMAL indicates that
this subsystem abnormally ended.

Chapter 9. CHANGE Commands 169

CHANGE.SUBSYS
//CHGSBSYS JOB
.
.
.

//SYSIN DD *
CHANGE.SUBSYS IRLMID(IRLM2) SSID(ISM34) ABNORMAL
/*

CHANGE.UIC
OO CHANGE.UIC DBD(name) DDN(name) RECTIME(time stamp) UDATA('string') OP
AREA(name)

Use a CHANGE.UIC command to modify information in the image copy record in

RECON that corresponds to a nonstandard image copy data set.

Parameters
DBD(name)
Required parameter you use to identify the database name of the DBDS for
which a nonstandard image copy data set exists.
DDN(name) | AREA(name)
Mutually exclusive, required parameters you use to identify the name of the
DBDS or area for which the nonstandard image copy data set exists.
RECTIME(time stamp)
Required parameter you use to identify the specific image copy record of the
nonstandard image copy data set that is to be modified. Use the time stamp
with an adjacent asterisk (*) in a listing of the IMAGE record. The time stamp
must be in standard form (see “Standard Time Stamp Format” on page 101).
UDATA('string')
Required parameter you use to change the user data in the identified image
copy record. string can be up to 80 characters and must appear in single
quotation marks.

Example of Changing the Nonstandard ICDSN in RECON

In this example, information in RECON about the nonstandard image copy data set
identified by the RECTIME parameter is to be changed. The UDATA parameter
specifies the new information that is to be recorded for the specified image copy
data set.
//CHGUIC JOB
.
.
.

//SYSIN DD *
CHANGE.UIC DBD(DBDKSDS1) AREA(AREA003) -
RECTIME(840651010100) -
UDATA('DUMP OF VOLUME VOL001 AT 840651010100')
/*

170 DBRC Guide & Reference

Chapter 10. DELETE Commands
DELETE.ADS
OO DELETE.ADS ADDN(name) AREA(name) DBD(name) OP

Use a DELETE.ADS command to delete an ADS from its associated area in the
RECON record structure. An area can consist of a maximum of seven ADSs. The
ADS that is to be deleted must have been registered by an INIT.ADS command.

The DELETE.ADS command fails if you issue it while the area is authorized and the
ADS is in AVAILABLE status. The command can be used if the ADS is in
UNAVAILABLE status, provided that the ADS Create utility is not running.

Parameters
ADDN(name)
Required parameter you use to identify the area name of the ADS to be
deleted.
AREA(name)
Required parameter you use to identify the name of the area that contains the
ADS to be deleted.
DBD(name)
Required parameter you use to identify the database name of the area that is to
be deleted.

Example of Deleting an ADS Record

In this example an ADS record is deleted from RECON for the DEDB area that is
identified by the DBD, AREA, and ADDN parameters.
//DELADS JOB ('LEOPARD,IMS'),'LEOPARD',REGION=880K,
.
.
.

//SYSIN DD *
DELETE.ADS DBD(DBD00001) AREA(AREA0001) -
ADDN(AREA0002)
/*

DELETE.ALLOC
OO DELETE.ALLOC DBD(name) DDN(name) RECTIME(timestamp) OP
AREA(name)

Use a DELETE.ALLOC command to delete from RECON an allocation record that is

related to a specified DBDS or DEDB area. An allocation record can be deleted
only when it contains a deallocation time or when its associated log has a stop
time. Except for deleting allocation records that precede the oldest image copy data
set for a DBDS or DEDB area, deleting an allocation record should be done with

© Copyright IBM Corp. 1974, 2001 171

DELETE.ALLOC
caution, and is not normally required. Deleting an allocation record that represents a
period of time during which you changed the specified DBDS or area can cause a
future recovery to be incorrect.

Parameters
DBD(name)
Required parameter you use to identify the database name of the DBDS or
area for which the allocation record is to be deleted.
DDN(name) | AREA(name)
Mutually exclusive, optional parameters you use to identify the data set ddname
of the DBDS or DEDB area for which the allocation record is to be deleted.
RECTIME(timestamp)
Required parameter you use to identify the specific allocation record to be
deleted for a specified DBDS or DEDB area. Use the time stamp with an
adjacent asterisk (*) in a listing of the ALLOC record. The time stamp must be
in standard form (see “Standard Time Stamp Format” on page 101).

Example of Deleting an Allocation Record

In this example, an allocation record is deleted from RECON for the DBDS that is
identified by the DBD and DDN parameters. The RECTIME parameter identifies the
specific allocation record that is to be deleted.
//DELALLOC JOB
.
.
.

//SYSIN DD *
DELETE.ALLOC DBD(DBDKSDS1) DDN(DDNKSDS1) -
RECTIME(840231102234)
/*

DELETE.BKOUT
OO DELETE.BKOUT SSID(name) OP

Use a DELETE.BKOUT command to delete backout records from the RECON.

Use this command, for example, following the successful restore of a recent image
copy. The backout information held in RECON at the time of the copy is
meaningless, but DBRC is not aware of this fact, and DBRC does not delete the
backout records automatically.

Attention: Use the DELETE.BKOUT command with extreme caution. It deletes all
backout information for a subsystem from the RECON; this is information that
DBRC uses to help IMS maintain database integrity.

Parameters
SSID(name)
Required parameter you use to identify the subsystem for which a backout
record is to be deleted. The subsystem name is an eight-character,

172 DBRC Guide & Reference

DELETE.BKOUT
alphanumeric string that represents any valid subsystem. You can specify one
subsystem each time you issue the command.
For each database entry in the record that is marked as backout required, the
backout count in its associated database header record for this subsystem
(SSID) is reduced by one. If this results in a zero backout count for this SSID,
the SSID entry is removed from the database header record.

Example of Using the DELETE.BKOUT Command

This example uses the DELETE.BKOUT command to backout subsystem IMS3.
//DELBKOUT JOB
.
.
.

//SYSIN DD *
DELETE.BKOUT SSID(IMS3)
/*

DELETE.CA
OO DELETE.CA GRPNAME(name) RECTIME(timestamp) OP

Use a DELETE.CA command to delete from RECON a change accumulation run

record for a specified CA group.

Parameters
GRPNAME(name)
Required parameter you use to specify the CA group. The CA run record that is
to be deleted is a member of this CA group.
RECTIME(time stamp)
Required parameter you use to specify the change accumulation run record that
is to be deleted.
Use the RECTIME marked with an asterisk (*) from the listing of the CA record.
The timestamp must be in standard form (see “Standard Time Stamp Format”
on page 101).

Example of Deleting a Run Record

In this example, a run record is deleted from RECON for the CA group identified by
the GRPNAME parameter. The RECTIME parameter identifies the record to be
deleted.
//DELCA JOB
.
.
.

//SYSIN DD *
DELETE.CA GRPNAME(CAGRP1) RECTIME(821220909540)
/*

Chapter 10. DELETE Commands 173

DELETE.CAGRP

DELETE.CAGRP
OO DELETE.CAGRP GRPNAME(name) OP

Use a DELETE.CAGRP command to delete a CA group record and all associated CA

run records from RECON.

Parameters
GRPNAME(name)
Required parameter you use to specify the name of the CA group whose
records that are to be deleted.

Example of Deleting CA Group Records

In this example, CA group records are deleted from RECON. The CA group for
which the record is being deleted is identified by the GRPNAME parameter.
//DELCAGRP JOB
.
.
.

//SYSIN DD *
DELETE.CAGRP GRPNAME(CAGRP2)
/*

DELETE.DB
OO DELETE.DB DBD(name) OP

Use a DELETE.DB command to delete from RECON a database record and all its
associated DBDS records. If any subsystem is authorized to use the specified
database, the command fails and none of the RECON records are deleted.

| Restriction for HALDBs: You must use the HALDB Partition Definition utility to
| update or delete information about HALDBs in the RECON data set. The DELETE.DB
| command cannot be used to delete a HALDB master or partition.

Parameters
DBD(name)
Required parameter you use to identify the name of the database whose
records are to be deleted.
All database, DBDS, allocation, image copy, recovery, and reorganization
records that have the same database name as name are deleted. In addition,
all CA group and DBDS group records are scanned in order to delete any
entries for which the corresponding DBDS records have been deleted. All log
allocation records are also scanned in order to delete any entries in the
allocation list for which the corresponding DBDS records have been deleted.

174 DBRC Guide & Reference

DELETE.DB
Example of Deleting Records from RECON
In this example, records are deleted from RECON for the database and its
corresponding DBDSs identified by the DBD parameter.
//DELDB JOB
.
.
.

//SYSIN DD *
DELETE.DB DBD(THISDB)
/*

DELETE.DBDS
OO DELETE.DBDS DBD(name) DDN(name) OP
AREA(name)

Use a DELETE.DBDS command to delete from RECON all records that are related to
a specified DBDS or DEDB area. If the DBDS for which the records are to be
deleted belongs to a CA group or to a DBDS group, its name is removed from the
group record. The DELETE.DBDS command fails if the DL/I database or Fast Path
DEDB area is in use.

| Restriction for HALDBs: You must use the HALDB Partition Definition utility to
| update or delete information about HALDBs in the RECON data set. The
| DELETE.DBDS command cannot be used to delete any DBDSs of a HALDB partition.

Parameters
DBD(name)
Required parameter you use to specify the database name of the DBDS or
DEDB area for which all records to be deleted.
DDN(name) | AREA(name)
Mutually exclusive, required parameters you use to specify the ddname of the
DBDS or area for which all records are to be deleted from RECON.

Example of Deleting Records for the DBDS

In this example, records are deleted from RECON for the DBDS identified by the
DBD and DDN parameters.
//DELDBDS JOB
.
.
.

//SYSIN DD *
DELETE.DBDS DBD(DBDESDSA) DDN(DDNESDSA)
/*

DELETE.DBDSGRP
OO DELETE.DBDSGRP GRPNAME(name) OP

Chapter 10. DELETE Commands 175

DELETE.DBDSGRP
Use a DELETE.DBDSGRP command to delete the record of a specified DBDS group
from RECON.

Parameters
GRPNAME(name)
Required parameter you use to specify the name of the DBDS group that is
being deleted. The specified name must be that of a group that is identified in
RECON.

Example of Deleting a DBDS Group Record

In this example, a DBDS group record is deleted from RECON.
//DELDBDGP JOB
.
.
.

//SYSIN DD *
DELETE.DBDSGRP GRPNAME(DBDSGRP1)
/*

DELETE.GSG
OO DELETE.GSG GSGNAME(gsgname) OP

Use a DELETE.GSG command to delete a global service group record from the
RECON. The GSG must not have any subsystem assigned to it.

Databases assigned to this GSG are reset to uncovered status as part of the
processing of the DELETE.GSG command. The GSG names and log tokens of all
RECON log records that are associated with this GSG are reset.

This command fails if RSRFEAT=NO is specified in the IMSCTRL macro.

Parameters
GSGNAME(gsgname)
Required parameter you use to specify the name of the global service group to
be deleted.

Example of Deleting a Global Service Group Record

In this example, a global service group record is deleted from RECON.
//DELDBDGP JOB
.
.
.

//SYSIN DD *
DELETE.GSG GSGNAME(GSGNM1)
/*

176 DBRC Guide & Reference

DELETE.IC

DELETE.IC
OO DELETE.IC DBD(name) DDN(name) RECTIME(timestamp) ICDSN2(name) OP
AREA(name)

Use a DELETE.IC command to delete an image copy record or the information about
a second image copy data set. If you specify the ICDSN2 parameter, only the
information about a second image copy data set is deleted; otherwise, both the
entire image copy record and the information about the second image copy data set
are deleted.

Parameters
DBD(name)
Required parameter you use to identify the image copy record to be deleted.
name is the database name of the DBDS or DEDB area to which it is related.
DDN(name) | AREA(name)
Mutually exclusive, required parameters you use to identify the image copy
record to be deleted. name is the name of the DBDS or DEDB area to which it
is related.
RECTIME(timestamp)
Required parameter you use to identify the specific image copy record that is to
be deleted. Use the RUN time marked with an asterisk (*) in a listing of the
IMAGE record. The time stamp must be in standard form (see “Standard Time
Stamp Format” on page 101).
ICDSN2(name)
Optional parameter you use to specify the name of a duplicate image copy data
set for which information is to be deleted from an image copy record. (The
record of the first image copy data set remains in RECON.)

Example of Deleting Information from an Image Copy Record

In this example, information about a duplicate image copy data set is deleted from
an image copy record in RECON. The parameters DBD, AREA, ICDSN2, and
RECTIME identify the information to be deleted. The asterisk (*) in the ICDSN2
parameter is to be expanded by DBRC according to the default-naming convention
for image copy data sets.
//DELIC JOB
.
.
.

//SYSIN DD *
DELETE.IC DBD(DBDKSDS1) AREA(AREA006) -
RECTIME(841231223221) ICDSN2(IMS.*.ICDSN5)
/*

DELETE.LOG (for OLDS)

OO DELETE.LOG OLDS(ddname) OP
INTERIM LASTCLOS SSID(name)

Chapter 10. DELETE Commands 177

DELETE.LOG (for OLDS)
Use this command to delete a data set entry from an OLDS record.

Parameters
OLDS(ddname)
Required parameter you use to specify the ddname of the primary OLDS.
DBRC deletes the RECON records of the primary and secondary OLDS for the
specified subsystem with the specified ddname. You can delete the record of an
OLDS only if the OLDS has been archived.
INTERIM
Optional parameter you use to specify that an interim OLDS record is to be
deleted.
LASTCLOS
Optional parameter you use to specify that the OLDS specified in the OLDS
parameter is the last OLDS in the PRIOLDS record and should be deleted. Use
this parameter with caution. Normally, the last OLDS in the PRIOLDS record is
the last OLDS that was closed, and you should not delete it. Close the first
OLDS in a subsequent restart if the first OLDS is empty because of an error.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the log data set for which the RECON record is to be deleted.
The SSID is an eight-character string of any alphanumeric characters that
comprise a valid IMS subsystem identification name. If you do not specify SSID,
DBRC uses the default subsystem identifier in the RECON header record. Use
the INIT.RECON or CHANGE.RECON command to set the default subsystem
identifier in the RECON header record. If you have not set a default in the
RECON header record, you must specify SSID.

Example of Deleting an Interim OLDS Record

In this example, an interim OLDS record is deleted from RECON.
//DELLOG JOB
.
.
.

//SYSIN DD *
DELETE.LOG SSID(IMSA) OLDS(DFSOLP03) -
INTERIM
/*

DELETE.LOG (for RLDS and SLDS)

INACTIVE
OO DELETE.LOG OP
STARTIME(timestamp) LISTDL TRACKING
DSN(name) NOLISTDL

INTERIM
TOTIME(timestamp)

With this command you can delete the following records:

v A PRILOG family of records
v One data set entry from a PRILOG family

178 DBRC Guide & Reference

DELETE.LOG (for RLDS and SLDS)
v Some or all inactive PRILOG families
v SLDSs produced by RSR tracking subsystems (TPSLD, TSSLD, TIPSL TISSL)
Use this command to prevent the PRILOG records from exceeding the maximum
RECON record size.

You can also delete records of SLDSs created by RSR tracking IMS subsystems. In
addition, you can delete single data set entries from RLDS and SLDS records.

Parameters
INACTIVE | STARTIME(timestamp) | TOTIME(timestamp)
Mutually exclusive, optional parameters you use to specify the records that are
to be deleted.
For a log to be considered inactive, all of the following conditions must be met:
v The log does not contain any DBDS change records more recent than the
oldest image copy data set that is known to DBRC (empty LOGALL record).
v The log exceeds the log retention period specified in the INIT.RECON or
CHANGE.RECON command.
v The log has either been terminated (nonzero stop time) or has the ERROR
flag in the PRILOG or SECLOG record set on.
INACTIVE
Deletes an inactive PRILOG and its associated log records.
INACTIVE does not delete PRILOG and SECLOG records for logs that do
not satisfy all three conditions. Most logs satisfy the conditions. Use
STARTIME(timestamp) for those logs that do not satisfy all three conditions.
Active PRILOG records are also examined to determine whether they
should be compressed, and to delete any inactive data set entries in the
records. A data set entry is defined as inactive if all of the following three
conditions are met:
v It is older than the log retention period specified in the INIT.RECON or
CHANGE.RECON command.
v It is older than the earliest log volume required for recovery of any DB
that is registered in the RECON.
v It is older than the earliest checkpoint that is required for system restart.

See “Deleting Log Records” on page 84 and “Getting PRILOG Compression

to Work” on page 82 for more information about deleting log records and
compression.
STARTIME
Specifies the START time of the log records to be deleted. Use the time
stamp with an adjacent asterisk (*) in a list of the PRILOG or SECLOG
record.
DSN(name)
Optional parameter you use to specify the data set name of a particular
log data set whose entry in the RLDS or SLDS record is to be deleted.
The specified data set name can exist in one or more of the primary
and secondary RLDS and SLDS records; all entries having the same
log sequence number range as the specified data set are deleted.

Chapter 10. DELETE Commands 179

DELETE.LOG (for RLDS and SLDS)
If the data set to be deleted is the last in the log record and if it is
closed, the log stop time is set to zeros to indicate that a data set gap
exists at the end of the record.
STARTIME is required with DSN. If DSN is not specified, the entire
RLDS or SLDS record is deleted. You cannot specify TOTIME,
INTERIM, or TRACKING with DSN.
Only log data at the tracking site is eligible for deletion.
INTERIM
Optional parameter you use to specify the interim RLDS record and
interim SLDS record to be deleted.
Restrictions:
v You cannot specify INTERIM if DSN is specified.
v STARTIME must be specified in conjunction with INTERIM.
TOTIME
Specifies that the records of all inactive RLDSs and SLDSs that have a
start time older than the time specified with the TOTIME parameter deleted.
You must specify a time that is less than the current time, minus the log
retention period. The time stamp must be in standard form (see “Standard
Time Stamp Format” on page 101). If the PRILOG is older than TOTIME but
it is still active, it will be examined to delete all of the inactive data set
entries in the record.
Restriction:
You cannot specify TOTIME if DSN is specified.
LISTDL | NOLISTDL
Mutually exclusive, optional parameters you use to specify whether the names
of the data sets deleted from the RECON are to be listed in the job output.
These parameters override the default, which is set by the INIT.RECON or
CHANGE.RECON command.
LISTDL
Specifies that the names of deleted data sets are to be listed in the job
output.
NOLISTDL
Specifies that the names of deleted data sets are not to be listed in the job
output.

The default is the value specified by the INIT.RECON or CHANGE.RECON command.

TRACKING
Optional parameter you use to specify that only records of SLDSs created by
RSR tracking subsystems are to be deleted. These are the TPSLD, TSSLD,
TIPSL, and TISSL records. This parameter must be specified with SSID,
STARTIME, and TOTIME.
If TRACKING is specified, neither DSN nor INACTIVE can be specified.
If INTERIM is specified, only the TIPSL and TISSL records are deleted.

Example of Deleting the Record of an RLDS and SLDS

In this example, the interim RLDS and interim SLDS records that are identified by
the STARTIME parameter are deleted from RECON.

180 DBRC Guide & Reference

DELETE.LOG (for RLDS and SLDS)
//DELLOG JOB
.
.
.

//SYSIN DD *
DELETE.LOG STARTIME(840541212120)-
INTERIM
/*

DELETE.RECOV
OO DELETE.RECOV DBD(name) DDN(name) RECTIME(timestamp) OP
AREA(name)

Use a DELETE.RECOV command to delete a specified recovery run record from

RECON. Specifying DELETE.RECOV for the recovery run record of a timestamp
recovery implies that the DBDS or DEDB area that is related to the record has been
restored. It has been restored to the state it was in just before the timestamp
recovery that created the recovery run record that you are deleting. Such a deletion
also implies that no allocations of the DBDS or DEDB area took place that
generated change records on IMS log data sets after the timestamp recovery
occurred.

Parameters
DBD(name)
Required parameter you use to identify the recovery record to be deleted; name
is the database name of the related DBDS or DEDB area.
DDN(name) | AREA(name)
Mutually exclusive, required parameters you use to identify the recovery record
to be deleted; name is the name of the related DBDS or DEDB area.
RECTIME(timestamp)
Required parameter you use to specify the time stamp of the recovery run
record to be deleted. Use the time stamp with an adjacent asterisk (*) in a list of
the RECOV record. The time stamp must be in standard form (see “Standard
Time Stamp Format” on page 101).

Example of Deleting a Recovery Record of the DBDS

This example shows the deletion from RECON of the record of a recovery of the
DBDS identified by the DBD and DDN parameters. The record to be deleted is
identified by the RECTIME parameter.
//DELRECOV JOB
.
.
.

//SYSIN DD *
DELETE.RECOV DBD(DBDESDSB) DDN(DDNESDSB) -
RECTIME(930891919190)
/*

Chapter 10. DELETE Commands 181

DELETE.REORG

DELETE.REORG
OO DELETE.REORG DBD(name) DDN(name) RECTIME(timestamp) OP

Use a DELETE.REORG command to delete a database reorganization record for a

specified DBDS from RECON. When you specify the DELETE.REORG command, you
are implying that the DBDS and the IMS DBD library have been restored to the
state they were in before the reorganization that created the database
reorganization record. By using the DELETE.REORG command, you are also implying
that no allocations of the reorganized database that generated records in IMS log
data sets took place.

Parameters
DBD(name)
Required parameter you use to identify the reorganization record to be deleted;
name is the database name of the related DBDS.
DDN(name)
Required parameter you use to identify the reorganization record to be deleted;
name is the data set ddname of the related DBDS.
RECTIME(timestamp)
Required parameter you use to identify the specific database reorganization
record to be deleted. Use the time stamp with an adjacent asterisk (*) in a list of
the REORG record. The time stamp must be in standard form (see “Standard
Time Stamp Format” on page 101).

Example of Deleting a Reorganization Record of a DBDS

In this example, a record of the reorganization of a DBDS is deleted from RECON.
//DELREORG JOB
.
.
.

//SYSIN DD *
DELETE.REORG DBD(DBDESDSB) DDN(DDNESDSB) -
RECTIME(840231102234)
/*

DELETE.SG
OO DELETE.SG GSGNAME(gsgname) SGNAME(sgname) OP

Use a DELETE.SG command to delete a service group entry within a global service
group record in the RECON. The service group cannot be deleted while a
subsystem is signed on to the global service group.

This command fails if RSRFEAT=NO is specified in the IMSCTRL macro.

182 DBRC Guide & Reference

DELETE.SG
Parameters
GSGNAME(gsgname)
Required parameter you use to specify the name of the global service group to
which the service group belongs.
SGNAME(sgname)
Required parameter you use to specify the name of the service group to be
deleted.

Example of Deleting a Global Service Group Record

In this example, a service group entry within a global service group record is
deleted from RECON.
//DELDBDGP JOB
.
.
.

//SYSIN DD *
DELETE.SG GSGNAME(GSGNM1) SGNAME(SGNM1)
/*

DELETE.SUBSYS
OO DELETE.SUBSYS SSID(name) OP

Use a DELETE.SUBSYS command to delete the subsystem entry in RECON after it is

verified that the specified subsystem is not authorized to use any database.

For more information about deleting subsystem entries, see “CHANGE.SUBSYS” on

page 168.

To close the subsystem log, issue the NOTIFY.PRILOG command, and then issue the
DELETE.SUBSYS command.

Parameters
SSID(name)
Required parameter you use to identify the subsystem for which the entry is
deleted from RECON if no database is authorized by the subsystem.
When you issue this command online, the IMS control region under which the
command was issued cannot be the subsystem being deleted.

Example of Deleting a Specified SUBSYS Record

In this example, the specified SUBSYS record is deleted if no database is
authorized by the subsystem.
//DELSBSYS JOB
.
.
.

//SYSIN DD *
DELETE.SUBSYS SSID(IMS34)
/*

Chapter 10. DELETE Commands 183

DELETE.UIC

DELETE.UIC
OO DELETE.UIC DBD(name) DDN(name) RECTIME(timestamp) OP
AREA(name)

Use a DELETE.UIC command to delete the record of a nonstandard image copy data
set from RECON.

Parameters
DBD(name)
Required parameter you use to identify the nonstandard image copy record to
be deleted; name is the database name of the related DBDS or area.
DDN(name) | AREA(name)
Mutually exclusive, required parameters you use to identify the nonstandard
image copy record to be deleted; name is the name of the related DBDS or
DEDB area.
RECTIME(timestamp)
Required parameter you use to specify the timestamp of the nonstandard image
copy record to be deleted. Use the timestamp with an adjacent asterisk (*) in a
list of the IMAGE record. The timestamp must be in standard form (see
“Standard Time Stamp Format” on page 101).

Example of Deleting a Nonstandard Image Copy Data Set Record

This example shows the deletion of a record of a nonstandard image copy data set
from RECON.
//DELUIC JOB
.
.
.

//SYSIN DD *
DELETE.UIC DBD(DBDESDSB) AREA(AREAESD2) -
RECTIME(840871212120)
/*

184 DBRC Guide & Reference

Chapter 11. GENJCL Commands
GENJCL.ARCHIVE
ALL
,

OO GENJCL.ARCHIVE OLDS( S ddname ) O

SLDSTOTIME(timestamp) ,

DEFAULTS( S member )
JOB NOLIST
O O
JCLOUT JCLPDS JOB(member) LIST
JCLOUT( ddname ) JCLPDS( ddname ) NOJOB

O O
MAXOLDS(n) MEMBER(member) SSID(name)

O OP
,

USERKEYS( S ( %key1 , 'value' ) )

%key2

Use the GENJCL.ARCHIVE command to generate the JCL and utility control
statements that run the Log Archive utility. For the IBM-supplied skeletal JCL
execution member that is used by GENJCL.ARCHIVE, see “Using the Commands to
Generate JCL and User-Defined Output” on page 309.

Parameters
ALL | OLDS(ddname) | SLDS
Mutually exclusive, required parameters you use to specify which OLDS is
being archived or to request the archive of tracking SLDSs.
Attention:
Ensure that the RSR tracking IMS subsystem has completed the processing of
the SLDS before you run a batch archive. If a tracking IMS process (such as
online forward recovery (OFR), log truncation, or catch up) needs to read from
an SLDS that is being processed by batch archive, allocation of the SLDS by
the tracking IMS fails, and the tracking IMS might terminate abnormally.
ALL
Generates JCL to archive all OLDSs that have not been archived. A
multiple-step job can be produced if either of the following conditions exist:
v The specified subsystem has non-contiguous OLDSs.
v A force-EOV condition occurred after you entered /DBRECOVERY .
OLDS
Specifies the ddname of the primary OLDS you are archiving.
SLDS
Generates JCL to archive all tracking SLDSs which are associated with the
specified subsystem that have not been archived. A multiple-step job can be

© Copyright IBM Corp. 1974, 2001 185

GENJCL.ARCHIVE
produced if the PRISLD or SECSLD (or both) have non-contiguous data set
entries that need to be archived, or if they have more unarchived DSNs
than the specified MAXOLDS value.
TOTIME(timestamp)
Specifies that only tracking log data sets with start times older than or
equal to timestamp are to be archived. This parameter is optional and is
valid only when SLDS is also specified. Otherwise it is ignored. The
time stamp must be in standard format.
DEFAULTS(member)
Optional parameter you use to specify up to 10 skeletal JCL default members to
be used when generating JCL. Default members are searched to resolve
keywords in the order in which the members are specified on this parameter.
If a keyword is assigned a value in both the DEFAULTS and USERKEYS
parameters, the value specified in USERKEYS is used.
JCLOUT(JCLOUT | ddname)
Optional parameter you use to specify the output data set for the generated
JCL. The data set is specified by ddname. A JCL DD statement with this
ddname must be included in the job step containing the GENJCL command. The
specified data set can be a member of a partitioned data set (PDS) as long as
it is not the same data set used for the default JCLOUT.
JCLPDS(JCLPDS | ddname)
Optional parameter you use to specify the skeletal JCL data set that is to be
used for input when generating JCL. The data set that is specified by ddname.
A JCL DD statement with this ddname must be included in the job step
containing the GENJCL command.
JOB | JOB(member) | NOJOB
Mutually exclusive, optional parameters you use to specify whether to produce
the job statement in the generated JCL.
JOB
Specifies that the job statement is to be produced. When JOB is specified
without a member name, the IBM-supplied execution member JOBJCL
produces the job statement. When JOB(member) is specified, the specified
execution member produces the job statement.
NOJOB
Specifies that the job statement is not produced in the generated JCL.
LIST | NOLIST
Mutually exclusive, optional parameters you use to specify whether to print the
generated JCL using the SYSPRINT data set.
LIST
Prints the generated JCL.
NOLIST
Suppresses printing of the generated JCL.
MAXOLDS(n)
Optional parameter you use to specify the maximum number of OLDSs or
SLDSs to be archived in a single job. n can be any decimal number from 1 to
100.
If MAXOLDS is specified and more OLDSs need archiving than are specified in
n, multiple jobs are generated. Each generated job archives no more than n
OLDSs.

186 DBRC Guide & Reference

GENJCL.ARCHIVE
This parameter functions somewhat differently for SLDSs than for OLDSs. If
MAXOLDS is specified and more SLDSs need archiving than are specified in n,
multiple job steps are generated. Each generated job step archives no more
than n SLDSs.
MAXOLDS applies only to the primary data sets. If dual logging is in effect,
each job can have DD statements for the secondary and primary data sets (that
is, DD statements for 2 x n data sets).
If you do not specify MAXOLDS, a single job is generated for all OLDSs or
SLDSs.
MEMBER(member)
Optional parameter you use to specify the name of the skeletal JCL execution
member to be used. If this parameter is not specified, the IBM-supplied
execution member for the GENJCL.ARCHIVE command is used. For a description
of this execution member, see “Using the Commands to Generate JCL and
User-Defined Output” on page 309.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the OLDSs or SLDSs that are to be archived.
The SSID is an eight-character string of any alphanumeric characters that
comprise a valid IMS subsystem identification name. If you do not specify SSID,
DBRC uses the default subsystem identifier in the RECON header record. Use
the INIT.RECON or CHANGE.RECON command to set the default system identifier in
the RECON header record. If you have not set a default in the RECON header
record, you must specify SSID.
USERKEYS(%key1,'value' | %key2)
Optional parameter you use to set the value of keywords you have defined. Up
to 32 keywords can be specified.
%key1
User-defined keyword being assigned a value. The maximum length of the
keyword is eight characters, including the percent sign. The first character
after the percent sign must be alphabetic (A-Z). The remaining characters
must be alphanumeric (A-Z, 0-9).
'value'
Value assigned to the user-defined keyword when it is encountered. value
can be any character string enclosed in single quotes. The maximum length
of value is 132 characters (excluding the quotes). If value contains a quote,
use two single quotes. value can be a null string (''). If value is a time
stamp, it can be zero.
%key2
Any simple keyword that was previously assigned a value, including
DBRC-defined and user-defined keywords.

Any keyword can be assigned a value with the USERKEYS parameter.

However, if you assign a value to DBRC-defined keywords, the value is ignored.
DBRC-defined keywords are shown in “Understanding Simple Keywords” on
page 311.

If a keyword is assigned a value in both the USERKEYS and DEFAULTS

parameter, the value specified in USERKEYS is used.

Chapter 11. GENJCL Commands 187

GENJCL.ARCHIVE
Examples of Running the Log Archive Utility
Here are some examples of using the GENJCL.ARCHIVE command.

Example with Primary OLDS Defined by the OLDS Parameter

In this example, a GENJCL.ARCHIVE command generates the JCL and control
statements required to run the Log Archive utility for the primary OLDSs that are
defined by the OLDS parameter. When this command is issued, the PRIOLDS
record in RECON is updated to indicate that an archive has been scheduled for the
OLDS. Default skeletal member ARCHJCL is taken from the data set that is
identified in the JCLPDS DD statement. The generated JCL goes to the data set
identified in the JCLOUT DD statement. Skeletal member JOBJCL produces a job
statement.
//GENJAR JOB
//JCLOUT DD . . .
//JCLPDS DD . . .
.
.
.

//SYSIN DD *
GENJCL.ARCHIVE SSID(IMSA) -
OLDS(DFSOLP01,DFSOLP02)
/*

As part of the archive process, the PRIOLDS record in RECON is updated to

indicate that the archive has completed. RECON is updated with the PRISLD and
SECSLD records that identify the created SLDSs. In addition, RECON is updated
with the PRILOG and SECLOG records that identify the created RLDSs.

Example of the SSID IMSB OLDS Parameter Defining the Primary

OLDS
In this example, a GENJCL.ARCHIVE command generates JCL to archive the primary
OLDS that is defined in the OLDS parameter for SSID IMSB. JCL execution
member ARCHJCLA is taken from the JCLPDS data set that is identified in the
PDSJCL DD statement. The generated JCL goes to SYSOUT=A, which is identified
in the OUTJCL DD statement. Skeletal member JOBJCL produces a job statement.
//GENJAR1 JOB
//OUTJCL DD SYSOUT=A
//PDSJCL DD DSN=dsname
//SYSIN DD *
GENJCL.ARCHIVE SSID(IMSB) OLDS(DFSOLP01) MEMBER(ARCHJCLA) -
JCLPDS(PDSJCL) JCLOUT(OUTJCL)

Example for Unarchived Default Subsystem OLDSs

In this example, the GENJCL.ARCHIVE command generates JCL and control
statements to archive all unarchived OLDSs for the default subsystem ID.

JCL execution member ARCHJCLB is taken from the JCLPDS data set that is
identified by the JCLPDS DD statement. Member DEFARC01 from the JCLPDS
data set (identified in the JCLPDS DD statement) contains values to resolve
user-defined keywords in ARCHJCLB. %SSPACE is a user-defined keyword in
member ARCHJCLB which is assigned a value of 'CYL,1'. %RSPACE is a user-defined
keyword in member ARCHJCLB, which is assigned a value of 'TRK,4'.

The values specified in the USERKEYS parameter for a keyword overrides the
values found in the DEFAULTS member. JOB1 is a member in the JCLPDS that
produces a job statement.

188 DBRC Guide & Reference

GENJCL.ARCHIVE
//GENJAR2 JOB
//JCLPDS DD . . .
//JCLOUT DD . . .
//SYSIN DD *
GENJCL.ARCHIVE MEMBER(ARCHJCLB) DEFAULTS(DEFARC01) -
USERKEYS((%SSPACE,'CYL,1'),(%RSPACE,'TRK,4')) JOB(JOB1)

GENJCL.CA
OO GENJCL.CA GRPNAME(name) O
, JCLOUT
JCLOUT( ddname )
DEFAULTS( S member )

JOB NOLIST
O O
JCLPDS JOB(member) LIST MEMBER(member)
JCLPDS( ddname ) NOJOB

O O
NODEFLT 3400
UNIT( unittype )

O O
, ,

USERKEYS( S ( %key1 , 'value' ) ) VOLLIST( S volser )

%key2

O OP
VOLNUM(value)
CATIME(time)

Use the GENJCL.CA command to generate the JCL and utility control statements to
run the Change Accumulation utility for a specified CA group. For information on the
IBM-supplied skeletal JCL execution member used by GENJCL.CA, see “Using the
Commands to Generate JCL and User-Defined Output” on page 309.

Parameters
GRPNAME(name)
Required parameter you use to specify the name of the CA group for which you
are running the Change Accumulation utility.
DEFAULTS (member)
Optional parameter you use to specify the names of up to 10 skeletal JCL
default members that are used when generating JCL. Default members are
searched to resolve keywords in the order in which the members are specified
on this parameter.
If a keyword is assigned a value in both the DEFAULTS and USERKEYS
parameters, the value specified in USERKEYS is used.
JCLOUT (JCLOUT | ddname)
Optional parameter you use to specify the output data set for the generated
JCL. The data set is specified by ddname. A JCL DD statement with this

Chapter 11. GENJCL Commands 189

GENJCL.CA
ddname must be included in the job step containing the GENJCL command. The
specified data set can be a member of a partitioned data set as, but only if it is
not the same data set that is used for the default, JCLOUT.
JCLPDS(JCLPDS | ddname)
Optional parameter you use to specify the skeletal JCL data set that is to be
used for input when generating JCL. The data set is specified by ddname. A
JCL DD statement with this ddname must be included in the job step containing
the GENJCL command.
JOB | JOB(member) | NOJOB
Mutually exclusive, optional parameters you use to specify whether to produce
the first job statement in the generated JCL.
JOB
Specifies that the job statement is to be produced. When JOB is specified
without a member name, the IBM-supplied execution member JOBJCL
produces the job statement.
JOB(member)
Specified execution member produces the job statement.
NOJOB
Specifies that the job statement is not produced in the generated JCL.
LIST | NOLIST
Mutually exclusive, optional parameters you use to specify whether you want
the generated JCL to be written to the SYSPRINT data set.
LIST
Prints the generated JCL.
NOLIST
Suppresses the printing of the generated JCL.
MEMBER(member)
Optional parameter you use to specify the name of the skeletal JCL execution
member that is to be used. If this parameter is not specified, the default
specified for the CA group is used. For a description of the IBM-supplied
execution member, see “Using the Commands to Generate JCL and
User-Defined Output” on page 309.
NODEFLT
Optional parameter you use to specify that the implicit skeletal JCL default
member, if any, for the CA group is not to be used.
UNIT(3400 | unittype)
Optional parameter you use to specify the unit type of the output change
accumulation data set. This parameter is valid only when both of the following
conditions are true:
v The VOLLIST parameter is specified.
v The CA group for which the JCL is being generated is defined with the
NOREUSE parameter.
USERKEYS(%key1,'value' | %key2)
Optional parameter you use to set the value of keywords you have defined. Up
to 32 keywords can be specified.
%key1
User-defined keyword being assigned a value. The maximum length of the

190 DBRC Guide & Reference

GENJCL.CA
keyword is eight characters, including the percent sign. The first character
after the percent sign must be alphabetic (A-Z). The remaining characters
must be alphanumeric (A-Z, 0-9).
'value'
Value assigned to the user-defined keyword when it is encountered. value
can be any character string enclosed in single quotes. The maximum length
of value is 132 characters (excluding the quotes). If value contains a quote,
use two single quotes. value can be a null string (''). If value is a time
stamp, it can be zero.
%key2
Any simple keyword that was previously assigned a value, including
DBRC-defined and user-defined keywords.

Any keyword can be assigned a value with the USERKEYS parameter.

However, if you assign a value to DBRC-defined keywords, the value is ignored.
DBRC-defined keywords are shown in “Understanding Simple Keywords” on
page 311.

If a keyword is assigned a value in both the USERKEYS and DEFAULTS

parameter, the value specified in USERKEYS is used.
VOLLIST(volser)
Optional parameter you use to specify the volumes that are to contain the
change accumulation data set. This parameter is valid only if the CA group for
which the JCL is being generated was defined with the NOREUSE parameter.
VOLNUM(value) | CATIME(time)
Mutually exclusive, optional parameters you use to specify the log volumes that
are used by the Change Accumulation utility.
VOLNUM
Specifies the number of log volumes that are to be used in each change
accumulation job step. DBRC generates a multiple-step job that invokes the
Change Accumulation utility in each step (unless you specify VOLLIST),
and limits the number of log volumes in each step to the specified number.
If another volume is needed to complete subset processing, VOLNUM may
be overridden by DBRC. DBRC may also override VOLNUM for the
following reasons:
v CATDS is specified and a data set entry spans multiple volumes.
v Log volumes have identical start times.
v Log volumes have identical start times and stop times.

For value, specify the number of log volumes. You can specify a decimal
number from 1 to 255.

Each job step except the first one uses the change accumulation data set
(that was generated in the previous step) as the beginning point of the
accumulation in that step.
CATIME
Specifies the time after which no log volumes for the specified CA group
are to be included. The time stamp does not need to be the stop time of
any log volume. DBRC uses the time stamp as the ending delimiter for the
log volume subset. Therefore, all log volumes that have start times less

Chapter 11. GENJCL Commands 191

GENJCL.CA
than or equal to the specified time stamp are included in the subset of
volumes. The time stamp must be in standard form (see “Standard Time
Stamp Format” on page 101).

Examples of Running the Change Accumulation Utility

Here are some examples of using the GENJCL.CA command.

Example for the GRPNAME CA Group

In this example, a GENJCL.CA command generates the JCL and control statements
required to run the Change Accumulation utility for the CA group identified in the
GRPNAME parameter. CAGRP1 is defined as REUSE. If the INIT.CAGRP command
for CAGRP1 is specified without a CAJCL(member) parameter, default skeletal
member CAJCL from the data set identified in the JCLPDS DD statement is used. If
INIT.CAGRP is specified with the CAJCL(member) parameter, that member is used.
The generated JCL goes to the data set that is identified in the JCLOUT DD
statement. Skeletal member JOBJCL produces a job statement.
//GENJCA JOB
//JCLPDS DD . . .
//JCLOUT DD . . .
.
.
.

//SYSIN DD *
GENJCL.CA GRPNAME(CAGRP1)
/*

Example of CAJCLA Generated Skeletal JCL

In this example, the GENJCL.CA command is generated with skeletal JCL execution
member CAJCLA, which was taken from the JCLPDS data set identified by the
PDSJCL DD statement. Output from the generated JCL goes to SYSOUT=A,
identified in the OUTJCL DD statement. CAGRP2 is defined with the NOREUSE
parameter. Skeletal member JOBJCL produces a job statement.
//GENJCA1 JOB
//OUTJCL DD SYSOUT=A
//PDSJCL DD DSN=dsname
//SYSIN DD *
GENJCL.CA GRPNAME(CAGRP2) VOLLIST(VOL001) MEMBER(CAJCLA) -
JCLPDS(PDSJCL) JCLOUT(OUTJCL)

Example of CAJCLB Generated Skeletal JCL

In this example, the GENJCL.CA command generates JCL and control statements to
run the Change Accumulation utility for CAGRP3, which is defined as REUSE. JCL
execution member CAJCLB is taken from the JCLPDS data set identified by the
JCLPDS DD statement.

DEFAULTS(DEFCA01) is a member in the JCLPDS data set which contains values

to resolve user defined keywords in member CAJCLB. The default member for the
CAGRP, if initialized in the INIT.CAGRP DEFLTJCL(MEMBER) command, is also
used to resolve keywords. %DISP is a user-defined keyword in member CAJCLB
which is assigned a value of 'SHR'. %OUTCLS is a user-defined keyword in member
CAJCLB which is assigned a value of 'B'.

The values in the explicitly defined DEFAULTS member overrides values in the
predefined DEFLTJCL member. The values specified in the USERKEYS parameter
for a keyword overrides the values found in the DEFAULTS member. JCL is
generated with no job statement. All volumes that have stop times less than or
equal to the specified time stamp are included in the subset of volumes that is used
as input to the Change Accumulation utility. Generated JCL is listed.

192 DBRC Guide & Reference

GENJCL.CA
//GENJCA3 JOB
//JCLPDS DD
//JCLOUT DD
//SYSIN DD *
GENJCL.CA GRPNAME(CAGRP3) MEMBER(CAJCLB) DEFAULTS(DEFCA01) -
USERKEYS((%DISP,'SHR'),(%OUTCLS,'B')) NOJOB LIST -
CATIME(861020202111)

GENJCL.CLOSE
OO GENJCL.CLOSE O
, JCLOUT
JCLOUT( ddname )
DEFAULTS( S member )

JOB NOLIST
O O
JCLPDS JOB(member) LIST MEMBER(member)
JCLPDS( ddname ) NOJOB

O OP
OLDS(ddname) SSID(name) ,

USERKEYS( S ( %key1 , 'value' ) )

%key2

Use the GENJCL.CLOSE command to generate the JCL and utility control statements
that run the Log Recovery utility to close an OLDS using the WADS. For information
about the IBM-supplied skeletal JCL execution member used by GENJCL.CLOSE, see
“Using the Commands to Generate JCL and User-Defined Output” on page 309.

Parameters
DEFAULTS(member)
Optional parameter you use to specify up to 10 names of skeletal JCL default
members used when generating JCL. Default members are searched to resolve
keywords in the order in which the members are specified on this parameter.
If a keyword is assigned a value in both the DEFAULTS and USERKEYS
parameters, the value specified in USERKEYS is used.
JCLOUT(JCLOUT | ddname)
Optional parameter you use to specify the output data set for the generated
JCL. The data set is specified by ddname. A JCL DD statement with this
ddname must be included in the job step containing the GENJCL command. The
specified data set can be a member of a partitioned data set, but only if it is not
the same data set that is used for the default, JCLOUT.
JCLPDS(JCLPDS | ddname)
Optional parameter you use to specify the skeletal JCL data set to be used for
input when generating JCL. The data set is specified by ddname. A JCL DD
statement with this ddname must be included in the job step containing the
GENJCL command.
JOB | JOB(member)|NOJOB
Mutually exclusive, optional parameters you use to specify whether to produce
the job statement in the generated JCL.

Chapter 11. GENJCL Commands 193

GENJCL.CLOSE
JOB
Specifies that the job statement is produced. When JOB is specified without
a member name, the IBM-supplied execution member JOBJCL produces
the job statement.
JOB(member)
Specified execution member produces the job statement.
NOJOB
Specifies that no job statement is to be produced in the generated JCL.
LIST | NOLIST
Mutually exclusive, optional parameters you use to specify whether you want
the generated JCL to be written to the SYSPRINT data set.
LIST
Prints the generated JCL.
NOLIST
Suppresses the printing of the generated JCL.
MEMBER(member)
Optional parameter you use to specify the name of the skeletal JCL execution
member to be used. If this parameter is not specified, the IBM-supplied
execution member for the GENJCL.CLOSE command is used. For a description of
this execution member, see “Using the Commands to Generate JCL and
User-Defined Output” on page 309.
OLDS(ddname)
Optional parameter you use to specify which OLDS is to be closed. You specify
the name of the DD statement that was used when the online IMS subsystem
created the log data. The ddname of the primary OLDS must be specified. If
you do not specify the OLDS, DBRC generates JCL to close the OLDS that
was most recently opened.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the OLDSs being closed.
The SSID is an eight-character alphanumeric string that comprises a valid IMS
subsystem identification name. If you do not specify SSID, DBRC uses the
default subsystem identifier in the RECON header record. Use the INIT.RECON
or CHANGE.RECON command to set the default system identifier in the RECON
header record. If you have not set a default in the RECON header record, you
must specify SSID.
USERKEYS(%key1,'value' | %key2)
Optional parameter you use to set the value of keywords you have defined. Up
to 32 keywords can be specified.
%key1
User-defined keyword that is being assigned a value. The maximum length
of the keyword is eight characters, including the percent sign. The first
character after the percent sign must be alphabetic (A-Z). The remaining
characters must be alphanumeric (A-Z, 0-9).
'value'
Value assigned to the user-defined keyword when it is encountered. value
can be any character string enclosed in single quotes. The maximum length
of value is 132 characters (excluding the quotes). If value contains a quote,
use two single quotes. value can be a null string (''). If value is a time
stamp, it can be zero.

194 DBRC Guide & Reference

GENJCL.CLOSE
%key2
Any simple keyword that was previously assigned a value, including
DBRC-defined and user-defined keywords.

Any keyword can be assigned a value with the USERKEYS parameter.

However, if you assign a value to DBRC-defined keywords, the value is ignored.
DBRC-defined keywords are shown in “Understanding Simple Keywords” on
page 311.

If a keyword is assigned a value in both the USERKEYS and DEFAULTS

parameter, the value specified in USERKEYS is used.

Examples of Running the Log Recovery Utility

Here are some examples of using the GENJCL.CLOSE command.

Example When a Host Operating System Failed and /ERE Is Not

Possible
In this example, a GENJCL.CLOSE command generates the JCL and control
statements that are required to run the Log Recovery utility for the IMS online
subsystem with subsystem ID IMSA, which was using a primary OLDS when a host
operating system failed and /ERE could not be performed. Default skeletal member
LOGCLJCL is taken from the data set identified in the JCLPDS DD statement.
Output from the generated JCL goes to the data set identified in the JCLOUT DD
statement. Skeletal member JOBJCL produces a job statement.
//GENJCL JOB
//JCLOUT DD
//JCLPDS DD
.
.
.

//SYSIN DD *
GENJCL.CLOSE SSID(IMSA)
/*

After the close job runs, the PRIOLDS record in RECON that corresponds to the
OLDS is updated to indicate the successful close.

Example Using the CLOSE1 JCLPDS Member

In this example, the GENJCL.CLOSE command is generated with a skeletal JCL
execution member CLOSE1, which is taken from the JCLPDS data set identified in
the PDS DD statement. Output from the generated JCL goes to the data set
identified in the OUT DD statement. MEMBER DEFCL1 from the JCLPDS DD
statement contains values to resolve user-defined keywords in member CLOSE1.
Skeletal member JOBJCL produces a job statement. Generated JCL is listed.
//GENJCL1 JOB
//OUT DD . . .
//PDS DD . . .
//SYSIN DD *
GENJCL.CLOSE MEMBER(CLOSE1) OLDS(DFSOLP01) -
JCLPDS(PDS) JCLOUT(OUT) DEFAULTS(DEFCL1) LIST

GENJCL.IC
OO GENJCL.IC DBD(name) O
GROUP(name) COPIES( 1 ) DDN(ddname)
2 AREA(name)
3
4

Chapter 11. GENJCL Commands 195

GENJCL.IC
CIC
O O
NOCIC L ,
SMSCIC DBREL( P )
COMPRESS DEFAULTS( S member )
SMSNOCIC
COMPRESS

JOB NOLIST
O O
JCLOUT JCLPDS JOB(member) LIST
JCLOUT( ddname ) JCLPDS( ddname ) NOJOB

MULTIJOB
O O
MEMBER(member) ONEJOB NODEFLT 3400
UNIT( unittype )

O O
3400 3400 3400
UNIT2( unittype ) UNIT3( unittype ) UNIT4( unittype )

O O
, ,

USERKEYS( S ( %key1 , 'value' ) ) VOLLIST( S volser )

%key2

O O
, ,

VOLLIST2( S volser ) VOLLIST3( S volser )

O OP
,

VOLLIST4( S volser )

Use the GENJCL.IC command to generate the JCL and utility control statements
needed to run the Database Image Copy utility or the Database Image Copy 2
utility. For information about the IBM-supplied skeletal JCL execution member used
by GENJCL.IC, see “Using the Commands to Generate JCL and User-Defined
Output” on page 309.

Important: For HALDB partitions, the GENJCL.IC command treats ILDS and index
data sets differently than data DBDSs. The GENJCL.IC command skips these data
sets in groups, regardless of whether the groups are explicit or implicit. If you
explicitly specify one of these data sets, the GENJCL.IC command fails.

Related Reading:
v See “HALDB Records” on page 60 for detailed information about how HALDBs
are represented in the RECON data set.
v See IMS Version 7 Administration Guide: Database Manager for an overview of
HALDBs and information about how to create them.

196 DBRC Guide & Reference

GENJCL.IC
Parameters
DBD(name) | GROUP(name)
Mutually exclusive, required parameters you use to specify the DBDS or DEDB
area to be copied.
DBD
Specifies the name of the database that contains the DBDS or area to be
copied.
For HALDBs (High Availability Large Databases), you can specify either a
HALDB master name or a HALDB partition name.
GROUP
Specifies that all DBDSs of a DBDS group are to be copied. If GROUP is
specified, the GENJCL.IC command executes repeatedly for each DBDS of
the named DBDS group.
COPIES(1 | 2 | 3 | 4)
Optional parameter you use to specify how many two image copy data sets are
to be produced for the specified DBDS.
If the specified DBDS is identified in RECON with the NOREUSE attribute, you
can specify the COPIES parameter if you want two or more image copy data
sets; otherwise, one image copy data set is produced.
If the specified DBDS is identified in RECON with the REUSE attribute, you
must specify the COPIES parameter if you want two or more image copy data
sets; otherwise only one image copy data set is produced. COPIES(3 | 4) can
only be specified if either SMSCIC or SMSNOCIC is also specified. The third
and fourth copies are not recorded in RECON.
DDN(name) | AREA(name)
Mutually exclusive, optional parameters you use to identify the DBDS ddname
or DEDB area name that is to be copied.
Specify the DDN or AREA parameter only if you specify the DBD parameter. If
you do not specify DDN or AREA, the GENJCL.IC command executes
repeatedly, once for each DBDS or area of the specified database. If you
specify a HALDB master name, the GENJCL.IC command is performed for all
data DBDSs for each partition in the HALDB master database. If you specify a
HALDB partition name, the GENJCL.IC command is performed for all data
DBDSs of the identified partition.
For HALDBs, you must specify a partition database name with the DBD
parameter in order to use the DDN parameter. The DDN parameter value is the
partition DDN. The GENJCL.IC command is performed for the identified DBDS of
the partition. The GENJCL.IC command fails if DDN does not identify a data
DBDS in the partition.
CIC | NOCIC | SMSCIC | SMSNOCIC
Optional, mutually exclusive, parameters you use to indicate how the image
copy is to be taken.
CIC
Specifies that the Database Image Copy (DFSUDMP0) utility is to be used
to take an image copy concurrent with update processing.
NOCIC
Specifies that the Database Image Copy (DFSUDMP0) utility is to be used
to take an image copy while the database is unavailable for update
processing.

Chapter 11. GENJCL Commands 197

GENJCL.IC
SMSCIC
Indicates that the Database Image Copy 2 utility is to be used to take an
image copy concurrent with update processing. The Database Image Copy
2 utility invokes DFSMS Concurrent Copy.
The optional COMPRESS parameter invokes the ″compress″ option in
DFSMS Concurrent Copy. The compress option enables you to reduce the
storage space required to hold the image copy; however, using the
compress option increases the CPU time that is required to perform the
copy operation.
SMSNOCIC
Indicates that the Database Image Copy 2 utility is to be used to take an
image copy while the database is unavailable for update processing. The
Database Image Copy 2 utility invokes DFSMS Concurrent Copy.
The optional COMPRESS parameter invokes the ″compress″ option in
DFSMS Concurrent Copy. The compress option enables you to reduce the
storage space required to hold the image copy; however, using the
compress option increases the CPU time that is required to perform the
copy operation.
DBREL(L | P)
Applicable only when SMSNOCIC is also specified and it indicates when the
database is to be made available for update processing. It is ignored when
SMSNOCIC is not specified.
L L indicates that updates are to be allowed after the image copy is logically
complete (after DFSMS has initialized a concurrent copy session). Update
processing can occur (or be resumed) before the image copy is physically
complete.
P P indicates that updates are not to be allowed until the image copy is
physically complete.
DEFAULTS(member)
Optional parameter you use to specify up to 10 names of skeletal JCL default
members to be used when generating JCL. Default members are searched to
resolve keywords in the order in which the members are specified on this
parameter.
If a keyword is assigned a value in both the DEFAULTS and USERKEYS
parameter, the value specified in USERKEYS is used.
JCLOUT(JCLOUT | ddname)
Optional parameter you use to specify the output data set for the generated
JCL. The data set is specified by ddname. A JCL DD statement with this
ddname must be included in the job step containing the GENJCL command. The
specified data set can be a member of a partitioned data set, but only if it is not
the same data set that is used for the default, JCLOUT.
JCLPDS(JCLPDS | ddname)
Optional parameter you use to specify the skeletal JCL data set that is to be
used for input when generating JCL. The data set is specified by ddname. A
JCL DD statement with this ddname must be included in the job step containing
the GENJCL command.
JOB | JOB(member) | NOJOB
Mutually exclusive, optional parameters you use to specify whether to produce
the job statement in the generated JCL.

198 DBRC Guide & Reference

GENJCL.IC
JOB
Specifies that the job statement is to be produced. When JOB is specified
without a member name, the IBM-supplied execution member JOBJCL
produces the job statement. When JOB(member) is specified, the specified
execution member produces the job statement.
NOJOB
Specifies that the job statement is not to be produced in the generated JCL.
LIST | NOLIST
Mutually exclusive, optional parameters you use to specify whether to write the
generated JCL to the SYSPRINT data set.
LIST
Prints the generated JCL.
NOLIST
Suppresses the printing of the generated JCL.
MEMBER(member)
Optional parameter you use to specify the name of the skeletal JCL execution
member to be used. For a description of the IBM-supplied execution member,
see “Using the Commands to Generate JCL and User-Defined Output” on
page 309. If this parameter is not specified, the default specified on the
INIT.DBDS command is used.
MULTIJOB | ONEJOB
Mutually exclusive, optional parameters you use to control how many JOB
statements are to be generated when a DBDS group is specified either explicitly
or implicitly.
MULTIJOB
Produces one job for each group member.
ONEJOB
Produces one multi-step job for the whole group.

These parameters are invalid if the NOJOB subparameter is specified on the

JOB parameter, or if a DBDS group is not specified.
NODEFLT
Optional parameter you use to specify that the implicit skeletal JCL default
member, if any, for the DBDS is not to be used.
UNIT(3400 | unittype)
UNIT2(3400 | unittype)
UNIT3(3400 | unittype)
UNIT4(3400 | unittype)
Optional parameter you use to specify the unit type of the first, second, third, or
fourth output image copy data sets. These parameters are valid only if both of
the following conditions are true:
v The corresponding VOLLIST parameter is specified
v The DBDS for which the JCL is being generated was defined with the
NOREUSE option
USERKEYS(%key1,'value' | %key2)
Optional parameter you use to set the value of keywords you have defined. Up
to 32 keywords can be specified.

Chapter 11. GENJCL Commands 199

GENJCL.IC
%key1
User-defined keyword that is being assigned a value. The maximum length
of the keyword is eight characters, including the percent sign. The first
character after the percent sign must be alphabetic (A-Z). The remaining
characters must be alphanumeric (A-Z, 0-9).
'value'
Value assigned to the user-defined keyword when it is encountered. value
can be any character string enclosed in single quotes. The maximum length
of value is 132 characters (excluding the quotes). If value contains a quote,
use two single quotes. value can be a null string (''). If value is a time
stamp, it can be zero.
%key2
Any simple keyword that was previously assigned a value, including
DBRC-defined and user-defined keywords.

Any keyword can be assigned a value with the USERKEYS parameter.

However, if you assign a value to DBRC-defined keywords, the value is ignored.
DBRC-defined keywords are shown in “Understanding Simple Keywords” on
page 311.

If a keyword is assigned a value in both the USERKEYS and DEFAULTS

parameter, the value specified in USERKEYS is used.
VOLLIST(volser)
VOLLIST2(volser)
VOLLIST3(volser)
VOLLIST4(volser)
Optional parameters you use to specify the volumes on which the image copy
data set copies are to reside. These parameters are valid only if:
v The DBDS for which the JCL is being generated is defined with the
NOREUSE option.
v DBD is specified with DDN or AREA.

Examples of Running the Database Image Copy Utility

Here are some examples of using the GENJCL.IC command.

Example for DBDS Defined by the DBD and DDN Parameters

In this example, a GENJCL.IC command generates the JCL and control statements
required to run the Database Image Copy utility for the DBDS identified in the DBD
and DDN parameters. The default Concurrent Image Copy (CIC) is used. The
database is defined as REUSE. If the INIT.DBDS command for the DBDS for which
JCL is being generated is specified with ICJCL(member), that skeletal member is
used from the data set that is identified in the JCLPDS DD statement. If not, the
default skeletal member ICJCL from the JCLPDS data set is used. Output from the
generated JCL goes to the data set identified in the JCLOUT DD statement.
Skeletal member JOBJCL produces a job statement.
//GENJIC1 JOB
//JCLOUT DD . . .
//JCLPDS DD . . .
.
.
.

//SYSIN DD *
GENJCL.IC DBD(DBDKSDS1) DDN(DDNKSDS1)

200 DBRC Guide & Reference

GENJCL.IC
The EXEC and SYSIN statements for the generated JCL are shown below:
.
.
.

//IC1 EXEC PGM=DFSUDMP0,REGION=nnnK,

// PARM='CIC,GSGNAME='
.
.
.

//SYSIN DD *
D1 DBDKSDS1 DDNKSDS1 DATAOUT1
/*

Example for All DBDSs in a Group with NOCIC

In this example, the GENJCL.IC command generates JCL and control statements to
run the Image Copy utility for all DBDSs of GROUP1 and batch image copies
(NOCIC) are also taken. The skeletal member used is ICJCL1 from the data set
identified in PDS4. The keyword, %DEFIC, is a user-defined value in ICJCL1 that is
resolved to '1ST USERKEYS PARM'. The default member for the database
initialized in INIT.DBDS DEFLTJCL(MEMBER) is not used to resolve keywords. Skeletal
member JOBJCL produces a job statement.
//GENJIC2 JOB
//JCLOUT DD . . .
//PDS4 DD . . .
//SYSIN DD *
GENJCL.IC GROUP(GROUP1) JOB MEMBER(ICJCL1) JCLPDS(PDS4) ONEJOB -
NOCIC USERKEYS((%DEFIC,'1ST USERKEYS PARM')) NODEFLT

The following statements are examples of one of the EXEC statements and one of
the SYSIN statements for the generated JCL:
.
.
.

//IC1 EXEC PGM=DFSUDMP0,REGION=nnnK,

// PARM=',GSGNAME='
.
.
.

//SYSIN DD *
D1 DBD1GRP1 DDN1GRP1 DATAOUT1
/*
//IC2 EXEC PGM=DFSUDMP0,REGION=nnnK,
// PARM=',GSGNAME='
.
.
.

Example of Running the Database Image Copy 2 Utility with

SMSCIC
In this example, a GENJCL.IC command generates the JCL and control statements
required to run the Database Image Copy 2 utility in shared database mode
(SMSCIC) for the DBDS that is identified in the DBD and DDN parameters. The
database is defined as NOREUSE and four copies are requested. The default
skeletal member ICJCL from the JCLPDS data set is used. Output from the
generated JCL goes to the data set identified in the JCLOUT DD statement.
Skeletal member JOBJCL produces a job statement.
//GENJIC3 JOB
//JCLOUT DD . . .
//JCLPDS DD . . .
.
.
.

Chapter 11. GENJCL Commands 201

GENJCL.IC
//SYSIN DD *
GENJCL.IC DBD(DBDVSAM1) DDN(DDNVSAM1) COPIES(4) SMSCIC -
VOLLIST(IC2001) VOLLIST2(IC2002) VOLLIST3(IC2003) -
VOLLIST4(IC2004)
/*

The EXEC and SYSIN statements for the generated JCL are shown below:
.
.
.

//IC1 EXEC PGM=DFSRRC00,REGION=nnnK,

// PARM='ULU,DFSUDMT0,,,,,,,,,,,,Y,,,,,,,,'
.
.
.

//SYSIN DD *
4 DBDVSAM1 DDNVSAM1 DATAOUT1 DATAOUT2 DATAOUT3 DATAOUT4 S
/*

Example of Running the Database Image Copy 2 Utility with

SMSNOCIC
In this example, the GENJCL.IC command generates JCL and control statements to
run the Database Image Copy 2 utility with exclusive database usage (SMSNOCIC)
for the DBDS that is identified in the DBD and DDN parameters. The database is
defined as REUSE and the default, one copy, is requested. The global service
group name for DBDVSAM2 is GSGN4IC2. The default skeletal member ICJCL
from the JCLPDS data set is used. Output from the generated JCL goes to the data
set identified in the JCLOUT DD statement. Skeletal member JOBJCL produces a
job statement. The database is to be unlocked after the physical copy completes.
//GENJIC4 JOB
//JCLOUT DD . . .
//JCLPDS DD . . .
.
.
.

//SYSIN DD *
GENJCL.IC DBD(DBDVSAM2) DDN(DDNVSAM2) DBREL(P) SMSNOCIC
/*

The EXEC and SYSIN statements for the generated JCL are shown below:
.
.
.

//IC1 EXEC PGM=DFSRRC00,REGION=nnnK,

// PARM='ULU,DFSUDMT0,,,,,,,,,,,,Y,,,,,,,,GSGN4IC2'
.
.
.

//SYSIN DD *
1 DBDVSAM2 DDNVSAM2 DATAOUT1 XP
/*

GENJCL.OIC
OO GENJCL.OIC DBD(name) PSB(name) O
GROUP(name) CHKINT(value) COPIES( 1 )
2

202 DBRC Guide & Reference

GENJCL.OIC
O O
DDN(ddname) , JCLOUT
JCLOUT( ddname )
DEFAULTS( S member )

JOB NOLIST
O O
JCLPDS JOB(member) LIST MEMBER(member)
JCLPDS( ddname ) NOJOB

MULTIJOB
O O
ONEJOB NODEFLT 3400 3400
UNIT( unittype ) UNIT2( unittype )

O O
, ,

USERKEYS( S ( %key1 , 'value' ) ) VOLLIST( S volser )

%key2

O OP
,

VOLLIST2( S volser )

Use the GENJCL.OIC command to generate the JCL and utility control statements
needed to run the Online Database Image Copy utility. For information about the
IBM-supplied skeletal JCL execution member used by GENJCL.OIC, see “Using the
Commands to Generate JCL and User-Defined Output” on page 309.

Important: For HALDB partitions, the GENJCL.OIC command treats ILDS and index
data sets differently than data DBDSs. The GENJCL.OIC command skips these data
sets in groups, regardless of whether the groups are explicit or implicit. If you
explicitly specify one of these data sets, the GENJCL.OIC command fails.

The GENJCL.OIC command and online image copy cannot be used on databases at
an RSR-tracking site.

Parameters
DBD(name) | GROUP(name)
Mutually exclusive, required parameters you use to specify the DBDS or DEDB
area that is to be copied.
DBD
Specifies the name of the DBDS or DEDB area that is to be copied.
For HALDBs (High Availability Large Databases), you can specify either a
HALDB master name or a HALDB partition name.
GROUP
Specifies that all DBDSs of a DBDS group are to be copied. If GROUP is
specified, the GENJCL.IC command executes repeatedly, once for each
DBDS of the DBDS group.

Chapter 11. GENJCL Commands 203

GENJCL.OIC
PSB(name)
Required parameter you use to specify the name of the PSB that is required for
a run of the Online Database Image Copy utility.
If you specify GROUP, the same PSB name is used for all members of the
group.
CHKINT(value)
Optional parameter you use to specify the checkpoint interval for the Online
Database Image Copy utility. value must be a decimal number from 1 to 9999.
If this keyword is omitted, the Online Database Image Copy utility uses its own
default value for the checkpoint interval.
COPIES(1 | 2)
Optional parameter you use to request that the Online Database Image Copy
utility in order to produce one or two image copy data sets for the specified
DBDS.
If the specified DBDS is identified in RECON with the NOREUSE attribute, you
must specify the COPIES parameter in order to produce two image copy data
sets; otherwise, one image copy data set is produced.
If the specified DBDS is identified in RECON with the REUSE attribute, you
cannot specify a COPIES parameter; the number of image copy data sets that
are produced for this DBDS is determined by parameters in the INIT.IC
command.
DDN(name)
Optional parameter you use to identify the DBDS that is to be copied.
The DDN parameter can be specified only if the DBD parameter is specified. If
DDN is not specified, the GENJCL.OIC command executes repeatedly, once for
each DBDS of the specified database. If you specify a HALDB master name,
the GENJCL.OIC command is performed for all data DBDSs for each partition in
the HALDB master. If you specify a HALDB partition name, the GENJCL.OIC
command is performed for all data DBDSs of the identified HALDB partition.
For HALDBs, you must specify a partition database name with the DBD
parameter in order to use the DDN parameter. The DDN parameter value is the
partition DDN. The GENJCL.OIC command is performed for the identified DBDS
of the partition. The GENJCL.OIC command fails if DDN does not identify a data
DBDS in the partition.
DEFAULTS (member)
Optional parameter you use to specify up to 10 names of skeletal JCL default
members to be used when generating JCL. Default members are searched in
order to resolve keywords in the order in which the members are specified on
this parameter.
If a keyword is assigned a value in both the DEFAULTS and USERKEYS
parameters, the value specified in USERKEYS is used.
JCLOUT ( JCLOUT | ddname)
Optional parameter you use to specify the output data set for the generated
JCL. The data set is specified by ddname. A JCL DD statement with this
ddname must be included in the job step containing the GENJCL command. The
specified data set can be a member of a partitioned data set, but only if it is not
the same data set used for the default, JCLOUT.
JCLPDS (JCLPDS | ddname)
Optional parameter you use to specify the skeletal JCL data set that is to be

204 DBRC Guide & Reference

GENJCL.OIC
used for input when generating JCL. The data set is specified by ddname. A
JCL DD statement with this ddname must be included in the job step that
contains the GENJCL command.
JOB | JOB(member) | NOJOB
Mutually exclusive, optional parameters you use to specify whether to produce
the job statement in the generated JCL.
JOB
Specifies that the job statement is to be produced. When JOB is specified
without a member name, the IBM-supplied execution member JOBJCL
produces the job statement. When JOB(member) is specified, the specified
execution member produces the job statement.
NOJOB
Specifies that the job statement is not to be produced in the generated JCL.
LIST | NOLIST
Mutually exclusive, optional parameters you use to specify whether to write the
generated JCL to the SYSPRINT data set.
LIST
Prints the generated JCL.
NOLIST
Suppresses the printing of the generated JCL.
MEMBER(member)
Optional parameter you use to specify the name of the skeletal JCL execution
member that is to be used. For a description of the IBM-supplied execution
member, see “Using the Commands to Generate JCL and User-Defined Output”
on page 309. If this parameter is not specified, the default specified on the
INIT.DBDS command is used.
MULTIJOB | ONEJOB
Mutually exclusive, optional parameters you use to control how many JOB
statements are to be generated when a DBDS group is specified either explicitly
or implicitly.
MULTIJOB
Processes the skeletal JCL JOB member for each group member (multiple
JOB statements are to be produced).
ONEJOB
Processes the skeletal JCL JOB member only for the first group member.

These parameters are invalid if NOJOB is specified or if a DBDS group is not

specified.
NODEFLT
Optional parameter you use to specify that the implicit skeletal JCL default
member, if any, for the DBDS is not to be used.
UNIT(3400 | unittype)
Optional parameter you use to specify the unit type of the primary output data
set. This parameter is valid only if:
v The VOLLIST parameter was specified.
v The DBDS for which the JCL is being generated was defined with the
NOREUSE option.

Chapter 11. GENJCL Commands 205

GENJCL.OIC
UNIT2(3400 | unittype)
Optional parameter you use to specify the unit type of the secondary output
data set. This parameter is valid only if:
v The VOLLIST2 parameter was specified.
v The DBDS for which the JCL is being generated was defined with the
NOREUSE option.
USERKEYS(%key1,'value' | %key2)
Optional parameter you use to set the value of keywords you have defined. Up
to 32 keywords can be specified.
%key1
User-defined keyword that is being assigned a value. The maximum length
of the keyword is eight characters, including the percent sign. The first
character after the percent sign must be alphabetic (A-Z). The remaining
characters must be alphanumeric (A-Z, 0-9).
'value'
Value assigned to the user-defined keyword when it is encountered. value
can be any character string enclosed in single quotes. The maximum length
of value is 132 characters (excluding the quotes). If value contains a quote,
use two single quotes. value can be a null string (''). If value is a time
stamp, it can be zero.
%key2
Any simple keyword that was previously assigned a value, including
DBRC-defined and user-defined keywords.

Any keyword can be assigned a value with the USERKEYS parameter.

However, if you assign a value to DBRC-defined keywords, the value is ignored.
DBRC-defined keywords are shown in “Understanding Simple Keywords” on
page 311.

If a keyword is assigned a value in both the USERKEYS and DEFAULTS

parameter, the value specified in USERKEYS is used.
VOLLIST(volser)
Optional parameter you use to specify the volumes on which the image copy
data set is to reside. This parameter is valid only if the DBDS for which the JCL
is being generated is defined with the NOREUSE option, and if the DBDS is
being used with DBDs, not with groups.
VOLLIST2(volser)
Optional parameter you use to specify the volumes on which the duplicate
image copy data set is to reside. This parameter is valid only if the DBDS for
which the JCL is being generated is defined with the NOREUSE option, and if
the DBDS is being used with DBDs, not with groups.

Examples of Running the Online Database Image Copy Utility

Here are some examples of using the GENJCL.OIC command.

Example Using JCLPDS Member OICJCL

In this example, a GENJCL.OIC command generates the JCL and control statements
required to run the Online Database Image Copy utility for the DBDS identified in
the DBD and DDN parameters. The database is defined as REUSE. If the
INIT.DBDS command for the DBDS for which the JCL is being generated is specified
with OICJCL(member), that member is used and is found in the data set identified
in the JCLPDS DD statement. If not, default skeletal member OICJCL from the

206 DBRC Guide & Reference

GENJCL.OIC
JCLPDS data set is used. Output from the generated JCL goes to the data set
defined in the JCLOUT DD statement. Skeletal member JOBJCL produces a job
statement.
//GENJOIC JOB
//JCLPDS DD . . .
//JCLOUT DD . . .
.
.
.

//SYSIN DD *
GENJCL.OIC DBD(DBDKSDS1) DDN(DDNKSDS1) -
PSB(MYJOB)
/*

Example Using JCLPDS Member OICJCL2

In this example, the GENJCL.OIC command generates JCL and control statements to
run the Online Image Copy utility for all DBDSs of GROUP1. The skeletal member
used is OICJCL2 from the data set identified in the OICPDS DD statement. One job
statement for each group member is generated from the JOBCARD member found
in the data set identified in the OICPDS DD statement. %DEFDBDS is a user-defined
value in OICJCL2 and is resolved with 'DATABASE DEFINED HERE'. Members
DEF1, DEF2, and DEF3 are used to resolve user-defined keywords in OICJCL2.
The default member for the database initialized in INIT.DBDS DEFLTJCL(MEMBER)
is not used to resolve keywords. The values specified in the USERKEYS parameter
for a keyword override the values found in the DEFAULTS member.
//GENJOIC1 JOB
//OICOUT DD . . .
//OICPDS DD . . .
//SYSIN DD *
GENJCL.OIC GROUP(GROUP1) JOB(JOBCARD) MEMBER(OICJCL2) -
NODEFLT JCLPDS(OICPDS) JCLOUT(OICOUT) PSB(PCBOIC6) -
USERKEYS((%DEFDBDS,'DATABASE DEFINED HERE')) -
DEFAULTS(DEF1,DEF2,DEF3)

GENJCL.RECEIVE
OO GENJCL.RECEIVE DBD(name) O
GROUP(name) , DDN(ddname)
AREA(name)
DEFAULTS( S member )

JOB NOLIST
O O
JCLOUT JCLPDS JOB(member) LIST
JCLOUT( ddname ) JCLPDS( ddname ) NOJOB

O OP
MEMBER(member) ,

USERKEYS( S ( %key1 , 'value' ) )

%key2

Use the GENJCL.RECEIVE command to apply an image copy from an RSR active site
to a database data set or area at an RSR tracking site. This command generates
the JCL and utility control statements required to run the database recovery utility
for image copy receive. If more than one image copy data set is registered in the

Chapter 11. GENJCL Commands 207

GENJCL.RECEIVE
RECON for a given DBDS or area, the most recent usable image copy data set is
received. A usable image copy is one that meets all of the following requirements:
v Is not flagged as being in error
v Was created by the IMS Batch Image Copy utility or the Database Image Copy 2
utility while the database was unavailable for update processing
v Was created after any updates were received at the tracking site

The GENJCL.RECEIVE command can only be used for RSR-covered databases. Also,
the local service group of the covering global service group must be a tracking
service group.

Important: For HALDB partitions, the GENJCL.RECEIVE command treats ILDS and
index data sets differently than data DBDSs. The GENJCL.RECEIVE command skips
these data sets in groups, regardless of whether the groups are explicit or implicit. If
you explicitly specify one of these data sets, the GENJCL.RECEIVE command fails.

For information about the IBM-supplied skeletal JCL execution member that is used
by GENJCL.RECEIVE, see “Using the Commands to Generate JCL and User-Defined
Output” on page 309.

Parameters
DBD(name) | GROUP(name)
Mutually exclusive, required parameters you use to specify the database that is
to be received.
DBD
Specifies the name of the database to be received. The database must be
RSR-covered.
For HALDBs (High Availability Large Databases), you can specify either a
HALDB master name or a HALDB partition name.
GROUP
Specifies that image copies for all DBDSs of a DBDS or CA group are to be
received. If GROUP is specified, the GENJCL.RECEIVE command executes
repeatedly, once for each DBDS of the DBDS or CA group. If you attempt
an implicit or explicit group execution with recoverable and nonrecoverable
DBDSs, JCL is not generated for the nonrecoverable DBDSs.
If GROUP is specified, all DBDS areas of the group must be covered by the
same global service group.
DEFAULTS (member)
Optional parameter you use to specify up to 10 names of skeletal JCL default
members that are to be used when generating JCL. Default members are
searched to resolve keywords in the order in which the members are specified
on this parameter.
If a keyword is assigned a value in both the DEFAULTS and the USERKEYS
parameters, the value specified in USERKEYS is used.
DDN(name) | AREA(name)
Mutually exclusive, optional parameters you use to identify the DBDS ddname
or DEDB area to be received.
The DDN or AREA parameter is specified only if the DBD parameter is
specified.

208 DBRC Guide & Reference

GENJCL.RECEIVE
For HALDBs, you must specify a partition database name with the DBD
parameter in order to use the DDN parameter. The DDN parameter value is the
partition DDN. The GENJCL.RECEIVE command is performed for the identified
DBDS of the partition. The GENJCL.RECEIVE command fails if DDN does not
identify a data DBDS in the partition.
If DDN or AREA is not specified, the GENJCL.RECEIVE command executes
repeatedly, once for each DBDS or area of the specified database. If you
specify a HALDB master name, the GENJCL.RECEIVE command is performed for
all data DBDSs for each HALDB partition in the HALDB master. If you specify a
HALDB partition name, the GENJCL.RECEIVE command is performed for all data
DBDSs of the identified partition.
JCLOUT (JCLOUT | ddname)
Optional parameter you use to specify the output data set for the generated
JCL. The data set is specified by ddname. A JCL DD statement with this
ddname must be included in the job step containing the GENJCL command. The
specified data set can be a member of a partitioned data set, but only if it is not
the same data set that is used for the default (JCLOUT).
JCLPDS (JCLPDS | ddname)
Optional parameter you use to specify the skeletal JCL data set that is to be
used for input when generating JCL. The data set is specified by ddname. A
JCL DD statement with this ddname must be included in the job step containing
the GENJCL command.
JOB | JOB(member) | NOJOB
Mutually exclusive, optional parameters you use to specify whether to produce
the job statement in the generated JCL.
JOB
Specifies that the job statement is to be produced. When JOB is specified
without a member name, the IBM-supplied execution member ICRCVJCL
produces the job statement. When JOB(member) is specified, the specified
execution member produces the job statement.
NOJOB
Specifies that the job statement is not to be produced in the generated JCL.
LIST | NOLIST
Mutually exclusive, optional parameters you use to specify whether to write the
generated JCL to the SYSPRINT data set.
LIST
Prints the generated JCL.
NOLIST
Suppresses printing of the generated JCL.
MEMBER(member)
Optional parameter you use to specify the name of the skeletal JCL execution
member that is to be used. For a description of the IBM-supplied execution
member, see “Using the Commands to Generate JCL and User-Defined Output”
on page 309. If this parameter is not specified, the default specified on the
INIT.DBDS command is used.
USERKEYS(%key1,'value' | %key2)
Optional parameter you use to set the value of keywords you have defined. Up
to 32 keywords can be specified.
%key1
User-defined keyword that is being assigned a value. The maximum length

Chapter 11. GENJCL Commands 209

GENJCL.RECEIVE
of the keyword is eight characters, including the percent sign. The first
character after the percent sign must be alphabetic (A-Z). The remaining
characters must be alphanumeric (A-Z, 0-9).
'value'
Value assigned to the user-defined keyword when it is encountered. value
can be any character string enclosed in single quotes. The maximum length
of value is 132 characters (excluding the quotes). If value contains a quote,
use two single quotes. value can be a null string (''). If value is a time
stamp, it can be zero.
%key2
Any simple keyword that was previously assigned a value, including
DBRC-defined and user-defined keywords.

Any keyword can be assigned a value with the USERKEYS parameter.

However, if you assign a value to DBRC-defined keywords, the value is ignored.
DBRC-defined keywords are shown in “Understanding Simple Keywords” on
page 311.

If a keyword is assigned a value in both the USERKEYS and DEFAULTS

parameter, the value specified in USERKEYS is used.

Examples of Running the Database Recovery Utility to Receive an

Image Copy
Here are some examples of using the GENJCL.RECEIVE command.

Example for the DBDS Identified by the DBD and DDN

Parameters
In this example, a GENJCL.RECEIVE command generates the JCL and control
statements that are required to run the database recovery utility to receive an image
copy for the DBDS that is identified in the DBD and DDN parameters.

If the INIT.DBDS command for the DBDS, for which the JCL is being generated, is
specified with RECVJCL(member), that member is used and is found in the data set
that is identified in the JCLPDS DD statement. If not, default skeletal member
RECVJCL, from the JCLPDS data set is used. Output from the generated JCL goes
to the data set that is identified in the JCLOUT DD statement. Skeletal member
JOBJCL produces a job statement.
//GENJRCVE JOB
//JCLPDS DD . . .
//JCLOUT DD . . .
.
.
.

//SYSIN DD *
GENJCL.RECEIVE DBD(DBESDSA) DDN(DDESDSA)
/*

Example for All DBDSs in a Group

In this example, the GENJCL.RECEIVE command generates JCL and control
statements to run the database recovery utility to receive image copies for all
DBDSs of GROUP1.

The skeletal member used is RCVJCL2 from the data set identified in the PDS DD
statement. Skeletal member JOBJCL produces a job statement for each member of
the group. %DEFDBD1 and %DEFDBD2 are user-defined values in member RCVJCL2,
which resolve to 'DEFINE DB1' and 'DEFINE DB2'. Default members DEF1, DEF2,

210 DBRC Guide & Reference

GENJCL.RECEIVE
and DEF3 are used to resolve user-defined keywords in RECJCL2. The default
member for the DBDS, if initialized in the INIT.DBDS DEFLTJCL(MEMBER)
command, is also used to resolve keywords. The values in the explicitly defined
DEFAULTS members override values in the predefined DEFLTJCL member. The
values specified in the USERKEYS parameter for a keyword override the values
found in the DEFAULTS members.
//GENJRCV1 JOB
//OUT DD . . .
//PDS DD . . .
//SYSIN DD *
GENJCL.RECEIVE GROUP(GROUP1) MEMBER(RCVJCL2) -
JCLPDS(PDS) JCLOUT(OUT) -
USERKEYS((%DEFDBD1,'DEFINE DB1'),(%DEFDBD2,'DEFINE DB2')) -
DEFAULTS(DEF1,DEF2,DEF3)

GENJCL.RECOV
OO GENJCL.RECOV DBD(name) O
GROUP(name) , DDN(ddname)
AREA(name)
DEFAULTS( S member )

JOB NOLIST
O O
JCLOUT JCLPDS JOB(member) LIST
JCLOUT( ddname ) JCLPDS( ddname ) NOJOB

MULTIJOB
O O
MEMBER(member) ONEJOB NODEFLT RCVTIME(timestamp) RESTORE

USEIC
O OP
USEDBDS ,
USEAREA
USERKEYS( S ( %key1 , 'value' ) )
%key2

Use the GENJCL.RECOV command to generate the JCL and utility control statements
required to run the database recovery utility. You can request the JCL and utility
control statements for a full recovery or a timestamp recovery of a specified DBDS
or area. All log data must be archived; otherwise the GENJCL.RECOV command fails.

Restriction: A nonstandard image copy data set cannot be used as input to the
database recovery utility. The procedure for recovering a database with a
nonstandard image copy is slightly different depending on whether the IMS system
is an active or tracking subsystem.
Active subsystem
1. Restore the DBDS from the nonstandard image copy.
2. Record this restoration by entering a NOTIFY.RECOV command with the
image copy run time as the RCVTIME parameter.
3. Complete the recovery, applying changes made since the image copy,
by entering a GENJCL.RECOV command with the USEDBDS parameter.
Tracking subsystem

Chapter 11. GENJCL Commands 211

GENJCL.RECOV
1. Restore the DBDS from the nonstandard image copy. This must be the
latest recorded image copy.
2. Record this restoration by entering a NOTIFY.RECOV command with the
image copy run time as the RUNTIME parameter and the USID from
the image copy as the RUNUSID parameter.
3. Issue a /START command for the database. Online forward recovery
(OFR) automatically completes, applying changes made since the
image copy.

For information about the IBM-supplied skeletal JCL execution member used by
GENJCL.RECOV, see “Using the Commands to Generate JCL and User-Defined
Output” on page 309.

Use the RESTORE parameter to recover DBDSs that were designated as

nonrecoverable.

Important: For HALDB partitions, the GENJCL.RECOV command treats ILDS and
index data sets differently than data DBDSs. The GENJCL.RECOV command skips
these data sets in groups, regardless of whether the groups are explicit or implicit. If
you explicitly specify one of these data sets, the GENJCL.RECOV command fails.

Restriction: The GENJCL.RECOV command does not support ILDS and index data
sets. To generate JCL for the HALDB Index/ILDS Rebuild Utility (DFSPREC0), use
the GENJCL.USER command. See “Sample JCL for HALDB INDEX/ILDS Rebuild
Utility (DSPUPJCL)” on page 364 for information about IBM-supplied sample JCL
that you can use.

Parameters
DBD(name) | GROUP(name)
Mutually exclusive, required parameters you use to specify the DBDSs that are
to be recovered.
DBD
Specifies the database name of the DBDSs to be recovered.
For HALDBs, you can specify either a HALDB master name or a HALDB
partition name.
GROUP
Specifies that all DBDSs of a DBDS or CA group are to be recovered. If
GROUP is specified, the GENJCL.RECOV command executes repeatedly for
each DBDS of the DBDS or CA group. If you attempt an implicit or explicit
group execution with recoverable and nonrecoverable DBDSs (and
RESTORE is not specified), JCL is not generated for the nonrecoverable
DBDSs.
DEFAULTS (member)
Optional parameter you use to specify up to 10 names of skeletal JCL default
members to be used when generating JCL. Default members are searched to
resolve keywords in the order in which the members are specified on this
parameter.
If a keyword is assigned a value in both the DEFAULTS and the USERKEYS
parameters, the value specified in USERKEYS is used.
DDN(name) | AREA(name)
Mutually exclusive, optional parameters you use to identify the DBDS ddname
or DEDB area to be recovered.

212 DBRC Guide & Reference

GENJCL.RECOV
The DDN or AREA parameter is specified only if the DBD parameter is
specified.
For HALDBs, you must specify a partition database name with the DBD
parameter in order to use the DDN parameter. The DDN parameter value is the
partition DDN. The GENJCL.RECOV command is performed for the identified
DBDS of the partition. The GENJCL.RECOV command fails if DDN does not
identify a data DBDS in the partition.
If DDN or AREA is not specified, the GENJCL.RECOV command executes
repeatedly for each DBDS or area of the specified database. If you specify a
HALDB master name, the GENJCL.RECOV command is performed for all data
DBDSs for each HALDB partition in the HALDB master. If you specify a HALDB
partition name, the GENJCL.RECOV command is performed for all data DBDSs of
the identified partition.
JCLOUT (JCLOUT | ddname)
Optional parameter you use to specify the output data set for the generated
JCL. The data set is specified by ddname. A JCL DD statement with this
ddname must be included in the job step containing the GENJCL command. The
specified data set can be a member of a partitioned data set, but only if it is not
the same data set used for the default (JCLOUT).
JCLPDS (JCLPDS | ddname)
Optional parameter you use to specify the skeletal JCL data set that is to be
used for input when generating JCL. The data set is specified by ddname. A
JCL DD statement with this ddname must be included in the job step containing
the GENJCL command.
JOB | JOB(member) | NOJOB
Mutually exclusive, optional parameters you use to specify whether to produce
the job statement in the generated JCL.
JOB
Specifies that the job statement is to be produced. When JOB is specified
without a member name, the IBM-supplied execution member JOBJCL
produces the job statement. When JOB(member) is specified, the specified
execution member produces the job statement.
NOJOB
Specifies that the job statement is not to be produced in the generated JCL.
LIST | NOLIST
Mutually exclusive, optional parameters you use to specify whether to write the
generated JCL to the SYSPRINT data set.
LIST
Prints the generated JCL.
NOLIST
Suppresses printing of the generated JCL.
MEMBER(member)
Optional parameter you use to specify the name of the skeletal JCL execution
member to be used. For a description of the IBM-supplied execution member,
see “Using the Commands to Generate JCL and User-Defined Output” on
page 309. If this parameter is not specified, the default specified on the
INIT.DBDS command is used.

Chapter 11. GENJCL Commands 213

GENJCL.RECOV
MULTIJOB | ONEJOB
Mutually exclusive, optional parameters you use to control how many JOB
statements are generated when a DBDS group is specified either explicitly or
implicitly.
MULTIJOB
Processes the skeletal JCL JOB member for each group member (multiple
JOB statements are produced).
ONEJOB
Processes the skeletal JCL JOB member only for the first group member.

These parameters are invalid if NOJOB is specified or a DBDS group is not

specified.
NODEFLT
Optional parameter you use to specify that the implicit skeletal JCL default
member, if any, for the DBDS is not to be used.
RCVTIME(timestamp)
Optional parameter you use to specify a time stamp recovery, which is a partial
recovery of a DBDS or area to a point in time earlier than its most recent state.
If you omit this parameter, you are requesting a full recovery to the most recent
state.
A valid time stamp for a partial recovery is any point at which there are no
allocations of the DBDS or area and there is not a merge of logs needed that
cannot be resolved by running the change accumulation utility.
Attention: An allocation that has no de-allocation time recorded persists until
the stop time of the current log.
Related Reading:
v See “Using the %SET TIMEFMT Keyword” on page 318 for more information
on full recovery.
v See IMS Version 7 Operations Guide for more information on time stamp
recovery.
RESTORE
Optional parameter used to generate JCL for a database data set that is
designated as nonrecoverable. If the last image copy was taken before the
DBDS was designated as nonrecoverable, normal recovery JCL is generated to
recover the DBDS up to the point of the recovery-status change. If the last
image copy was taken after the DBDS was designated as nonrecoverable, the
generated JCL uses only the image copy for recovery.
If you attempt an implicit or explicit group execution with recoverable and
nonrecoverable DBDSs (and RESTORE is specified), JCL is generated only for
the nonrecoverable DBDSs.
Do not specify RESTORE for a recoverable DBDS.
USEIC | USEDBDS | USEAREA
Mutually exclusive, optional parameters you use to specify the starting point of
the requested recovery action.
USEIC
Starts the recovery with an image copy data set. You can then apply
subsequent changes that occurred in the DBDS.
USEIC is the default.

214 DBRC Guide & Reference

GENJCL.RECOV
USEDBDS
Recovery is performed using only the changes that have occurred to the
DBDS in its current state. An image copy data set is not used as input to
this recovery. You can specify the USEDBDS parameter only if you also
specify the DBDS parameter, and only after performing a timestamp
recovery in which an image copy data set is used as input.
USEAREA
Recovery is performed using only the changes that have occurred to the
DEDB area in its current state. An image copy data set is not used as input
to this recovery. You can specify USEAREA only if you also specify the
AREA parameter, and only after performing a timestamp recovery in which
an image copy data set is used as input.

You can use these parameters to recover a DBDS or area to a specified time
stamp using an image copy data set and then apply the changes that have
occurred since the image copy by specifying an additional recovery using the
USEDBDS or USEAREA parameter.

Restriction: If this required time stamp recovery restored the DBDS or DEDB
area to a time that falls within an existing time stamp recovery’s range (the time
between the RECOV TO and RUN times), then the USEDBDS or USEAREA
parameter is invalid.
USERKEYS(%key1,'value' | %key2)
Optional parameter you use to set the value of keywords you have defined. Up
to 32 keywords can be specified.
%key1
User-defined keyword that is being assigned a value. The maximum length
of the keyword is eight characters, including the percent sign. The first
character after the percent sign must be alphabetic (A-Z). The remaining
characters must be alphanumeric (A-Z, 0-9).
'value'
Value assigned to the user-defined keyword when it is encountered. value
can be any character string enclosed in single quotes. The maximum length
of value is 132 characters (excluding the quotes). If value contains a quote,
use two single quotes. value can be a null string (''). If value is a time
stamp, it can be zero.
%key2
Any simple keyword that was previously assigned a value, including
DBRC-defined and user-defined keywords.

Any keyword can be assigned a value with the USERKEYS parameter.

However, if you assign a value to DBRC-defined keywords, the value is ignored.
DBRC-defined keywords are shown in “Understanding Simple Keywords” on
page 311.

If a keyword is assigned a value in both the USERKEYS and DEFAULTS

parameter, the value specified in USERKEYS is used.

Examples of Running the Database Recovery Utility

Here are some examples of using the GENJCL.RECOV command.

Chapter 11. GENJCL Commands 215

GENJCL.RECOV
Example for the DBDS Identified in the DBD and DDN Parameters
In this example, a GENJCL.RECOV command generates the JCL and control
statements required to run the database recovery utility for the DBDS identified in
the DBD and DDN parameters. The USEIC parameter indicates that the time stamp
recovery starts with an image copy data set and ends with the log data set that has
the stop time stamp specified in the RCVTIME parameter.

If the INIT.DBDS command for the DBDS for which the JCL is being generated is
specified with RECOVJCL(member), that member is used and is found in the data
set identified in the JCLPDS DD statement. If not, default skeletal member
RECOVJCL from the JCLPDS data set is used. Output from the generated JCL
goes to the data set identified in the JCLOUT DD statement. Skeletal member
JOBJCL produces a job statement.
//GENJRCOV JOB
//JCLPDS DD . . .
//JCLOUT DD . . .
.
.
.

//SYSIN DD *
GENJCL.RECOV DBD(DBESDSA) DDN(DDESDSA) USEIC -
RCVTIME(821001212130)
/*

Example for All DBDSs in a Group

In this example, the GENJCL.RECOV command generates JCL and control statements
to run the database recovery utility for all DBDSs of GROUP1. The skeletal member
that is used is RECJCL2 from the data set identified in the PDS DD statement.

Skeletal member JOBJCL produces a job statement for each member of the group.
%DEFDBD1 and %DEFDBD2 are user-defined values in member RECJCL2 which resolve
to 'DEFINE DB1' and 'DEFINE DB2'. Default members DEF1, DEF2, and DEF3 are
used to resolve user-defined keywords in RECJCL2. The default member for the
DBDS, if initialized in the INIT.DBDS DEFLTJCL(MEMBER)command, is also used to
resolve keywords. The values in the explicitly defined DEFAULTS members override
values in the predefined DEFLTJCL member. The values specified in the
USERKEYS parameter for a keyword override the values found in the DEFAULTS
members.
//GENJRCV1 JOB
//OUT DD . . .
//PDS DD . . .
//SYSIN DD *
GENJCL.RECOV GROUP(GROUP1) MEMBER(RECJCL2) -
JCLPDS(PDS) JCLOUT(OUT) -
USERKEYS((%DEFDBD1,'DEFINE DB1'),(%DEFDBD2,'DEFINE DB2')) -
DEFAULTS(DEF1,DEF2,DEF3)

GENJCL.USER
OO GENJCL.USER MEMBER(name) O
DBD(name) DDN(ddname)
GROUP(name)

216 DBRC Guide & Reference

GENJCL.USER
O O
, JCLOUT JCLPDS
JCLOUT( ddname ) JCLPDS( ddname )
DEFAULTS( S member )

JOB NOLIST MULTIJOB

O O
JOB(member) LIST ONEJOB NODEFLT PSB(name)
NOJOB

O O
SSID(name) TIMEFMT(sublist)

O OP
,

USERKEYS( S ( %key1 , 'value' ) )

%key2

Use the GENJCL.USER command to generate JCL or any kind of user output. You
must provide the skeletal JCL execution member that is needed for the GENJCL.USER
command. For more information, see “Using the Commands to Generate JCL and
User-Defined Output” on page 309.

Parameters
MEMBER(name)
Required parameter you use to specify the name of the skeletal JCL execution
member that is used to generate output. You must have already supplied the
execution member.
The name can be any valid member name for a partitioned data set. If the
specified member does not exist in the skeletal JCL data set, the command
fails.
DBD(name) | GROUP(name)
Mutually exclusive, optional parameters you use to set the value of the %dbname
keyword.
DBD
If you specify DBD without the DDN parameter, the GENJCL.USER command
executes repeatedly for each DBDS or the specified database. For
HALDBs, you can use this parameter to set the value of the %dbname
keyword to be either a HALDB master name or a HALDB partition name. If
you use a HALDB master name, the GENJCL.USER command is performed
for all data DBDSs for each HALDB partition in the HALDB master. If you
use a HALDB partition name, the GENJCL.USER command is performed for
all DBDSs of the identified partition.
GROUP
If you specify GROUP, the GENJCL.USER command executes repeatedly,
once for each DBDS of the specified DBDS group. For each repeated
execution, the DBD and DDN parameters are set to the corresponding
group member.

Chapter 11. GENJCL Commands 217

GENJCL.USER
If you specify neither DBD nor GROUP, the value of the %dbname keyword is null
unless a value is assigned in the USERKEYS parameter or a skeletal JCL
default member.
DDN(name)
Optional parameter you use to set the value of the %ddname keyword. If you do
not specify DDN, the value of the %ddname keyword is null unless a value is
assigned in the USERKEYS parameter or a skeletal JCL default member.
For HALDBs, you must specify a partition database name with the DBD
parameter in order to use the DDN parameter. In this case, the DDN is the
partition DDN. The GENJCL.USER command is performed for the identified DBDS
of the partition. The GENJCL.USER command fails if DDN does not identify a
DBDS in the partition.
You cannot specify DDN if you also specify GROUP.
DEFAULTS(member)
Optional parameter you use to specify up to 10 names of skeletal JCL default
members to be used when generating JCL or other user-defined output. Default
members are searched to resolve keywords in the order in which the members
are specified on this parameter.
If a keyword is assigned a value in both the DEFAULTS and USERKEYS
parameters, the value specified in USERKEYS is used.
JCLOUT(JCLOUT | ddname)
Optional parameter you use to specify the output data set for the generated
JCL or other user-defined output. The data set is specified by ddname. A JCL
DD statement with this ddname must be included in the job step containing the
GENJCL.USER command. The specified data set can be a member of a
partitioned data set, but only if it is not the same data set that is used for the
default (JCLOUT).
JCLPDS(JCLPDS | ddname)
Optional parameter you use to specify the skeletal JCL data set that is to be
used for input when generating the JCL or other user-defined output. The data
set is specified by ddname. A JCL DD statement with this ddname must be
included in the job step containing the GENJCL.USER command.
JOB | JOB(member) | NOJOB
Mutually exclusive, optional parameters you use to specify whether to produce
the job statement in the generated JCL.
JOB
Specifies that the job statement is to be produced. When JOB is specified
without a member name, the IBM-supplied execution member JOBJCL
produces the job statement. When JOB(member) is specified, the specified
execution member produces the job statement.
NOJOB
Specifies that the job statement is not to be produced in the generated JCL.
LIST | NOLIST
Mutually exclusive, optional parameters you use to specify whether to write the
generated JCL to the SYSPRINT data set.
LIST
Prints the generated JCL.
NOLIST
Suppresses printing of the generated JCL.

218 DBRC Guide & Reference

GENJCL.USER
MULTIJOB | ONEJOB
Mutually exclusive, optional parameters you use to control how many JOB
statements are generated when a DBDS group is specified either explicitly or
implicitly.
MULTIJOB
Processes the skeletal JCL JOB member for each group member (multiple
JOB statements are produced).
ONEJOB
Only processes the skeletal JCL JOB member for the first group member.

These parameters are invalid if NOJOB is specified or if a DBDS group is not

specified.
NODEFLT
Optional parameter you use to specify that the implicit skeletal JCL default
member, if any, for the DBDS is not to be used. If you do not specify GROUP
or DBD, this parameter is ignored.
PSB(name)
Optional parameter you use to set the value of the %PSB keyword.
name can be any character string. It does not need to be an actual PSB
ddname. The maximum length of the name is eight characters.
If you do not specify PSB, the value of the %PSB keyword is null unless a value
is assigned in the USERKEYS parameter or a skeletal JCL default member.
TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear in
user-defined output. This specification overrides both the GENJCL default values
and any values set on %SET statements in the input skeletal JCL.
The default for the GENJCL output time format is compressed, with a two-digit
year, and the offset in numeric form: 960021315001 +0700. If you want the
output time stamps to appear without offsets, for example, you can override the
default with TIMEFMT(,N).
The override is good only for the duration of a single GENJCL command.
Related Reading:
v The TIMEFMT parameter sublist format is described in “TIMEFMT Parameter
Sublist” on page 102.
v See “TIMEFMT Subparameter Order of Precedence” on page 104 for
information on the precedence of the subparameters.
v See “Standard Time Stamp Format” on page 101 for examples of the
different output forms.
SSID(name)
Optional parameter used to set the value of the %SSID keyword.
name can be any character string. It does not need to be an actual IMS
subsystem ID. The maximum length of the name is eight characters.
If the SSID parameter is not specified, the value of the %SSID keyword is null,
unless a value is assigned in the USERKEYS parameter or a skeletal JCL
default member.
USERKEYS(%key1,'value' | %key2)
Optional parameter you use to set the value of keywords you have defined. Up
to 32 keywords can be specified.

Chapter 11. GENJCL Commands 219

GENJCL.USER
%key1
User-defined keyword being assigned a value. The maximum length of the
keyword is eight characters, including the percent sign. The first character
after the percent sign must be alphabetic (A-Z). The remaining characters
must be alphanumeric (A-Z, 0-9).
'value'
Value assigned to the user-defined keyword when it is encountered. value
can be any character string enclosed in single quotes. The maximum length
of value is 132 characters (excluding the quotes). If value contains a quote,
use two single quotes. value can be a null string (''). If value is a time
stamp, it can be zero.
%key2
Any simple keyword that was previously assigned a value, including
DBRC-defined and user-defined keywords.

Any keyword can be assigned a value with the USERKEYS parameter.

However, if you assign a value to DBRC-defined keywords, the value is ignored.
DBRC-defined keywords are shown in “Understanding Simple Keywords” on
page 311.

If a keyword is assigned a value in both the USERKEYS and DEFAULTS

parameter, the value specified in USERKEYS is used.

Example of Running DBRC

In this example, the GENJCL.USER command generates JCL from member USER4 in
the data set that is identified in DD statement MYJCLPDS. Output from the
generated JCL goes to the data set identified in DD statement JCLOUT.
Substitutions for %SSID, %DBNAME and %DDNAME should be made. Skeletal member
JOBJCL produces a job statement.
//GENUSER JOB
//JCLOUT DD
//MYJCLPDS DD
//SYSIN DD *
GENJCL.USER MEMBER(USER4) JCLPDS(MYJCLPDS) DBD(DHONTZ04) -
SSID(IMSA) DDN(HIDAM)

The following example shows the member USER4 that is to be executed:

/ ADD LIST=ALL,NAME=USER4,LEVEL=01,SOURCE=0
/ NUMBER NEW1=00000100,INCR=100
//*******************************************************
//* MEMBER NAME = USER4 *
//* (SSID) SHOULD BE SUBSTITUTED IN LIST.SUBSYS COMMAND *
//* (DBNAME) SHOULD BE SUBSTITUTED IN LIST.DBDS COMMAND *
//* (DDNAME) SHOULD BE SUBSTITUTED IN LIST.DBDS COMMAND *
//*******************************************************
//USER4 EXEC PGM=DSPURX00
//SYSPRINT DD SYSOUT=A
//SYSIN DD *
LIST.SUBSYS SSID(%SSID) /* (SSID) SHOULD BE SUBSTITUTED */
LIST.DBDS DBD(%DBNAME) DDN(%DDNAME) -
/* (DBNAME) and (DDNAME) SHOULD BE SUBSTITUTED */
/*

220 DBRC Guide & Reference

Chapter 12. INIT Commands
INIT.ADS
UNAVAIL
OO INIT.ADS ADDN(name) ADSN(name) AREA(name) DBD(name) OP
AVAIL

Use an INIT.ADS command to create an entry in RECON that defines an ADS (area
data set) that belongs to an area. An area can consist of a maximum of seven data
sets.

Before you issue the INIT.ADS command, you must create the area and database
records in RECON. If the ADDN or ADSN names are not unique for this area, the
INIT.ADS command fails. In addition, the INIT.ADS command fails if the specified
area is not registered in RECON.

When you register the area with an INIT.DBDS command, the area status is set as
“recovery needed” to prevent inadvertent use by the IMS online system before you
have completed registration of the required ADSs. You can create the ADS records
in RECON, but only if you use the INIT.ADS command with the default UNAVAIL
parameter. You must to first issue a CHANGE.DBDS command for the area, specifying
the NORECOV option to make the status of the ADS immediately available (with
INIT.ADS with the AVAIL parameter).

Parameters
ADDN(name)
Required parameter you use to identify the ADS that is being identified to
DBRC by its ddname.
ADSN(name)
Required parameter you use to identify the ADS that is being identified to
DBRC by its data set name.
AREA(name)
Required parameter you use to identify the area name for which an ADS is
being identified to DBRC.
DBD(name)
Required parameter you use to identify that area by database name for which
an ADS is being identified to DBRC.
AVAIL | UNAVAIL
Mutually exclusive, optional parameters you use to indicate whether the ADS
record is available.
AVAIL
Makes the ADS status available. The INIT.ADS AVAIL command fails if you
issue it when the area is in use or if the area needs to be recovered.
UNAVAIL
Makes the ADS status unavailable.

© Copyright IBM Corp. 1974, 2001 221

INIT.ADS
Example of Creating a Record That Defines an ADS
In this example, a record is created in RECON that identifies an ADS.
//INITADS JOB
.
.
.

//SYSIN DD *
INIT.ADS DBD(DBD03) AREA(AREA03) -
ADDN(AREADDN1) ADSN(AREADSN2)
/*

INIT.CA
,

OO INIT.CA CADSN(name) GRPNAME(name) VOLLIST( S volser ) O

O OP
1 3400
FILESEQ( value ) UNIT( unittype )

Use an INIT.CA command to create a record in RECON that identifies a change

accumulation data set that is available for future use by the Change Accumulation
utility in processing the specified CA group. You can create such change
accumulation records only for those CA groups that have been defined with the
REUSE option of the INIT.CAGRP command. You can create change accumulation
records in RECON up to the number specified in the GRPMAX parameter of the
INIT.CAGRP command that you used to define the CA group.

Parameters
CADSN(name)
Required parameter you use to specify the name of the change accumulation
data set for which you are creating a record in RECON. The name you
substitute in the variable field can be up to 44 characters. You can use the
default naming convention for change accumulation data sets to assign this
name.
GRPNAME(name)
Required parameter you use to specify the name of the CA group for which you
are creating the record. The GRPNAME keyword must specify the name of a
CA group that is already defined in RECON.
VOLLIST(volser)
Required parameter you use to specify the volume serial numbers of the
volumes on which the change accumulation data set being defined are to
reside. You can substitute from 1 to 255 volume serial numbers in the variable
field; each can be up to six alphanumeric characters long, and they must follow
MVS JCL conventions for volume serial numbers.
FILESEQ(1 | value)
Optional parameter you use to specify the file-sequence number of the change
accumulation data set that is being defined.
value must be a decimal number from 1 to 9999.

222 DBRC Guide & Reference

INIT.CA
UNIT(3400 | unittype)
Optional parameter you use to specify the unit type of the volumes on which the
change accumulation data sets are to reside. The unit type can be up to eight
alphanumeric characters.

Example of Creating a Record That Defines a CA Data Set

In this example, a record is created in RECON that identifies a change
accumulation data set (identified by the CADSN parameter). This change
accumulation data set is being created for use by a subsequent run of the Change
Accumulation utility for the CA group identified in the GRPNAME parameter.
Creation of this record implies that the identified CA group was defined with a
REUSE parameter.
//INITCA JOB
.
.
.

//SYSIN DD *
INIT.CA GRPNAME(CAGRP1) -
CADSN(IMS.CAGRP1.CA.CA001) -
VOLLIST(VOL001) FILESEQ(4)
/*

INIT.CAGRP
,

OO INIT.CAGRP GRPMAX(value) GRPMEM( S (dbdname,ddname) ) GRPNAME(name) O

NOREUSE
O OP
CAJCL DEFLTJCL( DEFLTJCL ) REUSE
CAJCL( member ) member

Use an INIT.CAGRP command to specify the DBDSs that are to belong to a

specified CA group. You must have created a record in RECON with an INIT.DBDS
command for each DBDS in the CA group before you assign it to a CA group. Each
DBDS can belong to only one CA group.

Restriction: Index and ILDS DBDSs are not recoverable, and changes to them
are not logged. The INIT.CAGRP command does not support these data sets.

Parameters
GRPMAX(value)
Required parameter you use to specify the maximum number of change
accumulation data sets that DBRC is to maintain for the specified CA group.
value must be a decimal number from 2 to 1024.
When the number of times you run the Change Accumulation utility for the
specified group exceeds the GRPMAX value, the record of the earliest change
accumulation run for the group is deleted if you specify the NOREUSE keyword
for this CA group. The record of the earliest change accumulation run is reused
if you specify the REUSE keyword for this CA group.

Chapter 12. INIT Commands 223

INIT.CAGRP
GRPMEM(dbdname,ddname)
Required parameter you use to specify the names of the DBDSs that are to be
members of the CA group you are defining.
There can be from 1 to 2000 members in a CA group. The names you
substitute in the variable field must be pairs of names enclosed in parentheses,
where dbdname is the database name of the DBDS, and ddname is its data set
ddname.
GRPNAME(name)
Required parameter you use to specify the name of the CA group being
created. name can be up to eight alphanumeric characters, and it must not be
the same as the name of a CA group that already exists in RECON.
CAJCL(CAJCL | member)
Optional parameter you use to specify the name of a member of a partitioned
data set of skeletal JCL. You create this member to be used to generate the
JCL required to run the Change Accumulation utility for the CA group being
created.
DEFLTJCL(DEFLTJCL | member)
Optional parameter you use to specify an implicit skeletal JCL default member
for the CA group. The specified member is used by the GENJCL.CA command to
resolve keywords you have defined.
NOREUSE | REUSE
Mutually exclusive, optional parameters you use to specify whether the change
accumulation data sets for the CA group being defined can be reused.
REUSE
Indicates that the Change Accumulation utility is to reuse the oldest change
accumulation data set and record (for the group being defined) when the
GRPMAX value for the group is exceeded. Reuse means that the Change
Accumulation utility uses the same physical space, volumes, data set name,
and record in RECON for the new change accumulation data set as were
used for the oldest change accumulation data set in the group.
NOREUSE
Indicates that the change accumulation data sets in this group are not to be
reused by the Change Accumulation utility.

Example of Creating a CA Group

In this example, a CA group is being created. A maximum of 15 change
accumulation data sets are to be maintained for this group. (This is indicated in the
GRPMAX parameter.) The NOREUSE parameter indicates that change
accumulation data sets for this group are not to be reused by the Change
Accumulation utility when the GRPMAX value has been reached. That parameter
also implies that empty change accumulation data sets cannot be defined for this
group for use in future runs of the Change Accumulation utility.
//INITCAGP JOB
.
.
.

//SYSIN DD *
INIT.CAGRP GRPNAME(CAGRP1) GRPMAX(15) NOREUSE -
GRPMEM((DB1,DD1) (DB2,DD2) (DB3,DD3) -
(DB4,DD4) (DB5,DD5) (DB6,DD6) (DB7,DD7) -
(DB8,DD8) (DB9,DD9) (DB10,DD10))
/*

224 DBRC Guide & Reference

INIT.DB

INIT.DB
RECOVABL 0 TYPEIMS
OO INIT.DB DBD(name) SHARELVL( 1 ) O
NONRECOV 2 TYPEFP
3
TYPHALDB

DBTRACK
O OP
GSGNAME(gsgname) RCVTRACK PARTSEL(pgmname)

| Use an INIT.DB command to register a database with DBRC and specify the level
| of database sharing. A database must be registered with DBRC before you can
| initialize a new DBDS, HALDB partition, or DEDB area with the INIT.DBDS
| command or INIT.PART.

| When registering a TYPHALDB, the IMS DBDLIB data set must be identified in the
| job stream for the Recovery Control utility with a ddname of IMS.

| Restriction for HALDBs: You must use the HALDB Partition Definition utility to
| update or delete information about HALDBs in the RECON data set. The IMS
| DBDLIB data set must be identified in the job stream for the RECOVERY Control
| utility with a ddname of IMS.

Parameters
DBD(name)
Required parameter you use to specify the database name of the database to
be registered in RECON.
DBTRACK | RCVTRACK
Mutually exclusive, optional parameters that specify the type of tracking
(shadowing) for a database that is assigned to a global service group.
Restrictions:
v Neither RCVTRACK nor DBTRACK can be specified without GSGNAME.
v Neither RCVTRACK nor DBTRACK can be specified if a TYPEFP is
specified.
v Specifying DBTRACK has no effect if the tracking subsystem is a recovery
readiness level (RLT) subsystem.
DBTRACK
Indicates database readiness tracking.
RCVTRACK
Indicates recovery readiness tracking.
GSGNAME(gsgname)
Optional parameter used to specify to which global service group a database is
to be assigned.
GSGNAME cannot be specified if TYPEFP is specified.
NONRECOV | RECOVABL
Mutually exclusive, optional parameters used to specify whether DBRC can

Chapter 12. INIT Commands 225

INIT.DB
record the updates in the RECON for the data sets of the specified databases.
These parameters are meaningful for TYPEIMS databases only, and they are
rejected for TYPEFP databases.
If the database is registered as RECOVABL, VIO data sets cannot be used for
the output log (IEFRDER) in any job that updates the database. Temporary log
data sets, such as VIO data sets, are deleted at job termination, so they are not
usable for recovery.
NONRECOV
Specifies that no record of the updates for the data sets of the specified
database are to be kept in the RECON.
RECOVABL
Specifies that the update allocations on the database are to be written in
the RECON.

Restrictions:
v NONRECOV cannot be specified if GSGNAME is specified.
v Fast Path DEDBs are never registered as nonrecoverable.
v You cannot make concurrent image copies of nonrecoverable databases.
| PARTSEL (pgname)
| Optional parameter that identifies a user Partition Selection Exit program name
| for TYPHALDB. Specified as a value up to 8 characters long that is a valid
| program name. If not specified, the Partition Selection Exit name is obtained
| from the DBD (if one was specified).
SHARELVL(0 | 1 | 2 | 3)
Optional parameter you use to specify the level of data sharing for which
authorized subsystems can share a database. For a description of the levels of
data sharing, see “Assigning a Sharing Level with DBRC” on page 20.
Restriction:
v You must specify a SHARELVL of 1, 2, or 3 for concurrent image copies.
v If you are using IRLM, and have specified SHARELVL 2 or 3, ensure that the
VSAM SHAREOPTIONS (3 3) parameter is also specified.
For more information on coordinating VSAM data set definitions with share
options, see IMS Version 7 Administration Guide: System.
| TYPEFP | TYPEIMS | TYPEHALDB
| Mutually exclusive, optional parameters you use to specify whether the
| database is a Fast Path DEDB or a HALDB.
| TYPEFP
| Specifies that the database is Fast Path DEDB.
| TYPEIMS
| Specifies that the database is a DL/I database (non-HALDB).
| TYPEHALDB
| Specifies that the database is a DL/I database (HALDB).

| Example of Creating a SHARELVL 1 DB Record

In this example, a new database record is created in RECON. This database has a
share level of 1.

226 DBRC Guide & Reference

INIT.DB
//INITDB JOB
.
.
.

//SYSIN DD *
INIT.DB DBD(THISDB) SHARELVL(1) TYPEFP
/*

INIT.DBDS

DBTRACK
OO INIT.DBDS DBD(name) DDN(name) DSN(name) GENMAX(value) O
AREA(name) RCVTRACK DEFLTJCL(member)

NOREUSE NOPREO
O O
GSGNAME(gsgname) ICJCL REUSE OICJCL PREOPEN
ICJCL( member ) OICJCL( member )
O O
RECOVJCL 0 RECVJCL
RECOVJCL( member ) RECOVPD( value ) RECVJCL( member )

NOVSO
O OP
NOLKASID NOPREL
VSO
CFSTR1(name) CFSTR2(name) LKASID PRELOAD

Use an INIT.DBDS command to register a DBDS or DEDB area. The DBDS must
exist for any of the other commands to work for a given DBDS or DEDB area. In
order to register the DBDS, DBRC examines the IMS DBDLIB data set to:
v Verify that the DBDS or DEDB area exists.
v Obtain the DBDS’s data set identifier (DSID), its data set organization, and its
database organization.
The IMS DBDLIB data set must be identified in the job stream for the Recovery
Control utility with a ddname of IMS.

The INIT.DBDS command fails if you issue it while the database is in use.

After registering the database data set, use the Image Copy utility to create a
backup copy.

| Restriction for HALDBs: You must use the HALDB Partition Definition utility to
| update or delete information about HALDBs in the RECON data set. You cannot
| use the INIT.DBDS command to register DBDSs of HALDBs.

Parameters
DBD(name)
Required parameter you use to specify the database name of the DBDS or
DEDB area being identified to DBRC.
DDN(name) | AREA(name)
Mutually exclusive, required parameters you use to specify the ddname of the
DBDS or DEDB area being identified to DBRC.

Chapter 12. INIT Commands 227

INIT.DBDS
DSN(name)
Required parameter you use with the DDN(name) parameter to specify the data
set name of the DBDS being identified to DBRC. You cannot use this parameter
with a DEDB area.
If the DBDS is an ADS that is registered to DBRC, do not specify this
parameter. Instead specify the data set name in the INIT.ADS command.
GENMAX(value)
Required parameter you use to specify the maximum number of image copies
that DBRC is to maintain for the identified DBDS.
Each time you run the Database Image Copy utility for the DBDS that is being
initiated, a new image copy is defined in RECON. If you identified the DBDS
with the NOREUSE parameter, the oldest image copy for the DBDS beyond the
recovery period is deleted when the number of image copies exceeds the
GENMAX value. If you identify the DBDS with the REUSE parameter, the oldest
image copy beyond the recovery period is reused.
value must be a decimal number from 2 to 255.
DBTRACK | RCVTRACK
Mutually exclusive, optional parameters you use to specify the type of RSR
tracking (shadowing) for an area that is assigned to a global service group.
Neither RCVTRACK nor DBTRACK can be specified without GSGNAME and
AREA.
Specifying DBTRACK has no effect if the tracking subsystem is a
recovery-readiness level (RLT) subsystem.
DBTRACK
Indicates database-readiness tracking.
RCVTRACK
Indicates recovery-readiness tracking.
DEFLTJCL(member)
Optional parameter you use to specify an implicit skeletal JCL default member
for the DBDS. The specified member is used by the GENJCL.IC, GENJCL.OIC,
and GENJCL.RECOV commands in order to resolve keywords you have defined.
GSGNAME(gsgname)
Optional parameter used to specify to which global service group a database is
to be assigned.
GSGNAME can only be specified if AREA is specified.
ICJCL(ICJCL | member)
Optional parameter you use to specify the name of a member of a partitioned
data set that contains skeletal JCL. When you issue a GENJCL.IC command,
DBRC uses this member to generate the JCL to run the Database Image Copy
utility for the DBDS or DEDB area being identified.
NOREUSE | REUSE
Mutually exclusive, optional parameters you use to specify whether the
supported image copy utilities are to reuse previously used image copy data
sets.
REUSE
Allows the GENJCL.IC command or the GENJCL.OIC command to generate a
job that causes the supported image copy utilities to reuse the oldest image
copy data set (for the DBDS being defined) when the GENMAX value for
the DBDS is exceeded. REUSE requires that you create empty image copy

228 DBRC Guide & Reference

INIT.DBDS
data sets for future use by the supported image copy utilities. In addition,
you must use INIT.IC commands to record their existence in RECON. The
NOREUSE parameter prohibits such actions.
NOREUSE
Prevents the automatic reuse of image copy data sets for this DBDS by the
supported image copy utilities.
If the NOREUSE option is specified for the HISAM database, the
image-copy-needed flag is not turned on at the end of the HISAM Reload
utilities. The input data set that is used while the HISAM database is being
reloaded is used as an image copy data set.

If you want HSSP image copy processing, you must specify REUSE. Reuse
means that the image copy job uses the same volumes, data set name, and
record in RECON for the new image copy data set as those of the oldest DBDS
image copy data set.
OICJCL(OICJCL | member)
Optional parameter you use to specify the name of a member of a partitioned
data set that contains skeletal JCL. You cannot use this parameter with a DEDB
area. When you issue a GENJCL.OIC command, DBRC uses this member to
generate the JCL to run the Online Database Image Copy utility for the DBDS
being identified.
PREOPEN | NOPREO
Mutually exclusive, optional parameters you use to specify whether an area is
to be opened after the first checkpoint following the next control region
initialization or when the next /START AREA command is processed. NOPREO is
the default, except if you specify PRELOAD, in which case PREOPEN is the
default.
PREOPEN
Indicates that the area is to be opened the next time the control region is
started or a /STA AREA command is processed. This option is valid for both
VSO and non-VSO areas.
NOPREO
Indicates that the area is not to be pre-opened the next time the control
region is started or a /START AREA command is processed. You cannot
specify NOPREO with PRELOAD.
RECOVJCL(RECOVJCL | member)
Optional parameter you use to specify the name of a member of a partitioned
data set of skeletal JCL. When you issue the GENJCL.RECOV command, DBRC
uses this member to generate the JCL that runs the Database Recovery utility
for the DBDS or area being identified.
RECOVPD(0 | value)
Optional parameter you use to specify the recovery period of the image copies
for a specified DBDS or DEDB area.
The recovery period is the current date minus the date of the oldest image
copy. If the image copies are dated within the days specified in the
RECOVPD(value), DBRC keeps them in the RECON.
For value, specify a decimal number from 0 to 999 that represent the number of
days the image copies are to be kept in RECON. If you specify 0 (the default),
there is no recovery period.
Related Reading:

Chapter 12. INIT Commands 229

INIT.DBDS
See IMS Version 7 Operations Guide for more information about the recovery
period of image copy data sets.
RECVJCL(RECVJCL | member)
Optional parameter you use to specify the name of the skeletal JCL member to
be used by the GENJCL.RECEIVE command.
RECVJCL can be specified for both RSR-covered and non-covered DL/I DBDSs
and Fast Path areas.
VSO | NOVSO
Mutually exclusive, optional parameters you use to specify whether an area is
to reside in virtual storage the next time the control region is initialized or when
the next /STA AREA command is processed.
VSO
Indicates that the area is to reside in virtual storage. Areas that are defined
with SHARELVL(0 | 1) are read into and written from an MVS data space.
Areas defined with SHARELVL(2 | 3) use the coupling facility to share data
between connected subsystems.
NOVSO
Indicates that this area is not to reside in virtual storage.
CFSTR1(name)
Optional parameter you use to specify the name of the first coupling
facility structure for the identified area. MVS coupling facility structure
naming conventions must be adhered to. This parameter is valid only
for VSO areas of DEDBs that are defined with SHARELVL(2 | 3). The
area name is the default if VSO is specified and the DEDB is
SHARELVL(2 | 3).
CFSTR2(name)
Optional parameter you use to specify the name of the second coupling
facility structure for the identified area. MVS coupling facility structure
naming conventions must be adhered to. This parameter is valid only
for VSO area of DEDBs defined with SHARELVL(2 | 3). There is no
default, and the name cannot be the area name if the CFSTR1 keyword
is not specified.
Related Reading: See IMS Version 7 Administration Guide: Database
Manager for details on CFSTR (coupling facility structure) naming
conventions.
LKASID | NOLKASID
Mutually exclusive optional parameters you use to specify whether local
data caching for the specified area is to be used for buffer lookaside on
read requests. The LKASID option is valid only for SHARELVL(2 | 3)
VSO areas.
LKASID
Indicates that buffer lookaside is to be performed on read requests
for this area.
NOLKASID
Indicates that buffer lookaside is not to be performed on read
requests for this area.
PRELOAD | NOPREL
Mutually exclusive, optional parameters you use to specify whether a
VSO area is to be loaded the next time it is opened.

230 DBRC Guide & Reference

INIT.DBDS
PRELOAD
Indicates that the area is to be loaded into an MVS data space the
next time it is opened. Selecting this option also causes the area to
be pre-opened.
NOPREL
Indicates that the area is not to be loaded into an MVS data space
the next time it is opened. For VSO areas, CIs are copied into a
data space when they are read for the first time.

Example of Identifying the DBDS to Initiate DBRC’s Control Over

Recovery
In this example, a DBDS is registered with DBRC. The IMS DD statement is
required to allow access to the IMS DBDLIB data set to obtain the data set
identifier, data set organization, and database organization of the DBDS. The DBDS
is identified by the DBD, DDN, and DSN parameters and it is accessed only by an
IMS system, its image copy data sets can be reused, and the maximum number of
images that DBRC is to maintain for it is 2. The ICJCL parameter specifies the
member of the partitioned data set of skeletal JCL that is to be used for the
generation of JCL for the Database Image Copy utility. The RECOVJCL parameter
does the same for the Database Recovery utility.
//INITDBDS JOB
.
.
.

//IMS DD DSN=IMS.DBDLIB,DISP=SHR
//SYSIN DD *
INIT.DBDS DBD(DBD002) DDN(DDN003) GENMAX(2) REUSE -
ICJCL(ICJCLX) RECOVJCL(RECOVJCX) DSN(DSN003)
/*

INIT.DBDSGRP
,

OO INIT.DBDSGRP GRPNAME(name) MEMBERS( S (dbname,ddname) ) OP

DBGRP( S dbname )
,

RECOVGRP( S (dbname ) )
,areaname

Use an INIT.DBDSGRP command to define a group of these types:

v DBDS group (DBDSs or DEDB areas)
v DB group (DL/I databases or DEDB areas)
v Recovery group (DL/I databases or DEDB areas)

A DBDS group can be used anywhere that a DB group can be used, such as for
the /DBR command, but this usage is inefficient. Preferably define a separate DB
group for such use.

Chapter 12. INIT Commands 231

INIT.DBDSGRP
A recovery group is used with ORS recoveries. It can also be used anywhere that a
DB group can be used.

Parameters
GRPNAME(name)
Required parameter you use to identify the DBDSGRP to be created. The name
can be from one to eight alphanumeric characters, and must not be the name
of an existing DBDSGRP or CAGRP record.
MEMBERS(dbname,ddname) | DBGRP(dbname) |
RECOVGRP(dbname,areaname)
Mutually exclusive, required parameters that identify the members to be
included in the new group. A group can contain up to 2000 members.
MEMBERS(dbname,ddname)
Indicates that the group is a DBDS group. This parameter identifies one or
more DBDSs or DEDB areas, each by a pair of names enclosed in
parentheses, where dbname is the database name and ddname is the DD
statement name or the DEDB area name.
Any member can belong to more than one DBDS group.
DBGRP(dbname)
Indicates that the group is a DB group, and identifies one or more
databases or area names. Any member can belong to more than one DB
group.
| RECOVGRP(dbname,areaname)
| Indicates that the group is a recovery group. A recovery group is a group of
| full-function databases, HALDB databases, or DEDB areas that you
| consider to be related. Partition databases and Fast Path databases cannot
| belong to a recovery group. If you use Online Recovery Service (ORS) to
| perform a TSR (Time Stamp Recovery) on one of the members of the
| group, ORS requires you to recover all members of the group to the same
| time. A recovery group otherwise can be used like a DB group.
| RECOVGRP identifies one or more DBs or DEDB areas. If a DEDB area is
| to be added to the recovery group, both dbname and areaname must be
| specified. Otherwise, areaname must not be specified. A database or area
| can belong to only one recovery group. If any of the members specified by
| RECOVGRP already belongs to another recovery group, the command
| fails.

Example of Creating a Group of DBDSs

In this example, a group of DBDSs is defined.
//INITDBGRP JOB
.
.
.

//SYSIN DD *
INIT.DBDSGRP GRPNAME(DBDSG1) -
MEMBERS((DB1,DD1),(DB2,DD2),(DB3,DD3))
/*

232 DBRC Guide & Reference

INIT.GSG

INIT.GSG
OO INIT.GSG GSGNAME(gsgname) OP
SEQNUM(number)

Use an INIT.GSG command to define a global service group (GSG). The GSG must
be defined in every RECON which is to be used by any IMS subsystem in the
GSG.

This command fails if RSRFEAT=NO is specified in the IMSCTRL macro.

Parameters
GSGNAME(gsgname)
Required parameter you use to specify the name of the GSG you want to
create.
SEQNUM(number)
Optional parameter you use to specify the initial DSN sequence number for the
GSG you want to create. If you do not specify a SEQNUM parameter, the GSG
DSN SEQ NUMBER is set to zero (0). This value is used to create unique
tracking log data set names. If you have deleted an old GSG and are now
creating a new GSG with the same name, specify a SEQNUM equal to the
value of the last DSN SEQ NUMBER of the old GSG. Otherwise, the tracker
might create logs that have data set duplicate names of previously created logs.

Example of Creating a Global Service Group

Here is an example of using the INIT.GSG command.
//INITGSG
. JOB
.
.

//SYSIN DD *
INIT.GSG GSGNAME(IMSGSG1)
/*

INIT.IC
Use an INIT.IC command to create image copy records in RECON. These image
OO INIT.IC DBD(name) DDN(name) ICDSN(name) O
AREA(name) 1 1
FILESEQ( value ) FILESEQ2( value )

O O
ICDSN2(name) 3400 3400 ,
UNIT( unittype ) UNIT2( unittype )
VOLLIST( S volser )

O OP
,

VOLLIST2( S volser )

copy records define image copy data sets that are available for use during
subsequent runs of the supported image copy utilities.

Chapter 12. INIT Commands 233

INIT.IC
Each INIT.IC command creates one image copy record. You can define image
copy data sets for subsequent use only if you have specified a REUSE parameter
for the corresponding DBDS or DEDB area when it was identified in RECON with
an INIT.DBDS command. The maximum number of image copy records that are to
be used for a given DBDS or DEDB area is determined by the value of GENMAX
for the specified DBDS or DEDB area.

Parameters
DBD(name)
Required parameter you use to identify the image copy data set being created
by the database name of its related DBDS or DEDB area.
DDN(name) | AREA(name)
Mutually exclusive, required parameters you use to identify the image copy data
set being created; nameis the data set ddname of the related DBDS or DEDB
area.
ICDSN(name)
Required parameter you use to specify the name of the image copy data set for
which the image copy record is being created. name can be up to 44
characters. You can use the default-naming convention for image copy data
sets for this name.
FILESEQ(1 | value)
Optional parameter you use to specify the file sequence number of the image
copy data set for which the image copy record is being created. You can specify
this parameter only if you specify a VOLLIST parameter, and only if the file
sequence number is not 1. value must be a decimal number from 1 to 9999.
FILESEQ2(1 | value)
Optional parameter you use to specify the file-sequence number of the
duplicate image copy data set for which the image copy record is being created.
You can specify this parameter only if you are creating a duplicate image copy
data set, if you specify a VOLLIST2 parameter, and if the file-sequence number
is not 1. The value you substitute in the variable field must be a decimal
number from 1 to 9999.
ICDSN2(name)
Optional parameter you use to specify the name of the duplicate image copy
data set for which the image copy record is being created. name can be up to
44 characters. You can use the default naming convention for duplicate image
copy data sets for this name.
UNIT(3400 | unittype)
Optional parameter you use to specify the unit type of the image copy data set
being defined. The unit type can be up to eight alphanumeric characters long.
If you specify the UNIT parameter, you must also specify the VOLLIST
parameter.
UNIT2(3400 | unittype)
Optional parameter you use to specify the unit type of the duplicate image copy
data set being defined. The unit type can be up to eight alphanumeric
characters.
VOLLIST(volser)
Optional parameter you use to specify the list of volumes on which the image
copy data set resides when it is used by the supported image copy utilities.

234 DBRC Guide & Reference

INIT.IC
Each volume serial number you substitute in the variable field can be up to six
alphanumeric characters. The volume serial list can contain from 1 to 255
volume serial numbers.
VOLLIST2(volser)
Optional parameter you use to specify the list of volumes on which the duplicate
image copy data set (identified with the ICDSN2 parameter) resides when it is
used by the supported image copy utilities. Each volume serial number you
substitute in the variable field can be up to six alphanumeric characters. The
volume serial list can contain from 1 to 255 volume serial numbers.

Example of Creating a Record That Defines the ICDSN

In this example, a record is created in RECON that defines an image copy data set
that is to be used for creating an image copy of the DBDS. The name of the image
copy data set is specified in the ICDSN parameter; in this example, the default
naming convention is used to generate the fully qualified data set name. The
volume on which the image copy data set is to reside is specified by the VOLLIST
parameter. and its file-sequence number is specified by the FILESEQ parameter.
//INITIC
. JOB
.
.

//SYSIN DD *
INIT.IC DBD(DB1) DDN(DD1) -
ICDSN(IMS.*.ICDSN2) -
VOLLIST(VOL003) FILESEQ(5)
/*

| INIT.PART
| OO INIT.PART DBD(name) PART(name) O
| KEYSTRING string
hex_string

| O DSNPREFX(string) O
| RANDOMZR(name) ANCHOR(value) HIBLOCK(value)

| O O
| BYTES(value) 0 0
FBFF( value ) FSPF( value )

| O O
| , 2
GENMAX( value )
BLOCKSIZE ( S 4096 )
value

| O O
| DEFLTJCL(member) ICJCL OICJCL
ICJCL( member ) OICJCL( member )

Chapter 12. INIT Commands 235

INIT.IC
| NOREUSE
O O
REUSE RECOVJCL
RECOVJCL( member )
|
| O OP
0 RECVJCL
RECOVPD( value ) RECVJCL( member )

| Use an INIT.PART command to register a HALDB Partition. The INIT.PART

| command creates the RECON HALDB partition structure (a PART record, the
| partition DB record and one or more DBDS records according to the DBD
| specification). The INIT.PART command will fail if the HALDB is being used by the
| HALDB Partition Definition utility. The IMS DBDLIB data set must be identified in the
| job stream for the Recovery Control utility with a ddname of IMS.

| Some parameters (identified below in the parameter description) apply to all the
| partition DBDSs created as a result of this command. This differs from the HALDB
| Partition Definition utility where these parameters may be specified separately for
| each partition DBDS being created. These parameters can later be changed
| individually with the CHANGE.DBDS command.

| Parameters
| DBD (name)
| Required parameter used to identify the HALDB for which the partition is to be
| defined.
| PART (name)
| Required parameter used to identify a HALDB partition name. Specified as an
| alphanumeric value, up to 7 characters long, with the first character being
| alphabetic.
| KEYSTRNG (char value or hex value)
| Optional parameter you use to specify a HALDB partition high key value or a
| selection string for use by a partition selection exit. Specified as a character
| value up to 256 characters long or a hexadecimal value up to 512 characters
| long. Character values must be alphanumeric (with no embedded blanks or
| commas unless the string is enclosed by single quotes). Unless enclosed by
| single quotes, the character string will be folded to uppercase. Hexadecimal
| values must be enclosed by single quotes and preceded by the letter X, for
| example: KEYSTRING(X’D7C1D9E3D2C5E8’).
| If no partition selection routine was specified in the HALDB master definition,
| KEYSTRING defines the Partition high key and is required. The high key length
| cannot be longer than the root key length. If the high key length is less than the
| defined root key length, the high key value is padded with hex ’FF’s up to the
| defined root key length. The partition high key values must be unique for each
| partition within a HALDB.
| If a partition selection routine was specified in the HALDB master definition,
| KEYSTRING defines a Partition Selection String which is passed to the partition
| selection routine. Your installation partition selection routine may or may not
| require a Partition Selection String. If required, the content of the string is
| determined by your installation. It can be up to 256 bytes long and consist of

236 DBRC Guide & Reference

INIT.IC
| simple character information. If it contains non-printable characters, it must be
| identified using hex notation. A hex character string is enclosed by single
| quotation marks and prefixed with an X.
| DSNPREFX (string)
| Required parameter you use to specify the data set name prefix for the partition
| data sets contained in a HALDB. Specified as a value, up to 37 characters long,
| that is a valid JCL data set name.
| RANDOMZR (name)
| Optional parameter used to specify the name of the randomizing module for
| HALDB PHDAM databases only. If RANDOMIZR is omitted, the name of the
| randomizing module is obtained from the DBD. A randomizing module controls
| root segment placement in, or retrieval from, the PHDAM HALDB.
| ANCHOR (value)
| Optional parameter used to specify the number of root anchor points (RAPs)
| desired in each control interval or block in the root addressable area of a
| PHDAM HALDB. The value specified must be between 1 and 255. Typical
| values are from 1 to 5. If ANCHOR is omitted, the value is obtained from the
| DBD. This parameter is for PHDAM HALDBs only.
| HIBLOCK (value)
| Optional parameter used to specify the maximum relative block number value
| that the user wishes to allow a randomizing module to produce for this HALDB.
| This value determines the number of control intervals or blocks in the root
| addressable area of an PHDAM HALDB. The value may range between 1 and
| 16,777,215(2**24-1). If BYTES is omitted, the value is obtained from the DBD.
| This parameter is for PHDAM HALDBs only.
| FBFF (0|value)
| Optional parameter used to specify the free block frequency factor (fbff) which
| specifies that every nth control interval or block in this data set group is left as
| free space during database load or reorganization (where FBFF=n). The range
| of FBFF includes all integer values from 0 to 100 except 1. The default value
| for FBFF is 0.
| FSPF (0|value)
| Optional parameter used to specify the free space percentage factor. It specifies
| the minimum percentage of each control interval or block that is to be left as
| free space in this data set group. Value may be any number between 0 and 99.
| The default value for FSPF is 0.
| BLOCKSIZE (4096|nnnnn)
| Optional parameter you use to specify the block size for OSAM data sets.
| Specify an even number no greater than 32,766. The block size value is used
| for OSAM only. The default is 4096. You may specify up to 10 values, one for
| each data set group defined in the DBD. See the SIZE keyword on the
| DATASET statement in the chapter on Database Description (DBD) Generation
| in the IMS Version 7 Utilities Reference: Database and Transaction Manager for
| further information on specifying the block size for OSAM data sets (although
| DBDGEN is not used to define HALDB partitions).
| GENMAX (2|value)
| Optional parameter you use to specify the maximum number of image copies
| that DBRC is to maintain for the partition DBDSs. If you identify a partition
| DBDS with the NOREUSE parameter, the oldest image copy beyond the
| recovery period is deleted when the number of image copies exceeds the
| GENMAX value. If you identify it with the REUSE parameter, the oldest image
| copy beyond the recovery period is reused. Specified as a numeric value from 2

Chapter 12. INIT Commands 237

INIT.IC
| to 255. All partition DBDSs will be created with this GENMAX value. The
| CHANGE>DBDS command can be used to change this for individual partition
| DBDSs. The default value for GENMAX is 2.
| DEFLTJCL (member)
| Optional parameter you use to specify an implicit skeletal JCL default member
| for a HALDB Partition DBDS. The specified member is used by the GENJCL.IC,
| GENJCL.OIC, and GENJCL.RECOV commands in order to resolve keywords
| you have defined. All partition DBDSs will be created with this DEFLTJCL
| member. The CHANGE.DBDS command can be used to change this for
| individual partition DBDSs.
| ICJCL (ICJCL|member)
| Optional parameter you use to specify the name of a member of a partitioned
| data set that contains skeletal JCL. When you issue a GENJCL.IC command,
| DBRC uses this member to generate the JCL to run the Database Image Copy
| utility (or the Database Image Copy 2 utility) for the partition DBDS specified on
| the GENJCL command. All partition DBDSs will be created with this ICJCL
| member. The CHANGE.DBDS command can be used to change this for
| individual partition DBDSs.
| NOREUSE | REUSE
| Mutually exclusive, optional parameters you use to specify whether the
| supported image copy utilities are to reuse previously used image copy data
| sets.
| NOREUSE
| REUSE allows the GENJCL.IC command or the GENJCL.OIC command to
| generate a job that causes the supported image copy utilities to reuse the
| oldest image copy data set (for the DBDS specified on the GENJCL
| command) when the GENMAX value for it is exceeded. REUSE requires
| that you create empty image copy data sets for future use by the supported
| image copy utilities. In addition you must use an INIT.IC command to record
| their existence in RECON.
| NOREUSE
| NOREUSE parameter prohibits such actions. All partition DBDSs will be
| created with the parameter specified. The CHANGE.DBDS command can
| be used to change this for individual partition DBDSs.
| OICJCL (OICJCL| member)
| Optional parameter you use to specify the name of a member of a partitioned
| data set that contains skeletal JCL. When you issue a GENJCL.OIC command,
| DBRC uses this member to generate the JCL to run the Online Database
| Image Copy utility for the partition DBDS specified on the GENJCL command.
| All partition DBDSs will be created with this OICJCL member. The
| CHANGE.DBDS command can be used to change this for individual partition
| DBDSs.
| RECOVJCL (RECOVJCL| member)
| Optional parameter you use to specify the name of a member of a partitioned
| data set that contains skeletal JCL. When you issue the GENJCL.RECOV
| command, DBRC uses this member to generate the JCL to run the Database
| Recovery utility for the partition DBDS specified on the GENJCL command. All
| partition DBDSs will be created with this RECOVJCL member. The
| CHANGE.DBDS command can be used to change this for individual partition
| DBDSs.
| RECOVPD (0| value)
| Optional parameter you use to specify the recovery period of the image copies

238 DBRC Guide & Reference

INIT.IC
| for a specified partition DBDS. Specify a numeric value from 0 to 999 that
| represents the number of days the image copies are to be kept in RECON. The
| default is 0 which means there is no recovery period. All partition DBDSs will be
| created with this RECOVPD value. The CHANGE.DBDS command can be used
| to change this for individual partition DBDSs.
| RECVJCL(RECVJCL| member)
| Optional parameter you use to specify the name of the skeletal JCL member to
| be used by the GENJCL.RECEIVE command. RECVJCL can be specified for
| both RSR-covered and non-covered HALDB DBDSs. All partition DBDSs will be
| created with this RECVJCL member. The CHANGE.DBDS command can be
| used to change this for individual partition DBDSs.
|
INIT.RECON
NOCATDS COEX DASDUNIT(3400)
OO INIT.RECON O
CATDS NOCOEX DASDUNIT ( unittype )

NOFORCER CHECK17 NOLISTDL LOGRET(001)

O O
FORCER CHECK44 LISTDL LOGRET ( ’time_interval’ )
NOCHECK

NONEW TAPEUNIT(3400)
O OP
SSID(name) STARTNEW TAPEUNIT ( unittype ) UPGRADE

Use the INIT.RECON command to initialize the RECON for use by DBRC.

The RECON data sets must first be created using the AMS DEFINE CLUSTER
command, and must be empty.

Parameters
CATDS | NOCATDS
Mutually exclusive, optional parameters you use to indicate whether image
copy, change accumulation, and log data sets are cataloged.
CATDS
Specifies that these data sets are cataloged. If the data set is allocated by
the catalog and the CATDS option is used, DBRC bypasses volume serial
and file sequence verification for the data set.
In order for CATDS option to be effective, the data set must be cataloged,
and volume serial information for the data set must be omitted from the
JCL. If the data set is cataloged, CATDS is specified, and volume serial
information is included in the JCL, DBRC ignores CATDS and allocates the
data set by the JCL. Normal volume serial and file sequence checking
occurs.
If the data set is not cataloged, CATDS is not effective, and DBRC allocates
the data set by the JCL, with volume serial and file sequence checking.
Attention: The CATDS option affects that restart of IMS from SLDS data
sets. Because the CATDS option indicates the SLDSs are under the control

Chapter 12. INIT Commands 239

INIT.RECON
of a catalog management system, the VOLSER is not passed back to IMS
for data set allocation. If the SLDS data sets are not cataloged, IMS restart
fails.
NOCATDS
Specifies that these data sets, regardless of if they are cataloged, are not to
be treated as cataloged. DBRC verifies that the volume serial and file
sequence numbers appearing in the job file control block are the same as
the information recorded in the RECON.
COEX | NOCOEX
Mutually exclusive, optional parameters you use to specify whether pre-version
6 IMS can access a Version 7 RECON.
COEX
Enables the access of the Version 7 RECON by pre-version 6 IMS, and
imposes the same processing limitations on Version 7 as on pre-version 6
when the local clock is changed (for example, as for daylight savings time).
Attention: CHANGE.RECON COEX enables you to reverse the setting of
NOCOEX. There is no harm done as long as the local time has not
changed since coexistence was disabled. Otherwise, serious malfunctions
could occur in your pre-version 6 systems. IMS makes no attempt to protect
you from the harm done by a local time change.
NOCOEX
Used if you never intend to run any pre-version 6 jobs against the RECON
(including fall back to pre-version 6 after encountering a problem with
Version 7). NOCOEX disables coexistence so that there are no limitations
on Version 7 processing when the local clock is changed. You should be
sure of the appropriateness of your decision to use the NOCOEX keyword.
It is possible to reverse but see the attention statement above.
DASDUNIT(unittype)
Optional parameter you use to specify the unit type of the DASD device holding
the records for log data sets. The unit type can be up to eight alphanumeric
characters long.
If you do not use this parameter to specify a DASD device, then the INIT.RECON
command defaults to DASD unit type 3400.
FORCER | NOFORCER
Mutually exclusive, optional parameters you use to specify whether all IMS
databases must be registered in RECON.
FORCER
Specifies that all databases must be registered. If you specify FORCER and
a job attempts to access an unregistered database, the database
authorization call from IMS to DBRC fails.
NOFORCER
Specifies that databases need not be registered.
CHECK17 | CHECK44 | NOCHECK
Mutually exclusive, optional parameters you use to change the type of log data
set name comparison that DBRC does.
CHECK17
Verifies that the last 17 characters of a log data set name are consistent
with RECON. If the name in RECON does not match the names on the
appropriate ddname, the utility stops.

240 DBRC Guide & Reference

INIT.RECON
CHECK44
Verifies that the 44-character log data set name is consistent with RECON.
If the name in RECON does not match the name on the appropriate log
ddname, the utility is stops.
NOCHECK
Used if the data set name specified as input to the Database Recovery
utility is longer than 17 characters and has a new high-level qualifier. DBRC
does not compare the log data set name recorded in RECON with the
name on the appropriate ddname.
LOGRET(time_interval)
Optional parameter you use to specify the retention period for log data sets.
Definitions:
v The retention period is the minimum amount of time in which a log becomes
inactive after it is opened. (It is then eligible to be deleted.)
v The time_interval is a partial, punctuated time stamp representing a time
interval (days, hours, minutes, and seconds) rather than a date and time. The
time stamp has the following format:
ddd|hh|mm|ss|t

ddd Number of days (000 to 365)

hh Number of hours (0 to 23)
mm Number of minutes (0 to 59)
ss Number of seconds (0 to 59)
t Tenths of a second (0 to 9)

The punctuation for the time stamp (shown in the above format as a vertical bar
(|)) can be any non-numeric character, such as a period (.) or a comma (,). The
time stamp must be enclosed in single quotes (’) if it contains any blanks or
special characters. The number of days must include any leading zeros, but you
can omit trailing zeros. Valid intervals range between a tenth of a second and
365 days. The default value, 001, is 24 hours.

Because the time interval is treated as a time stamp, message DSP0106I can
be issued for incorrect values. Some examples of valid time intervals include:
LOGRET(365)
LOGRET('030 12.00')
LOGRET('000 00:00:08.0')
LOGRET('000 00,00,00,1')

Two different valid formats for equivalent time stamp specifications are shown.
LOGRET(030) LOGRET('030') = 30 days
LOGRET('010 12,30') LOGRET('01 12:30') = 10 days, 12 hours, 30 seconds

If you do not use this parameter to specify a retention period, then the
INIT.RECON command defaults to a period of 001 (24 hours).

Related Reading:
v See “DELETE.LOG (for RLDS and SLDS)” on page 178 for more information
on deleting inactive logs.

Chapter 12. INIT Commands 241

INIT.RECON
v See “Standard Time Stamp Format” on page 101 for more information on
time stamps.
LISTDL | NOLISTDL
Mutually exclusive, optional parameters you use to specify whether data set
names deleted from the RECON (by DELETE.LOG command or by an archive job
log compression) are listed in the job output. The setting specified on this
command can be overridden by the DELETE.LOG command. There is no way to
override the setting for log compression during an archive job.
LISTDL
Specifies that names of deleted data sets are to be listed in the job output.
NOLISTDL
Specifies that names of deleted data sets are not to be listed in the job
output.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that is to
be used as the default subsystem ID for the following commands:
CHANGE.PRILOG
CHANGE.SECLOG
DELETE.LOG
GENJCL.ARCHIVE
GENJCL.CLOSE
NOTIFY.PRILOG
NOTIFY.SECLOG
name is an eight-character alphanumeric string that identifies a valid IMS
subsystem ID.
STARTNEW | NONEW
Mutually exclusive, optional parameters you use to specify whether new jobs
are to be started when only one RECON is available.
STARTNEW
Specifies that new jobs are to be started.
NONEW
Specifies that new jobs are not to be started.
TAPEUNIT(unittype)
Optional parameter you use to specify the unit type of the tape device that is
holding the records for log data sets. The unit type can be up to eight
alphanumeric characters long.
If you do not use this parameter to specify a tape device, then the INIT.RECON
command defaults to unit type 3400.
UPGRADE
Optional parameter you use when initializing the new Version 7 RECON during
the process of upgrading a pre-version 6 RECON. For more information on the
upgrade process, see “Upgrade Procedure” on page 71. This parameter sets a
safety switch that makes the new RECON unusable until the Upgrade utility is
run. The Upgrade utility does not run if this switch has not been set.
Related Reading: See “Chapter 4. RECON Upgrade Utility (DSPURU00)” on
page 71 for more information on the upgrade process.

242 DBRC Guide & Reference

INIT.RECON
Example of Initializing the RECON
In this example, the RECON data sets are identified by the RECON1 and RECON2
DD statements.
//INITRCON JOB
.
.
.

//RECON1 DD DSN=RECON7,DISP=SHR
//RECON2 DD DSN=RECON8,DISP=SHR
//SYSIN DD *
INIT.RECON NOCHECK SSID(IMSB) LOGRET('007 00:00:30.0')
/*

INIT.SG
NONLOCAL
OO INIT.SG GSGNAME(gsgname) SGNAME(sgname) ACTIVE OP
TRACKING LOCAL

Use an INIT.SG command to define a service group as a member of a GSG. Every

service group in the GSG must be defined in every RECON that is to be used by
any IMS subsystem in the GSG. This command also specifies the initial role of the
service group.

This command fails if RSRFEAT=NO is specified in the IMSCTRL macro.

Parameters
ACTIVE | TRACKING
Mutually exclusive, required parameters you use to specify the initial role of the
service group.
ACTIVE
Indicates that the service group is an active subsystem. ACTIVE can only
be specified for one service group of a GSG.
TRACKING
Indicates that the service group is a tracking subsystem. TRACKING can
only be specified for one service group of a GSG.
GSGNAME(gsgname)
Required parameter you use to specify the name of the GSG to which the
service group belongs.
SGNAME(sgname)
Required parameter you use to specify the name of the service group you want
to create.
LOCAL | NONLOCAL
Mutually exclusive, optional parameters you use to specify whether the service
group is local or nonlocal.
LOCAL
Indicates that this is the local service group for this set of RECONs.
NONLOCAL
Indicates that this is the nonlocal service group for this set of RECONs.

Chapter 12. INIT Commands 243

INIT.SG
Examples of Creating Service Groups
In this example, the ACTIVE Service Group named STLSITE1 is added to the GSG
IMSGSG1, and a LOCAL TRACKING SG named STLSITE2 is added to the same
GSG.
//INITSG
. JOB
.
.

//SYSIN DD *
INIT.SG GSGNAME(IMSGSG1) SGNAME(STLSITE1) ACTIVE
INIT.SG GSGNAME(IMSGSG1) SGNAME(STLSITE2) TRACKING LOCAL
/*

244 DBRC Guide & Reference

Chapter 13. LIST Commands
LIST.BKOUT
ALL
OO LIST.BKOUT OP
SSID(name) TIMEFMT(sublist)

Use a LIST.BKOUT command to list information about the backout record for the
selected subsystem or to list all backout records in RECON. For the format of the
records listed by this command, see the “Appendix C. Sample Listings of RECONs”
on page 367.

Parameters
ALL | SSID(name)
Mutually exclusive, optional parameters that identify the backout records that
are to be displayed.
ALL
Specifies that all the backout records in the RECON are to be displayed.
SSID(name)
Specifies that only one backout record is to be displayed. name is an
eight-character alphanumeric string that identifies a valid subsystem ID.
TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear in
messages, displays, and listings from DBRC.
Related Reading:
v See “TIMEFMT Parameter Sublist” on page 102 for a description of the
TIMEFMT parameter sublist format.
v See “Standard Time Stamp Format” on page 101 for examples of the
different output forms.

The LIST commands get the TIMEFMT default from what is specified in the
RECON header record.

Example of Running LIST.BKOUT

Here is an example of running the LIST.BKOUT command.
//LISTBKOUT JOB
.
.
.

//SYSIN DD *
LIST.BKOUT SSID(IMS1)
/*

LIST.CAGRP

© Copyright IBM Corp. 1974, 2001 245

LIST.CAGRP
ALL
OO LIST.CAGRP OP
GRPNAME(name) TIMEFMT(sublist)

Use a LIST.CAGRP command to list information in the Copy1 RECON about either a
specified CA group or all CA groups. For the format of the records listed by this
command, see the “Appendix C. Sample Listings of RECONs” on page 367.

Parameters
ALL | GRPNAME(name)
Mutually exclusive, optional parameters you use to specify the name of the CA
group for which information is to be displayed.
ALL
Produces a list of the CA group record and corresponding change
accumulation run records for each CA group in RECON.
GRPNAME(name)
Produces a list of the CA group record and the change accumulation run
records for the group that you request in name.
TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear in
messages, displays, and listings from DBRC. The five values are positional.
Each is optional and can be omitted by including only the comma.
Related Reading:
v See “TIMEFMT Parameter Sublist” on page 102 for a description of the
TIMEFMT parameter sublist format.
v See “Standard Time Stamp Format” on page 101 for examples of the
different output forms.

The TIMEFMT default for LIST commands is obtained from what is specified in
the RECON header record.

Example of Specifying the CA Group and CA Records via GRPNAME

In this example, the CA group record and the associated CA records are specified
by the GRPNAME parameter.
//LISTCAGP JOB
.
.
.

//SYSIN DD *
LIST.CAGRP GRPNAME (MYGROUP)
/*

246 DBRC Guide & Reference

LIST.DB

LIST.DB
ALL
OO LIST.DB OP
TYPEIMS COVERED DBDS TIMEFMT(sublist)
TYPEFP GSG(gsgname)
TYPHALDB
DBD(dbname)

Use a LIST.DB command to receive a list of databases registered in RECON. You

can list one or all database records, with or without their associated DBDS records.

For the format of the records listed by this command, see the “Appendix C. Sample
Listings of RECONs” on page 367.

The LIST.DB command displays the recoverable or nonrecoverable status of the

full-function database.

Parameters
ALL | TYPEIMS | TYPEFP | TYPHALDB | DBD(dbname)
Mutually exclusive, optional parameters you use to specify which databases in
RECON are to be displayed.
ALL
Specifies that all database records in RECON are to be displayed. For
HALDBs, the partition database records are listed under the master record.
TYPEIMS
Specifies that all database records in RECON that describe a DL/I database
are to be displayed.
TYPEFP
Specifies that all database records in RECON that describe a Fast Path
DEDB are to be displayed.
TYPHALDB
Specifies that all database records that represent HALDBs are to be
displayed, including the HALDB master database records (TYPE=HALDB)
along with their associated HALDB partition database records
(TYPE=PART).
DBD(dbname)
Displays a specific database record or recovery group for a database.
For HALDBs, specifying the HALDB master name lists the HALDB master
record and all of its partition database records. Specifying the partition
database name lists only the partition database record.

Chapter 13. LIST Commands 247

LIST.DB
COVERED | GSG(gsgname)
Mutually exclusive, optional parameters you use to qualify the database records
in RECON that are to be displayed. Neither COVERED nor GSG(gsgname) can
be specified if DBD is specified.
COVERED
Specifies that all RSR-covered databases are to be displayed.
GSG(gsgname)
Specifies that only databases covered by the specified global service group
are to be displayed.
DBDS
Optional parameter you use to display those DBDSs or areas in RECON that
are associated with the specified database. DBDS information includes
recovery-related records (ALLOC, IC, RECOV, REORG). If you do not specify
this parameter, no DBDS records or area records are displayed.
TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear in
messages, displays, and listings from DBRC. The five values are positional.
Each is optional and can be omitted by including only the comma.
Related Reading:
v See “TIMEFMT Parameter Sublist” on page 102 for a description of the
TIMEFMT parameter sublist format.
v See “Standard Time Stamp Format” on page 101 for examples of the
different output forms.

The TIMEFMT default for LIST commands is obtained from what is specified in
the RECON header record.

Example of Displaying a Database and Its DBDS Records

In this example, database HDAMVSAM and its associated DBDS records are
displayed.
//LISTDB
.
.
.

//SYSIN DD *
LIST.DB DBD(HDAMVSAM) DBDS
/*

LIST.DBDS
OO LIST.DBDS DBD(name) OP
GROUP(name) DDN(name) TIMEFMT(sublist)
AREA(name)

Use a LIST.DBDS command to display a list of all records in RECON that contain
information about a specific DBDS or DEDB area. For the format of the records
listed by this command, see the “Appendix C. Sample Listings of RECONs” on
page 367.

248 DBRC Guide & Reference

LIST.DBDS
Parameters
DBD(name) | GROUP(name)
Mutually exclusive, required parameters you use to identify the DBDS or DEDB
area being listed.
DBD
Specifies the database name of the DBDS or DEDB area being displayed.
For HALDBs, you can specify either a HALDB master name or a HALDB
partition name.
GROUP
Specifies that all DBDSs or DEDB areas of the named DBDS group are to
be displayed. If GROUP is specified, the LIST.DBDS command is executed
for each member of the identified group.
DDN(name) | AREA(name)
Mutually exclusive, optional parameters you use to identify the DBDS or DEDB
area to be displayed. You specify one of these parameters only when you
specify the DBD parameter.
DDN(name)
Specifies the name of the DBDS to display.
For HALDBs, you must specify a HALDB partition name (not a HALDB
master name) with the DBD parameter in order to use the DDN parameter.
The DDN parameter value is the HALDB partition DDN. The LIST.DBDS
command is performed for the identified DBDS of the partition. The
LIST.DBDS command fails if DDN does not identify a DBDS in the partition.
AREA(name)
Specifies the name of the DEDB area to display.

If neither DDN nor AREA is specified, the LIST.DBDS command is executed for
each DBDS or DEDB area of the specified database. If you specify a HALDB
master name, the LIST.DBDS command is performed for each DBDS for each
HALDB partition in the HALDB master. If you specify a HALDB partition name,
the LIST.DBDS command is performed for each DBDS of the identified partition.
TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear in
messages, displays, and listings from DBRC. The five values are positional.
Each is optional and can be omitted by including only the comma.
Related Reading:
v See “TIMEFMT Parameter Sublist” on page 102 for a description of the
TIMEFMT parameter sublist format.
v See “Standard Time Stamp Format” on page 101 for examples of the
different output forms.

The TIMEFMT default for LIST commands is obtained from what is specified in
the RECON header record.

Example of Displaying AREA Parameters

In this example, information about the DEDB area specified in the DBD and AREA
parameters is displayed.

Chapter 13. LIST Commands 249

LIST.DBDS
//LISTDBDS JOB
.
.
.

//SYSIN DD *
LIST.DBDS DBD(FPEDBD02) AREA(AREA01)
/*

LIST.DBDSGRP
A
OO LIST.DBDSGRP OP
GRPNAME(name) TIMEFMT(sublist)

ALL
,

( S (dbname ) )
,areaname
,ddname

Use a LIST.DBDSGRP command to display a list of any of the following:

v All three kinds of data group records (DB groups, DBDS groups, and recovery
groups) in RECON
v The members of a single data group record
v All data group records containing a specified member or members

Related Commands:
v “INIT.DBDSGRP” on page 231
v “CHANGE.DBDSGRP” on page 132

Parameters
GRPNAME(name) | ALL
Mutually exclusive, optional parameters you use to specify the groups to be
listed.
GRPNAME
Produces a list of the members of the specified group. The named group
must exist in RECON.
ALL(dbname[,areaname][,ddname])
Produces a list of all the DBDS, DB, and recovery groups identified in
RECON. The optional parameters (dbname[,areaname][,ddname]) can be
used to limit the number of records listed. A group is listed only if it contains
one or more of the databases, DBDSs, or areas specified.
TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear in
messages, displays, and listings from DBRC. The five values are positional.
Each is optional and can be omitted by including only the comma.

250 DBRC Guide & Reference

LIST.DBDSGRP
Related Reading:
v See “TIMEFMT Parameter Sublist” on page 102 for a description of the
TIMEFMT parameter sublist format.
v See “Standard Time Stamp Format” on page 101 for examples of the
different output forms.

The TIMEFMT default for LIST commands is obtained from what is specified in
the RECON header record.

Example of Displaying the Members of a DBDS Group

In this example, the members of a specified DBDS group are displayed.
//LISTDBGP JOB
.
.
.

//SYSIN DD *
LIST.DBDSGRP GRPNAME(DBDSG1)
/*

LIST.GSG
ALL
OO LIST.GSG OP
GSGNAME(gsgname) TIMEFMT(sublist)

Use a LIST.GSG command to receive a list of the global service group records in
RECON. This command fails if RSRFEAT=NO is specified in the IMSCTRL macro.
For the format of the records listed by this command, see the “Appendix C. Sample
Listings of RECONs” on page 367.

Parameters
ALL | GSGNAME(name)
Mutually exclusive, optional parameters you use to specify which GSG records
in RECON are to be displayed.
ALL
Specifies that all GSG records in RECON are to be displayed.
GSGNAME(name)
Displays a specific GSG record.
TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear in
messages, displays, and listings from DBRC. The five values are positional.
Each is optional and can be omitted by including only the comma.
Related Reading:
v See “TIMEFMT Parameter Sublist” on page 102 for a description of the
TIMEFMT parameter sublist format.
v See “Standard Time Stamp Format” on page 101 for examples of the
different output forms.

Chapter 13. LIST Commands 251

LIST.GSG
The TIMEFMT default for LIST commands is obtained from what is specified in
the RECON header record.

Example of Listing a Global Service Group

In this example a single GSG record is displayed.
//LISTGSG
. JOB
.
.

//SYSIN DD *
LIST.GSG GSGNAME(GSG1)
/*

LIST.HISTORY
OO LIST.HISTORY DBD(name) O
GROUP(name) DDN(name) FROMTIME(timestamp)
AREA(name)

O OP
TOTIME(timestamp) TIMEFMT(sublist)

Use the LIST.HISTORY command to produce a history-of-activity listing for DBDSs or

DEDB areas. The output of the LIST.HISTORY command consists of:
v The database record listing.
v The DBDS record listing. (For a DEDB area, the area authorization and area
recovery records are combined to form a DBDS record listing.)
v The following records (if present), listed in time sequence order under each
DBDS or area:
– ALLOC records.
– IMAGE records.
– CA execution records, showing the purge time only for the current DBDS or
area.
– RECOV records.
– REORG records.
v The PRILOG records associated with all ALLOC records listed.
v A time line summary that interrelates all the events represented by the records
listed above.

You can use the FROMTIME and/or TOTIME parameters to define a time range
that excludes these records:
v ALLOC records for USIDs that are not active within the range. If any ALLOC
record is active within the time range, all ALLOCs for the same USID are listed.
v IMAGE records with RUN times (or for CICs, an effective purge time) outside the
range.
v CA execution records with STOP and PURGE times outside the range.
v RECOV records with RUN and RECOV TO times outside the range.
v REORG records with RUN times outside the range.

See “Sample Listing of LIST.HISTORY Output” on page 368 for an illustration of

sample output produced by the LIST.HISTORY command.

252 DBRC Guide & Reference

LIST.HISTORY
Parameters
DBD(name) | GROUP(name)
Mutually exclusive, required parameters you use to identify the DBDS or DEDB
area to list.
DBD
Specifies the database name of the DBDS or DEDB area to be listed.
For HALDBs, you can specify either a HALDB master name or a HALDB
partition name.
GROUP
Specifies that all the DBDSs or DEDB areas of a DBDS group are to be
listed. If GROUP is specified, the LIST.HISTORY command is executed for
each member of the identified group.
DDN(name) | AREA(name)
Mutually exclusive, optional parameters you use to identify the DBDS or DEDB
area to be listed. You specify one of these parameters only when you specify
the DBD parameter.
DDN
Specifies the name of the DBDS to list.
For HALDBs, you must specify a partition database name with the DBD
parameter in order to use the DDN parameter. The DDN parameter value is
the partition DDN. The LIST.HISTORY command is performed for the
identified DBDS of the partition. The LIST.HISTORY command fails if DDN
does not identify a DBDS in the partition.
AREA
Specifies the name of the DEDB area to list.

If neither DDN nor AREA is specified, the LIST.HISTORY command is executed

for each DBDS or DEDB area of the specified database. If you specify a
HALDB master name, the LIST.HISTORY command is performed for each DBDS
for each partition in the HALDB master. If you specify a HALDB partition name,
the LIST.HISTORY command is performed for each DBDS of the identified
partition.
FROMTIME(timestamp)
Optional parameter you use to specify the time stamps of the DBDS or DEDB
area records that are to be listed in time sequence order. The time stamp must
be in standard form (see “Standard Time Stamp Format” on page 101). Those
records that are not listed in time-sequence order are listed regardless of
whether FROMTIME or TOTIME are specified. FROMTIME specifies the time
stamp of the oldest record to be listed. If you specify only FROMTIME, all
subsequent, pertinent records in RECON are listed.
You can combine the FROMTIME and TOTIME parameters in order to specify a
range of records to display.
If you specify neither FROMTIME nor TOTIME, all the records that exist in
RECON for the specified DBDSs or DEDB areas are listed.
TOTIME(timestamp)
Optional parameter you use to specify the time stamps of the DBDS or DEDB
area records to be listed in time-sequence order. The time stamp must be in
standard form (see “Standard Time Stamp Format” on page 101). Those
records not listed in time-sequence order are listed regardless of whether

Chapter 13. LIST Commands 253

LIST.HISTORY
FROMTIME or TOTIME are specified. TOTIME specifies the time stamp of the
last record to be listed. If you specify only TOTIME, that record plus all prior,
pertinent records in RECON are listed.
You can combine the FROMTIME and TOTIME parameters in order to specify a
range of records to display.
If you specify neither FROMTIME nor TOTIME, all the records that exist in
RECON for the specified DBDSs or DEDB areas are listed.
TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear in
messages, displays, and listings from DBRC. The five values are positional.
Each is optional and can be omitted by including only the comma.
Related Reading:
v See “TIMEFMT Parameter Sublist” on page 102 for a description of the
TIMEFMT parameter sublist format.
v See “Standard Time Stamp Format” on page 101 for examples of the
different output forms.

The TIMEFMT default for LIST commands is obtained from what is specified in
the RECON header record.

Example of Displaying a DBDSs Activity History

In this example, the activity history of a specified DBDS is displayed.
//LISTHIST JOB
.
.
.

//SYSIN DD *
LIST.HISTORY DBD(DB1) DDN(NAME1)
/*

LIST.LOG (for a PRILOG Family)

OO LIST.LOG O
STARTIME(timestamp) SSID(name) GSG(gsgname)

O OP
TIMEFMT(sublist)

This command displays the PRILOG record and any of the following records having
the specified start time.
v LOGALL
v SECLOG
v PRISLD
v SECSLD

254 DBRC Guide & Reference

LIST.LOG (for a PRILOG family)
Parameters
STARTIME(timestamp)
Required parameter you use to specify the start time of the records that you
want displayed.
SSID(name)
Optional parameter that limits the display of log records or OLDS entries to
those associated with the specified subsystem.
GSG(gsgname)
Optional parameter that limits the display of log records to those associated
with the specified GSG.
If the name in any of the records listed does not match the specified name,
message DSP0144 is issued and processing continues.
TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear in
messages, displays, and listings from DBRC. The five values are positional.
Each is optional and can be omitted by including only the comma.
Related Reading:
v See “TIMEFMT Parameter Sublist” on page 102 for a description of the
TIMEFMT parameter sublist format.
v See “Standard Time Stamp Format” on page 101 for examples of the
different output forms.

The TIMEFMT default for LIST commands is obtained from what is specified in
the RECON header record.

Attention: If the ERROR, OPEN, or UNARCH parameters are coded, message

DSP0141I is issued and the command fails.

If the FROMTIME, TOTIME, INTERIM, or TRACKING parameters are coded,

STARTIME is ignored and the command defaults to ALL processing as described
under the next section.

Example of Listing a PRILOG Family of Records

In the example, all PRILOG, SECLOG, PRISLD, SECSLD, and LOGALL records
that have the specified start time are listed.
//LISTLOG
. JOB
.
.

//SYSIN DD *
LIST.LOG STARTIME('97.023 12:12:12.1 PST')
/*

LIST.LOG (for a Category of Records)

Each command form is followed by a list of the records it displays.

ALL
OO LIST.LOG OP

v PRILOG
v LOGALL

Chapter 13. LIST Commands 255

LIST.LOG (for a category of records)
v SECLOG
v PRISLD
v SECSLD
v PRIOLD
v SECOLD

ALL
OO LIST.LOG INTERIM OP

v IPRI
v ISEC
v IPRISL
v ISECSL
v IPRIOL
v ISECOL

ALL
OO LIST.LOG TRACKING OP

v PRITSLDS
v SECTSLDS

ALL
OO LIST.LOG TRACKING INTERIM OP

v IPRITSLD
v ISECTSLD

OO LIST.LOG ALLOLDS OP

v PRIOLD
v SECOLD

OO LIST.LOG ALLOLDS INTERIM OP

v IPRIOL
v ISECOL

OO LIST.LOG OLDS(ddname) OP
SSID(name)

v PRIOLD
v SECOLD

LIST.LOG OLDS displays only the data set entries with matching DD names and
subsystem names. If SSID is omitted, processing is the same as for ALLOLDS.

256 DBRC Guide & Reference

LIST.LOG (for a category of records)
Optional parameters for LIST.LOG ALL, ALLOLDS, and OLDS are:

OO SSID(name) O
FROMTIME(timestamp) TOTIME(timestamp) GSG(gsgname)

O OP
OPEN ERROR UNARCH

The command can be further qualified with one or more of the following optional
parameters. For example, combining SSID and OPEN limits the display to logs and
OLDS entries that belong to a specified subsystem, and to those that are not
closed.

Parameters
FROMTIME(timestamp)
Optional parameter that limits the display to log records or OLDS entries
starting at, or after, this time. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).
TOTIME(timestamp)
Optional parameter that limits the display to log records or OLDS entries
starting at, or after, this time. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).
SSID(name)
Optional parameter that limits the display to log records or OLDS entries
associated with the specified subsystem.
GSG(gsgname)
Optional parameter that limits the display of log records to those associated
with the specified GSG.
OPEN
Optional parameter that limits the display to log records or OLDS entries that
are not closed.
ERROR
Optional parameter that limits the display to log records having one or more
data set entries marked in error, and to OLDS entries marked in error.
UNARCH
Optional parameter that limits the display of OLDS entries to those that are not
archived.
Attention: Specifying UNARCH without the ERROR or OPEN parameters
causes ALL to be processed like ALLOLDS; that is, no log records are listed,
only unarchived OLDS entries are listed.

The following parameter can be used on all forms of the command.

OO OP
TIMEFMT(sublist)

TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear in

Chapter 13. LIST Commands 257

LIST.LOG (for a category of records)
messages, displays, and listings from DBRC. The five values are positional.
Each is optional and can be omitted by including only the comma.
Related Reading:
v See “TIMEFMT Parameter Sublist” on page 102 for a description of the
TIMEFMT parameter sublist format.
v See “Standard Time Stamp Format” on page 101 for examples of the
different output forms.

The TIMEFMT default for LIST commands is obtained from what is specified in
the RECON header record.

Attention: If the ERROR, OPEN, or UNARCH parameters are coded, message

DSP0141I is issued and the command fails.

If the FROMTIME, TOTIME, INTERIM, or TRACKING parameters are coded,

STARTIME is ignored and the command defaults to ALL processing as described
under the next section.

Example of Displaying RECON Records Specified by STARTIME

In this example, the RLDSs, SLDS, and corresponding LOGALL record with the
time stamp specified in the STARTIME parameter are to be displayed.
//LISTRCON JOB
.
.
.

//SYSIN DD *
LIST.LOG STARTIME(840311313130)
/*

Example of Displaying a Subsystem’s OLDS Records

In this example, the OLDS records from subsystem IMSA are to be displayed.
//LISTRCON JOB
.
.
.

//SYSIN DD *
LIST.LOG ALLOLDS SSID(IMSA)
/*

LIST.RECON
OO LIST.RECON OP
STATUS TIMEFMT(sublist)

Use the LIST.RECON command to obtain a display of the RECON’s current status
and a formatted display of all records it contains.

Use the STATUS keyword to display RECON status only.

RECON status information includes the following items:

v The contents of the Time Zone Label Table.

258 DBRC Guide & Reference

LIST.RECON
v The TIMEZIN and TIMEFMT settings.
v Whether coexistence of this RECON with pre-V6 IMS is enabled.
v If coexistence is enabled, the contents of the Time History Table.
v The status of each of the three RECONs.
RECON status Meaning
COPY1 PRIMARY ACTIVE RECON
COPY2 BACKUP RECON
SPARE AVAILABLE RECON
UNAVAILABLE UNAVAILABLE RECON
DISCARDED UNUSABLE RECONS

The RECON is unavailable when the resource is allocated in another system.

Parameters
STATUS
Optional parameter you use to request the RECON header record information
and the status of all RECONs. If you specify this parameter the listing of the
remainder of the records is suppressed.
TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear in
messages, displays, and listings from DBRC. The five values are positional.
Each is optional and can be omitted by including only the comma.
Related Reading:
v See “TIMEFMT Parameter Sublist” on page 102 for a description of the
TIMEFMT parameter sublist format.
v See “Standard Time Stamp Format” on page 101 for examples of the
different output forms.

The TIMEFMT default for LIST commands is obtained from what is specified in
the RECON header record.

Examples of Displaying the RECONs

Here are some examples of using the LIST.RECON command.

Example of Displaying the RECONs

In this example, the status and contents of RECON are displayed.
//LISTRCON JOB
.
.
.

//SYSIN DD *
LIST.RECON
/*

For a sample of RECON, see the “Appendix C. Sample Listings of RECONs” on

page 367.

Example of Displaying RECON Header and Status Information

In this example, only RECON header status information is displayed.

Chapter 13. LIST Commands 259

LIST.RECON
//LISTRCON JOB
.
.
.

//SYSIN DD *
LIST.RECON STATUS
/*

Only the first segment of output shown in the “Appendix C. Sample Listings of
RECONs” on page 367 is produced in this case.

Use a LIST.SUBSYS command to receive a formatted list of the subsystems

registered in RECON. For the format of the records listed by this command, see the
“Appendix C. Sample Listings of RECONs” on page 367.

Parameters
SSID(name) | ALL | ONLINE| BATCH
Mutually exclusive, optional parameters you use to specify which subsystem
information is to be displayed.
SSID(name)
Specifies the name of the subsystem for which information is to be
displayed.
ALL
Specifies that all subsystem information, both batch and online, is to be
displayed.
ONLINE
Specifies that all online subsystem information is to be displayed.
BATCH
Specifies that all batch subsystem information is to be displayed.
TIMEFMT(sublist)
Optional parameter you use to define the form in which time stamps appear in
messages, displays, and listings from DBRC. The five values are positional.
Each is optional and can be omitted by including only the comma.
Related Reading:
v See “TIMEFMT Parameter Sublist” on page 102 for a description of the
TIMEFMT parameter sublist format.
v See “Standard Time Stamp Format” on page 101 for examples of the
different output forms.

260 DBRC Guide & Reference

LIST.SUBSYS
The TIMEFMT default for LIST commands is obtained from what is specified in
the RECON header record.
TRACKING
Specifies that all RSR tracking subsystem information is to be displayed.

Example of Displaying All Online Subsystem Records

In this example, all online subsystem records are displayed.
//LISTSS JOB
.
.
.

//SYSIN DD *
LIST.SUBSYS
/*

Chapter 13. LIST Commands 261

LIST.SUBSYS

262 DBRC Guide & Reference

Chapter 14. NOTIFY Commands
NOTIFY.ALLOC
OO NOTIFY.ALLOC ALLTIME(timestamp) DBD(name) DDN(name) DEALTIME(timestamp) O
AREA(name) STARTIME(timestamp)

O OP
DSSN(value) USID(value)

Use a NOTIFY.ALLOC command to add information to RECON about either a specific

database allocation or a specific database deallocation of a DBDS or DEDB area.
This addition of information is required only when RECON was not updated during
a run of IMS that resulted in an allocation of the DBDS or DEDB area for updates.
You should not need to use this command under normal operating conditions.

The NOTIFY.ALLOC command fails if the DBDS or DEDB area is nonrecoverable or

in use.

Restriction: This command is not allowed for ILDS or Index DBDSs of HALDB
partitions.

Parameters
ALLTIME(timestamp)
Required parameter you use to specify the time stamp of the allocation of the
database that contains the DBDS or DEDB area that is specified in this
command. The time stamp must be in standard form (see “Standard Time
Stamp Format” on page 101).
When used with the STARTIME parameter, ALLTIME causes a new allocation
record to be written in RECON. When used with a DEALTIME parameter, it
identifies the allocation record in RECON for which a deallocation time is being
added.
DBD(name)
Required parameter you use to specify the database name of the DBDS or
DEDB area for which you are adding allocation information to RECON.
DDN(name) | AREA(name)
Required parameter you use to specify the data set ddname of the DBDS or
DEDB area for which you are adding allocation information to RECON.
DEALTIME(timestamp) | STARTIME(timestamp)
Mutually exclusive, required parameters. The time stamp must be in standard
form (see “Standard Time Stamp Format” on page 101).
DEALTIME
Specifies the time stamp of the deallocation of the database for the
specified DBDS or DEDB area. This addition to RECON is required only if
the database is allocated for updates and explicitly deallocated before the
end of an IMS run.

© Copyright IBM Corp. 1974, 2001 263

NOTIFY.ALLOC
STARTIME
Specifies the starting time stamp of the log data set that was active at the
time of the allocation specified in the ALLTIME parameter.
DSSN(value)
Optional parameter you use to specify which data set sequence number is
placed in the allocation record to be created. If you do not specify the DSSN
parameter, the data set sequence number for the new allocation record is 0,
indicating no data sharing. If you are using data sharing, you must specify the
appropriate DSSN. You use this parameter for log-merge processing.
USID(value)
Optional parameter you use to specify the update set identifier of the database
or area when the update occurred.
USID is required if the database or area is assigned to a GSG. If the database
or area is not assigned to a GSG, USID cannot be specified.

Example of Adding Allocation Information to RECON

In this example, information about an allocation of a specified DBDS is to be added
to RECON. The ALLTIME parameter specifies the time stamp of the allocation of
the DBDS or DEDB area; the STARTIME parameter specifies the time stamp of the
start of the log data set that was active at the time of the allocation.
//NFYALLOC JOB
.
.
.

//SYSIN DD *
NOTIFY.ALLOC DBD(DB1) DDN(DD1) -
STARTIME(820670201010) -
ALLTIME(820670308200)
/*

NOTIFY.BKOUT
OO NOTIFY.BKOUT SSID(name) UOR(uor) UORTIME(timestamp) PSB(name) O

O OP
, ,

DBD( S name ) BKO( S name )

Use the NOTIFY.BKOUT command to create a backout record for a specified

subsystem and to add a single unit of recovery (UOR) entry to the record that is
created. Additional UOR entries can be added to the backout record by using the
CHANGE.BKOUT command.

Parameters
SSID(name)
Required parameter you use to specify the subsystem for which the backout
record is to be created. The name is an eight-character, alphanumeric string
that represents any valid subsystem name.

264 DBRC Guide & Reference

NOTIFY.BKOUT
UOR(uor)
Required parameter you use in conjunction with the UORTIME parameter to
identify a unit of recovery in the backout record. The recovery token (uor) is a
16-byte field that describes a specific UOR that is to be included with the
backout record. uor must be 32 hexadecimal digits expressed as a character
string; for example, UOR(E2E8E2F3404040400000000600000003).
The recovery token is intended to be a unique identifier, but it can be duplicated
across restarts. When you include UORTIME, you eliminate the problem of
possible duplication.
UORTIME(timestamp)
Required parameter you use to specify the time of the UOR to be added to the
backout record. The value is the time stamp of the beginning of the UOR (found
in the X'5607' log record). The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).
PSB(name)
Required parameter you use to identify the PSB associated with the UOR.
DBD(name)
Optional parameter you use to identify up to eight databases having changes
associated with the unit of recovery that require backout.
BKO(name)
Optional parameter you use to identify up to eight databases having changes
associated with the unit of recovery that have already been backed out.
Use BKO to identify databases that have already been backed out from this
UOR-UORTIME combination. You can specify either the BKO parameter, the
DBD parameter, or both. A database name can appear in either BKO or DBD,
but not both. (A database cannot both be backed out and require a backout at
the same time.)

Example of Adding a Backout Record to RECON

In this example, a backout record for subsystem SYS3 is added to the RECON.
//NFYBKOUT JOB
.
.
.

//SYSIN DD *
NOTIFY.BKOUT SSID(SYS3)
UOR(E2E8E2F3404040400000000600000003)
UORTIME(930931345027) PSB(APPL34)
DBD(DATA1,DATA2,DATA3C)
BKO(DATA4,DATA5,DATA3A)
/*

NOTIFY.CA
OO NOTIFY.CA CADSN(name) GRPNAME(name) RUNTIME(timestamp) STOPTIME(timestamp) O

O VOLLIST( S volser ) O
1
FILESEQ( value )

Chapter 14. NOTIFY Commands 265

NOTIFY.CA
O O
,
NO COMPLETE
PURGLIST( S ( timestamp, YES , INCOMPLETE ) )

COMP
O OP
3400 SUBSET
UNIT( unittype )

Use a NOTIFY.CA command to add information about a run of the Database Change
Accumulation utility for a specified CA group.

Parameters
CADSN(name)
Required parameter you use to specify the data set name of the change
accumulation data set in the identified record. If the CA group is defined as
reusable, the data set name must be unique. DBRC does not check for
duplicate data set names.
GRPNAME(name)
Required parameter you use to specify the name of the CA group for which
information is to be added.
RUNTIME(timestamp)
Required parameter you use to identify the specific change accumulation run
record to be added. The time stamp represents the time at which the Database
Change Accumulation utility was run, and it must be in standard form (see
“Standard Time Stamp Format” on page 101).
STOPTIME(timestamp)
Required parameter you use to specify the time stamp of the change
accumulation run record for which information is to be added. The time stamp is
the stop time of the last log volume that was processed by the specified run of
the Change Accumulation utility, and it must be in standard form (see “Standard
Time Stamp Format” on page 101).
VOLLIST(volser)
Required parameter you use to specify the volume serial numbers of the
change accumulation data set in the specified change accumulation run record.
You can specify a maximum of 255 volume serial numbers for volser. Each
volume serial number can be a maximum of six alphanumeric characters.
FILESEQ(1 | value)
Optional parameter you use to specify the file sequence number of the
identified change accumulation data set.
value must be a decimal number from 1 to 9999.
PURGLIST(timestamp,YES | NO,COMPLETE | INCOMPLETE)
Optional parameter you use to specify the purge time, which is the point in time
in the input log records where change accumulation started and to specify
whether the logs form a complete subset.
The time stamp must be in standard form (see “Standard Time Stamp Format”
on page 101). If you do not specify a time stamp, the time is set to 0.
If you are using the accumulated changes as input to recovery, you must
choose a purge time that satisfies the DBRC input requirements for recovery.

266 DBRC Guide & Reference

NOTIFY.CA
Recovery first chooses an image copy and then uses a change accumulation
whose purge time for that DBDS matches the run time of the image copy.
YES | NO
Mutually exclusive subparameters you use to specify whether any changes
for the corresponding DBDS have been accumulated.
YES
Specifies that some changes have been accumulated for the
corresponding DBDS.
NO
Specifies that no changes have been accumulated for the
corresponding DBDS.
COMPLETE | INCOMPLETE
Mutually exclusive subparameters you use to specify whether the logs form
a complete subset. To determine whether a log subset is complete, use the
LIST.CAGRP command. See “LIST.CAGRP” on page 245 for more
information.
COMPLETE
Specifies that the logs form a complete subset. When you specify
COMPLETE, the time stamp of the STOPTIME parameter is the stop
time of the last log input to the Change Accumulation utility.
INCOMPLETE
Specifies that the logs form an incomplete subset. When you specify
INCOMPLETE, the time stamp of the STOPTIME parameter is the start
time of the earliest unselected (open) log volume. This volume should
be the first one that is selected at a later run.

If you specify the PURGLIST parameter, the order of the time stamp and the
change indicator in the purge list corresponds to the order of the DBDS names
specified in the GRPMEM parameter of the INIT.CAGRP command. For example,
the third purge time and change indicator is the purge time for the third DBDS
that is specified in the GRPMEM parameter of the INIT.CAGRP command.

If you specify fewer subparameters with the PURGLIST parameter than you
specified with the GRPMEM parameter of the INIT.CAGRP command, DBRC
uses the defaults of NO and COMPLETE for each DBDS that you omit.
Similarly, if you do not specify the PURGLIST parameter, DBRC uses the
defaults of NO and COMPLETE for each DBDS specified with the GRPMEM
parameter of the INIT.CAGRP command. To use a default of NO for certain
DBDSs, use commas to indicate which DBDSs are subject to the default.
UNIT(3400 | unittype)
Optional parameter you use to specify the unit type of the volumes on which the
change accumulation data set resides. unittype can be up to eight alphanumeric
characters.
COMP | SUBSET
Mutually exclusive, optional parameters you use to indicate that the change
accumulation record’s stop time is a log volume start time.
COMP
Indicates that when the CA was created, a complete set of logs was
processed and that the CA’s stop time is the stop time of the last log
volume processed.

Chapter 14. NOTIFY Commands 267

NOTIFY.CA
SUBSET
Indicates that when the CA was created, a subset of logs was processed
and the CA’s stop time is the start time of the first unprocessed log volume.
Specifying INCOMPLETE in the PURGLIST parameter does not
automatically cause SUBSET to be set.

Example of Adding CADSN Information to RECON

In this example, information about a change accumulation data set is to be added
to RECON.
//NFYCA JOB
.
.
.

//SYSIN DD *
NOTIFY.CA GRPNAME(CAGRP2) -
STOPTIME(840240202020) -
RUNTIME(840250305029) CADSN(CADSN06) -
VOLLIST(VOL005) -
PURGLIST((840240302005,YES),,(840250420256,))
/*

NOTIFY.IC
OO NOTIFY.IC DBD(name) DDN(name) ICDSN(name) RUNTIME(timestamp) O
AREA(name)

BATCH
O O
1 1 ICDSN2(name) ONLINE
FILESEQ( value ) FILESEQ2( value ) CIC
SMSCIC
SMSNOCIC

O O
RECDCT(value) STOPTIME(timestamp) 3400
UNIT( unittype )

O O
3400 ,
UNIT2( unittype )
VOLLIST( S volser )

O OP
, USID(value)

VOLLIST2( S volser )

Use a NOTIFY.IC command to add information about an image copy.

268 DBRC Guide & Reference

NOTIFY.IC
Restriction: This command is not allowed for ILDS or Index DBDSs of HALDB
partitions.

Parameters
DBD(name)
Required parameter you use to specify the database name of the DBDS or area
for which an image copy run record is to be added.
DDN(name) | AREA(name)
Mutually exclusive, required parameters you use to specify the data set ddname
of the DBDS (use DDN) or DEDB area (use AREA) for which an image copy
run record is to be added.
ICDSN(name)
Required parameter you use to specify the data set name of the image copy
data set that contains the image copy whose run record is being added. name
can be a maximum of 44 characters.
RUNTIME(timestamp)
Required parameter you use to specify the time the image copy utility was run.
The time stamp must be in standard form (see “Standard Time Stamp Format”
on page 101).
FILESEQ(1 | value)
Optional parameter you use to specify the file sequence number of the
identified image copy data set. value must be a decimal number from 1 to 9999.
FILESEQ2(1 | value)
Optional parameter you use to specify the file sequence number of the
identified duplicate image copy data set. value can be a decimal number from 1
to 9999.
You can specify this parameter only if you specify the VOLLIST2 parameter. If
the VOLLIST2 parameter is specified, then FILESEQ2(1) is the default for this
parameter.
ICDSN2(name)
Optional parameter you use to specify the data set name of the duplicate image
copy data set that is to contain the image copy whose run record is being
added. name can be a maximum of 44 characters.
BATCH| ONLINE | CIC | SMSCIC | SMSNOCIC
Mutually exclusive, optional parameters you use to specify the type of image
copy that the data set contains.
BATCH
Indicates that the Database Image Copy (DFSUDMP0) utility was used to
create the image copy while the database was unavailable for update
processing (the CIC parameter was not specified). BATCH may also be
specified to record the output of the HISAM Reorganization Unload utility
image copy.
ONLINE
Specifies that the image copy data set was obtained by executing the
Online Database Image Copy utility. You must use the STOPTIME
parameter when you specify ONLINE.
CIC
Indicates that a concurrent image copy was taken. A concurrent image copy

Chapter 14. NOTIFY Commands 269

NOTIFY.IC
is a “fuzzy” copy, so the data set uses logs in order to complete the image.
STOPTIME must be used if CIC is specified. CIC cannot be used to copy
VSAM KSDS databases.
SMSCIC
Indicates that the Database Image Copy 2 was used to create the image
copy while the database was available for update processing (’S’ was
specified on the utility control statement). The image copy is in DFSMS
dump format. The image copy is a “fuzzy” copy so logs must be applied to
recover the data set to a usable state. The STOPTIME parameter must be
specified when you specify SMSCIC.
SMSNOCIC
Indicates that the Database Image Copy 2 utility was used to create the
image copy while the database was unavailable for update processing (’X’
was specified on the utility control statement). The image copy is in DFSMS
dump format.
RECDCT(value)
Optional parameter you use to specify the count of the records in the image
copy data set. value must be a decimal number from 1 to 2147483647.
STOPTIME(timestamp)
Optional parameter you use to specify the stop time of the online or concurrent
image copy. You must specify this parameter when online, CIC, or SMSCIC is
specified. The time stamp must be in standard form (see “Standard Time Stamp
Format” on page 101).
UNIT(3400 | unittype)
Optional parameter you use to specify the unit type of the image copy data set.
The unit type can be up to eight alphanumeric characters.
UNIT2(3400 | unittype)
Optional parameter you use to specify the unit type of the duplicate image copy
data set. The unit type can be up to eight alphanumeric characters long.
VOLLIST(volser)
Optional parameter you use to specify (in the batch or online image copy
record) the volume serial numbers of the volumes on which the specified image
copy data set resides. This parameter is required when either ONLINE or
BATCH parameters are specified.
VOLLIST2(volser)
Optional parameter you use to specify the volume serial numbers (in the image
copy record) of the volumes on which the specified duplicate image copy data
set resides. This parameter is required if ICDSN2 is specified, and when either
online or batch parameters are specified.
USID(value)
Optional parameter you use to specify the update set identifier of the database
or area when the reorganization occurred.
USID is required if the database or area is assigned to a GSG. If the database
or area is not assigned to a GSG, USID is optional.

Example of Notifying DBRC of Concurrent Image Copy Completion

In this example, DBRC is notified of the successful completion of a concurrent
image copy for the area specified. RUNTIME refers to the time the image copy
started. STOPTIME refers to the time the image copy ended.

270 DBRC Guide & Reference

NOTIFY.IC
//NFYIC JOB
.
.
.

//SYSIN DD *
NOTIFY.IC DBD(DBD001) AREA(AREA1)
RUNTIME(8520002020)
STOPTIME(8520004040)
ICDSN(IC0005) CIC
/*

NOTIFY.PRILOG (for OLDS)

OO NOTIFY.PRILOG OLDS(ddname) DSN(name) STARTIME(timestamp) O
RUNTIME(timestamp)

O O
FIRSTREC(number) GSG(gsgname) INTERIM LASTREC(number)

O OP
LOGTOKEN(number) NXTOLDS(ddname) SSID(name)

Use a NOTIFY.PRILOG command to add information about a primary OLDS to

RECON and to manually create interim PRILOG in RECON. You would do this in a
case where the log processing exit routines of the IMS system failed to do so.

Parameters
OLDS(ddname)
Required parameter you use to specify that a record is to be created in RECON
for an OLDS. If you do not specify OLDS, the default is RLDS (see
“NOTIFY.PRILOG (for RLDS)” on page 274). ddname is the DD statement that
the IMS online control region used when it used the OLDS.
DSN(name) | RUNTIME(timestamp)
Mutually exclusive, required parameters.
DSN
Specifies the data set name of the primary OLDS for which a log record is
being created in RECON.
RUNTIME
Specifies the time stamp of a close operation for the specified primary
OLDS. The time stamp must be in standard form (see “Standard Time
Stamp Format” on page 101).

These two parameters are used in conjunction with the STARTIME and
NXTOLDS parameters to identify what type of primary OLDS entry is to be
added to RECON. Table 5 indicates which parameter combinations are required
for each type of primary OLDS entry:
Table 5. Parameters of NOTIFY.PRILOG (for OLDS) Command for Open, Switch, and Close
Type of Log Entry Required Keywords
OLDS Open STARTIME, DSN, FIRSTREC

Chapter 14. NOTIFY Commands 271

NOTIFY.PRILOG (for OLDS)
Table 5. Parameters of NOTIFY.PRILOG (for OLDS) Command for Open, Switch, and
Close (continued)
Type of Log Entry Required Keywords
OLDS Switch STARTIME, DSN, FIRSTREC, NXTOLDS
OLDS Close LASTREC, STARTIME, RUNTIME

For each primary OLDS, you must issue a separate NOTIFY.PRILOG command
for open, switch, and close.
STARTIME(timestamp)
Required parameter you use to specify the starting time of a primary OLDS.
The time stamp must be in standard form, see “Standard Time Stamp Format”
on page 101.
See Table 5 on page 271 for a description of the use of this parameter with
other parameters in the NOTIFY.PRILOG command.
FIRSTREC(number)
Optional parameter you use to specify the log record sequence number of the
first log record of the OLDS. For the first OLDS of the PRILOG, it corresponds
to the first log record that was written during initialization of the IMS subsystem.
FIRSTREC is required for OLDS OPEN and SWITCH commands. It specifies the
first log record sequence number on the OLDS that is being opened. It is invalid
for a CLOSE command.
The log record sequence number can be one of the following:
v A hexadecimal number
This number is 1 to 16 characters, enclosed in single quotes and preceded
by the letter, X. For example: FIRSTREC(X'10B9C').
v A decimal number
This number is a decimal number from 0 to (2**64)-1, without delimiters. For
example: FIRSTREC(68508).

In either case, leading zeros can be omitted.

GSG(gsgname)
Optional parameter you use to specify the GSG name of the IMS subsystem
that produced the OLDS.
GSG is required if LOGTOKEN is specified.
INTERIM
Optional parameter you use to specify that an interim log data set record is to
be created.
Before you specify NOTIFY.PRILOG INTERIM, a corresponding primary log record
must exist.
LASTREC(number)
Optional parameter you use to specify the log record sequence number of the
last log record of the OLDS.
LASTREC is required for the OLDS CLOSE command. It is optional for the
SWITCH command; if it is omitted, the FIRSTREC value minus 1, is recorded for
the OLDS that is being closed. It is invalid for an OPEN command.
The log record sequence number can be one of the following:
v A hexadecimal number

272 DBRC Guide & Reference

NOTIFY.PRILOG (for OLDS)
This number is 1 to 16 characters, enclosed in single quotes and preceded
by the letter, X. For example: LASTREC(X'10B9C').
v A decimal number
This number is a decimal number from 0 to (2**64)-1, without delimiters. For
example: LASTREC(68508).

In either case, leading zeros can be omitted.

LOGTOKEN(number)
Optional parameter you use to specify the log token to be inserted into the
PRILOG record and, if necessary, into the GSG record. It is valid only on an
OLDS Open command.
Log tokens are numeric, assigned sequentially within PRILOG records for the
same GSG, and used during recovery to ensure that all logs produced by
members of the GSG have been included. The highest token assigned to any
PRILOG is recorded in the GSG record.
The log token must satisfy all of the following conditions:
v Must be greater than that contained in the previous PRILOG record for the
same GSG, if any.
v Must be less than that contained in the next PRILOG record for the same
GSG, if any.
v Must not be more than one greater than the high PRILOG token contained in
the specified GSG record.
NXTOLDS(ddname)
Optional parameter you use when RECON is to be updated to reflect an OLDS
switch. The current OLDS is closed and an IMS online control region opens a
new OLDS. ddname is the DD statement of the OLDS being opened. You
specify the OLDS being closed with the OLDS(ddname) parameter. Use the
DSN(name) parameter to specify the data set name of the OLDS being opened.
Use the STARTIME(timestamp) parameter to specify the close time of the
OLDS being closed and the open time of the OLDS being opened.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the log data set.
The SSID is an eight-character, alphanumeric string that represents a valid IMS
subsystem identification name. If you do not specify SSID, DBRC uses the
default subsystem identifier in the RECON header record. You use the
INIT.RECON or CHANGE.RECON command to set the default subsystem identifier in
the RECON header record. If you have not specified a default in the RECON
header record, you must specify SSID.

Examples of Using the NOTIFY.PRILOG (for OLDS) Command

Here are some examples of using the NOTIFY.PRILOG (for OLDS) command.

Example of Creating a PRIOLDS for an Online Subsystem OLDS

In this example, you create a PRIOLDS for an OLDS that belongs to IMS online
subsystem IMSA.
//NFYPRILG JOB
.
.
.

//SYSIN DD *
NOTIFY.PRILOG STARTIME(831230554321) -

Chapter 14. NOTIFY Commands 273

NOTIFY.PRILOG (for OLDS)
DSN(IMS.OLDSP13) OLDS(DFSOLP13) -
FIRSTREC(001) -
SSID(IMSA)
/*

Example of Adding Information about Two Primary OLDSs to

RECON
In this example, you create a PRIOLDS for two OLDSs that belong to the IMS
online subsystem IMSA. Both OLDSs are closed. The first STARTIME parameter
specifies the time stamp of the opening of the primary OLDS. The DSN parameter
indicates that information that is added relates to the opening of the OLDS.
NXTOLDS indicates an OLDS switch. The second STARTIME parameter and
second DSN indicate the start time and DSN of the next OLDS. The third
STARTIME parameter indicates the start time of the OLDS to be closed. The
RUNTIME parameter is the time stamp of the closing volume.
NOTIFY.PRILOG SSID(IMSA) STARTIME(812171212120) OLDS(DFSOLP01) -
DSN(IMS.OLDP01) LASTREC(4999)
NOTIFY.PRILOG SSID(IMSA) STARTIME(812181212120) OLDS(DFSOLP01) -
DSN(IMS.OLDP02) NXTOLDS(DFSOLP02)
NOTIFY.PRILOG SSID(IMSA) STARTIME(812181212120) OLDS(DFSOLP02) -
RUNTIME(932191010101)
/*

Example of Creating a PRILOG to Record 2 OLDSs Opening and

Closing
In this example, you create a PRILOG to record the opening and closing of two
OLDSs. The new PRILOG follows an existing PRILOG record for GSG OURGRP,
which contains a log token of 1. The three commands are, respectively, OPEN,
SWITCH, and CLOSE.
NOTIFY.PRILOG SSID(IMSA) +
OLDS(OLDS001) DSN(IMS.OLDS.A01) STARTIME(930140830000) FIRSTREC(1) +
GSG(OURGRP) LOGTOKEN(2)

NOTIFY.PRILOG SSID(IMSA) +
OLDS(OLDS001) LASTREC(4999)+
NXTOLDS(OLDS002) DSN(IMS.OLDS.A02) STARTIME(930140930000) FIRSTREC(5000)

NOTIFY.PRILOG SSID(IMSA) +
OLDS(OLDS002) STARTIME(930140930000) +
RUNTIME(930141030000) LASTREC(9999)

NOTIFY.PRILOG (for RLDS)

OO NOTIFY.PRILOG DSN(name) STARTIME(timestamp) O
RUNTIME(timestamp)

O O
0 CHKPTID(chkptid) 1
CHKPTCT( value ) FILESEQ( value )

O O
FIRSTREC(number) GSG(gsgname) INTERIM LASTREC(number)

274 DBRC Guide & Reference

NOTIFY.PRILOG (for RLDS)
LOCAL RLDS
O O
LOGTOKEN(number) NONLOCAL SSID(name)

O OP
3400 VOLSER(volser)
UNIT( unittype )

Use a NOTIFY.PRILOG command to add information about a primary RLDS (or a

primary SLDS that a batch subsystem created) to RECON and to manually create
interim-primary log data set records in RECON.

This is information that could not be added to RECON from the IMS system log
processing exit routines. If you are processing DBDSs with IMS, you should not
need to use this command under normal operating conditions. You must specify a
NOTIFY.ALLOC command for each DBDS for which change records might exist on
the primary RLDS being added.

This command adds or completes a data set entry in a PRILOG record. If you are
modifying an existing completed data set entry, you should use the
CHANGE.PRILOG(RLDS) command.

Parameters
DSN(name) | RUNTIME(timestamp)
Mutually exclusive, required parameters.
DSN
Specifies the data set name of the primary RLDS for which a log record is
being created in RECON.
RUNTIME
Specifies the time stamp of a close or end-of-volume (EOV) operation for
the specified primary RLDS. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).

These two parameters are used in conjunction with the STARTIME and
VOLSER parameters to identify what type of primary-recovery-log-data set entry
is to be added to RECON.

Table 6 indicates which parameter combinations are required for each type of
primary-recovery-log-data-set entry:
Table 6. Parameters of NOTIFY.PRILOG (for RLDS) Command for Open, EOV, and Close
Type of Log Entry Required Keywords
RLDS Open STARTIME, DSN, VOLSER, FIRSTREC
RLDS EOV STARTIME, VOLSER, RUNTIME
RLDS Close STARTIME, RUNTIME, LASTREC

For each primary RLDS, you must issue a separate NOTIFY.PRILOG command
for open, zero or more EOVs, and close.
STARTIME(timestamp)
Required parameter you use to specify the starting time of a primary RLDS.

Chapter 14. NOTIFY Commands 275

NOTIFY.PRILOG (for RLDS)
The time stamp must be in standard form, see “Standard Time Stamp Format”
on page 101.
See Table 6 on page 275 for a description of the use of this parameter with
other parameters in the NOTIFY.PRILOG command.
CHKPTCT(0 | value)
Optional parameter you use to specify the number of checkpoints completed on
the RLDS volumes.
The valid values for CHKPTCT are:
0 No checkpoints in the RLDS volume
1 A single checkpoint in the RLDS volume
2 More than one checkpoint in the RLDS volume

IMS uses the value of CHKPTCT to determine which logs are necessary to
recover a Fast Path area with concurrent image copy.
CHKPTID(chkptid)
Optional parameter you use to specify the oldest checkpoint ID for an active
partition specification table (PST) on an RLDS volume. The checkpoint ID must
be in the standard form for a time stamp (see “Standard Time Stamp Format”
on page 101).
FILESEQ( 1 | value)
Optional parameter you use to specify the file sequence number of the primary
RLDS that is identified. You can specify this parameter only if you have
specified the VOLSER parameter.
FIRSTREC(number)
Optional parameter you use to specify the log record sequence number of the
first log record of the RLDS. For the first RLDS of the PRILOG, it corresponds
to the first log record that was written during initialization of the IMS subsystem.
FIRSTREC is required if DSN is specified and is invalid if RUNTIME is
specified.
The log record sequence number can be one of the following:
v A hexadecimal number
This number is 1 to 16 characters, enclosed in single quotes and preceded
by the letter, X. For example: FIRSTREC(X'10B9C').
v A decimal number
This number is a decimal number from 0 to (2**64)-1, without delimiters. For
example: FIRSTREC(68508).

In either case, leading zeros can be omitted.

GSG(gsgname)
Optional parameter you use to specify the GSG name of the IMS subsystem
that produced the RLDS.
GSG is required if NONLOCAL or LOGTOKEN is specified.
INTERIM
Optional parameter you use to specify that an interim log data set record is to
be created. Before you issue the NOTIFY.PRILOG INTERIM command, you must
create a corresponding primary recovery log record.

276 DBRC Guide & Reference

NOTIFY.PRILOG (for RLDS)
LASTREC(number)
Optional parameter you use to specify the log record sequence number of the
last log record of the RLDS.
LASTREC is required if RUNTIME is specified and VOLSER is not specified
(that is, on a CLOSE call). LASTREC is invalid if DSN is specified.
The log record sequence number can be one of the following:
v A hexadecimal number
This number is 1 to 16 characters, enclosed in single quotes and preceded
by the letter, X. For example: LASTREC(X'10B9C').
v A decimal number
This number is a decimal number from 0 to (2**64)-1, without delimiters. For
example: LASTREC(68508).

In either case, leading zeros can be omitted.

LOGTOKEN(number)
Optional parameter you use to specify the log token that is to be inserted into
the PRILOG record and, if necessary, into the GSG record. It is valid only on an
RLDS OPEN command; otherwise, it is ignored.
Log tokens are numeric, assigned sequentially within PRILOG records for the
same GSG, and used during recovery to ensure that all logs produced by
members of the GSG have been included. The highest token assigned to any
PRILOG is recorded in the GSG record.
The log token must satisfy all of the following conditions:
v Must be greater than that contained in the previous PRILOG record for the
same GSG, if any.
v Must be less than that contained in the next PRILOG record for the same
GSG, if any.
v Must not be more than one greater than the high PRILOG token contained in
the specified GSG record.
LOCAL | NONLOCAL
Mutually exclusive, optional parameters you use to specify where the RLDS
data was originally created. LOCAL is used if the RLDS was created by an
active IMS subsystem of the local service group. NONLOCAL is used if the
RLDS was originally created by an active IMS subsystem of the non-local
service group and transported to the tracking site.
LOCAL or NONLOCAL need only be specified when creating the PRILOG
record. The LOCAL and NONLOCAL keywords are ignored on subsequent
NOTIFY.PRILOG invocations for the PRILOG record.
If NONLOCAL is specified, none of the keywords CHKPTID, FILESEQ, UNIT, or
VOLSER can be specified (the data sets must be cataloged) on any
NOTIFY.PRILOG invocation for the PRILOG record.
RLDS
Optional parameter you use to specify that an RLDS record is to be created or
updated.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the log data set.
The SSID is an eight-character alphanumeric string that represents a valid IMS
subsystem identification name. If you do not specify SSID, DBRC uses the

Chapter 14. NOTIFY Commands 277

NOTIFY.PRILOG (for RLDS)
default subsystem identifier in the RECON header record. You use the
INIT.RECON or CHANGE.RECON command to set the default subsystem identifier in
the RECON header record. If you have not specified a default in the RECON
header record, you must specify SSID.
UNIT(3400 | unittype)
Optional parameter you use to specify the unit type of the RLDSs. You only
specify the UNIT parameter if you specify the DSN parameter. The unit type
can be up to eight alphanumeric characters long.
VOLSER(volser)
Optional parameter you use to specify the volume serial number of the log
volume being recorded for the identified primary RLDS. For an EOV notification,
this volume serial number is that of the volume being started.
You must use the VOLSER parameter during RLDS open and EOV processing.

Examples of Using the NOTIFY.PRILOG (for RLDS) Command

Here are some examples of using the NOTIFY.PRILOG (for RLDS) command.

Example of Adding Primary RLDS Information to RECON

In this example, information about a primary RLDS is to be added to the RECON.
The VOLSER and DSN parameters indicate that the information to be added relates
to the opening of the primary RLDS. The STARTIME parameter specifies the time
stamp of the opening of the primary RLDS. The first RUNTIME parameter specifies
the time stamp of the EOV of the first volume of the primary RLDS. The second
RUNTIME parameter specifies the time stamp of the closing volume of the primary
RLDS.
//NFYPRILG JOB
.
.
.

//SYSIN DD *
NOTIFY.PRILOG RLDS STARTIME(820670201010) -
VOLSER(VOL001) DSN(PRILOG1) FIRSTREC(001)
NOTIFY.PRILOG RLDS STARTIME(820670201010) -
VOLSER(VOL002) RUNTIME(820670202020)
NOTIFY.PRILOG RLDS STARTIME(820670201010) -
LASTREC(9999) RUNTIME(820670303030)
/*

Example of Adding Interim-Primary RLDS Information to RECON

In this example, information about the interim-primary RLDS is to be added to
RECON. The STARTIME parameter specifies the time stamp of the opening of the
interim primary RLDS.
//NFYPRILG JOB
.
.
.

//SYSIN DD *
NOTIFY.PRILOG RLDS STARTIME(822541234561) -
DSN(DSNIRLDS) -
VOLSER(VOL008) -
FIRSTREC(077) -
INTERIM
/*

278 DBRC Guide & Reference

NOTIFY.PRILOG (for RLDS)
Example of Creating a PRILOG Record for 2 Tracking Log DSs
In this example, the sequence of NOTIFY.PRILOG commands create a PRILOG
record for two log data sets that were received at a tracking site.
NOTIFY.PRILOG RLDS DSN(RECEIVED.DSN1) STARTIME(911230405235) -
NONLOCAL SSID(IMSA) GSG(MYGSG) FIRSTREC(1) -
VOLSER(VOL003)
NOTIFY.PRILOG RLDS RUNTIME(911230500000) STARTIME(911230405235) -
LASTREC(2376)
NOTIFY.PRILOG RLDS DSN(RECEIVED.DSN2) STARTIME(911230405235) -
FIRSTREC(2377) VOLSER(VOL002)
NOTIFY.PRILOG RLDS RUNTIME(911230700000) STARTIME(911230405235) -
LASTREC(4378)

NOTIFY.PRILOG (for SLDS and TSLDS)

OO NOTIFY.PRILOG SLDS DSN(name) STARTIME(timestamp) O
TSLDS RUNTIME(timestamp)

O O
CHKPTCT(value) CHKPTID(chkptid) 1
FILESEQ( value )

LOCAL
O O
FIRSTREC(number) GSG(gsgname) INTERIM LASTREC(number) NONLOCAL

O OP
SSID(name) 3400 VOLSER(volser)
UNIT( unittype )

Use a NOTIFY.PRILOG command to add information about a primary SLDS or TSLDS

to RECON and to manually create interim-primary log data set records in RECON.
This is information that could not be added to RECON from the IMS system log
processing exit routines.

If you are processing DBDSs with IMS, you should not need to use this command
under normal operating conditions. You must specify a NOTIFY.ALLOC command for
each DBDS for which change records might exist on the primary SLDS being
added.

This command adds or completes a data set entry in the PRISLD or PRITSLDS
record. If you are modifying an existing completed data set entry, you should use
the CHANGE.PRILOG (for SLDS) or CHANGE.PRILOG (for TSLDS) command.

When you issue a NOTIFY.PRILOG for a SLDS, a PRILOG record must exist for the
corresponding RLDS. Use NOTIFY.PRILOG (for RLDS) to add information about a
SLDS that a batch subsystem creates, because DBRC considers such a data set to
be an RLDS.

Parameters
SLDS
Required parameter you use to specify that a record is to be created or updated
for a SLDS.

Chapter 14. NOTIFY Commands 279

NOTIFY.PRILOG (for SLDS and TSLDS)
Important: If you do not specify SLDS or TSLDS, the default is RLDS (see
“NOTIFY.PRILOG (for RLDS)” on page 274).
TSLDS
Required parameter you use to specify that a record is to be created or updated
for a SLDS on an RSR tracking subsystem.
Important: If you do not specify SLDS or TSLDS, the default is RLDS (see
“NOTIFY.PRILOG (for RLDS)” on page 274)
DSN(name) | RUNTIME(timestamp)
Mutually exclusive, required parameters.
DSN
Specifies the data set name of the primary SLDS or TSLDS for which a log
record is being created in RECON.
RUNTIME
Specifies the time stamp of a close or EOV operation for the specified
primary SLDS or TSLDS. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).

These two parameters are used in conjunction with the STARTIME and
VOLSER parameters to identify what type of primary-system-log-data-set entry
is to be added to RECON. Table 7 indicates which parameter combinations are
required for each type of primary-system-log-data set entry.
Table 7. Parameters of NOTIFY.PRILOG (SLDS or TSLDS) Command for Open, EOV, and
Close
Type of Log Entry Required Keywords
SLDS Open STARTIME, DSN, VOLSER, FIRSTREC
SLDS EOV STARTIME, VOLSER, RUNTIME
SLDS Close STARTIME, RUNTIME, LASTREC

For each primary SLDS or TSLDS, you must issue a separate NOTIFY.PRILOG
command for open, zero or more EOVs, and close.
STARTIME(timestamp)
Required parameter you use to specify the starting time of a primary SLDS or
TSLDS. Use the log start time from the subsystem record or the PRILOG
record. The time stamp must be in standard form (see “Standard Time Stamp
Format” on page 101).
See Table 7 for a description of the use of this parameter with other parameters
in the NOTIFY.PRILOG command.
CHKPTCT(value)
Optional parameter you use to change the number of checkpoints completed on
the SLDS or TSLDS volumes. You specify a value for each SLDS or TSLDS
volume that is designated
The valid values for CHKPTCT are:
0 No checkpoints in the SLDS or TSLDS volume
1 A single checkpoint in the SLDS or TSLDS volume
2 More than one checkpoint in the SLDS or TSLDS volume

280 DBRC Guide & Reference

NOTIFY.PRILOG (for SLDS and TSLDS)
IMS uses the value of CHKPTCT to determine which logs are necessary to
recover a Fast Path area with concurrent image copy.
CHKPTID(chkptid)
Optional parameter you use to specify the oldest checkpoint ID for an active
PST on an SLDS or TSLDS volume. The checkpoint ID must be in the standard
form for a time stamp (see “Standard Time Stamp Format” on page 101).
FILESEQ(1 | value)
Optional parameter you use to specify the file sequence number of the primary
SLDS or TSLDS that is identified. You specify this parameter only if you have
also specified the VOLSER parameter.
FIRSTREC(number)
Optional parameter you use to specify the log record sequence number of the
first log record of the SLDS or TSLDS. For the first SLDS of the PRISLD or
TSLDS of the PRITSLDS, FIRSTREC corresponds to the first log record that
was written during initialization of the IMS subsystem.
FIRSTREC is required if DSN is specified and is invalid if RUNTIME is
specified.
The log record sequence number can be one of the following:
v A hexadecimal number
This number is 1 to 16 characters, enclosed in single quotes and preceded
by the letter, X. For example: FIRSTREC(X'10B9C').
v A decimal number
This number is a decimal number from 0 to (2**64)-1, without delimiters. For
example: FIRSTREC(68508).

In either case, leading zeros can be omitted.

GSG(gsgname)
Optional parameter you use to specify the GSG name of the IMS subsystem
that produced the SLDS or TSLDS.
GSG is required if NONLOCAL is specified.
INTERIM
Optional parameter you use to specify that an interim log data set record is to
be created.
LASTREC(number)
Optional parameter you use to specify the log record sequence number of the
last log record of the SLDS or TSLDS.
LASTREC is required if RUNTIME is specified and VOLSER is not specified
(that is, on a CLOSE call). LASTREC is invalid if DSN is specified.
The log record sequence number can be one of the following:
v A hexadecimal number
This number is 1 to 16 characters, enclosed in single quotes and preceded
by the letter, X. For example: LASTREC(X'10B9C').
v A decimal number
This number is a decimal number from 0 to (2**64)-1, without delimiters. For
example: LASTREC(68508).

In either case, leading zeros can be omitted.

Chapter 14. NOTIFY Commands 281

NOTIFY.PRILOG (for SLDS and TSLDS)
LOCAL | NONLOCAL
Mutually exclusive, optional parameters you use to specify where the SLDS or
TSLDS data was originally created. LOCAL is used if the SLDS or TSLDS was
created by an active IMS subsystem of the local service group. NONLOCAL is
used if the SLDS or TSLDS was originally created by an active IMS subsystem
of the non-local service group and transported to the tracking site.
LOCAL or NONLOCAL need only be specified when creating the PRISLDS or
PRITSLDS record. The LOCAL and NONLOCAL keywords are ignored on
subsequent NOTIFY.PRILOG invocations for the PRISLD or PRITSLDS record.
If NONLOCAL is specified, none of the keywords CHKPTID, FILESEQ, UNIT, or
VOLSER can be specified (the data sets must be cataloged) on any
NOTIFY.PRILOG invocation for the PRISLD or PRITSLDS record.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the log data set.
The SSID is an eight-character, alphanumeric string that represents a valid IMS
subsystem identification name. If you do not specify SSID, DBRC uses the
default subsystem identifier in the RECON header record. You use the
INIT.RECON or CHANGE.RECON command to set the default subsystem identifier in
the RECON header record. If you have not specified a default in the RECON
header record, you must specify SSID.
UNIT(3400 | unittype)
Optional parameter you use to specify the unit type of the SLDSs or TSLDSs.
You only specify the UNIT parameter if you specify the DSN parameter. The
unit type can be up to eight alphanumeric characters.
VOLSER(volser)
Optional parameter you use to specify the volume serial number of the log
volume being recorded for the identified primary SLDS or TSLDS. For an EOV
notification, this volume serial number is that of the volume being started.

Note: You must use the VOLSER parameter during SLDS or TSLDS open and
EOV.

Example of Adding Primary SLDS Information to RECON

In this example, information about a primary SLDS is to be added to RECON. The
VOLSER and DSN parameters indicate that the information to be added relates to
the opening of the primary SLDS. The STARTIME parameter specifies the time
stamp of the opening of the primary SLDS. The first RUNTIME parameter specifies
the time stamp of the EOV of the first volume of the primary SLDS. The second
RUNTIME parameter specifies the time stamp of the closing volume of the primary
SLDS.
//NFYPRILG JOB
.
.
.

//SYSIN DD *
NOTIFY.PRILOG SLDS STARTIME(820670201010) -
VOLSER(VOL004) DSN(PRILOG4) FIRSTREC(7000)
NOTIFY.PRILOG SLDS STARTIME(820670201010) -
VOLSER(VOL005) RUNTIME(820670202020)
NOTIFY.PRILOG SLDS STARTIME(820670201010) -
RUNTIME(820670303030) LASTREC(8889)
/*

282 DBRC Guide & Reference

NOTIFY.RECOV

NOTIFY.RECOV
OO NOTIFY.RECOV DBD(name) DDN(name) O
AREA(name) RCVTIME(timestamp) RCVUSID(usid)

CURRENT DBDS
O OP
RUNUSID(usid) ADDN(name) RUNTIME(timestamp) TRACK
PITR

Use a NOTIFY.RECOV command to add information about recovery of a specified

DBDS or DEDB area to RECON. You must use this command whenever you
perform the recovery of a DBDS or DEDB area in any way other than using the
Database Recovery utility (for example, by restoring the DASD volume on which the
DBDS or area resides). In addition, you can notify DBRC when you recover a
DBDS or DEDB area using the Database Recovery utility.

When specifying the RCVTIME parameter to inform DBRC of a time stamp

recovery, RECON must contain a record of the image copy data set that you used
to restore the DBDS or DEDB area. The image copy record can be either a
standard or a nonstandard image copy. If it is a nonstandard image copy, then its
time stamp cannot fall within the range of an existing time stamp recovery (the time
between the RECOV TO and RUN times). The time stamp of the image copy record
must be equal to that specified in the RCVTIME parameter of the NOTIFY.RECOV
command.

In a data sharing environment, after you notify DBRC of a nonstandard recovery or

an IMS recovery, DBRC turns off the recovery-needed flag and decreases the
counter in the appropriate DBDS and DB records in RECON.

Related Reading: See IMS Version 7 Operations Guide for more information
about recovery in a data sharing environment.

Restriction: This command is not allowed for ILDS or Index DBDSs of HALDB
partitions.

Parameters
DBD(name)
Required parameter you use to specify the database name of the DBDS or
DEDB area.
DDN(name) | AREA(name)
Mutually exclusive, required parameters you use to specify the ddname of the
DBDS or DEDB area for which DBRC is to add the database recovery record to
RECON.
ADDN(name)
Optional parameter you use to specify the ADS DD name of the ADS for which
a Fast Path DEDB area recovery record is being added to RECON.
You can specify this parameter only when you specify the AREA(name)
parameter.

Chapter 14. NOTIFY Commands 283

NOTIFY.RECOV
CURRENT | RUNTIME(timestamp)PITR
Mutually exclusive, optional parameters you use to specify the time stamp at
which the DBDS or DEDB area was recovered.
CURRENT
Specifies that the current time stamp is to be used as the time stamp of the
recovery. You can add the recovery information to RECON in a later step of
the same job that performs the recovery if you specify CURRENT.
RUNTIME
Specifies the actual time stamp of a recovery of the DBDS or DEDB area.
The time stamp must be in standard form (see “Standard Time Stamp
Format” on page 101).
The optional PITR parameter specifies a point-in-time recovery. You must
use the RCVTIME parameter if you use PITR.
DBDS | TRACK
Mutually exclusive, optional parameters you use to specify the type of IMS
recovery that was done on a DBDS or DEDB area.
DBDS
Specifies that the recovery was a full recovery or a timestamp recovery.
TRACK
Specifies that the recovery was a track recovery.

If you specify this parameter and the RCVTIME parameter, the command fails.
RCVTIME(timestamp)
Optional parameter you use to specify the point in time to which the DBDS or
DEDB area was restored. It can be any time when the DBDS or area was not
being updated, that is, a time that is not covered by an active ALLOC record in
RECON.
If you do not specify the RCVTIME parameter, you are notifying DBRC of a full
recovery.
If you specify RCVTIME and the database or DEDB area is covered by RSR,
you must also specify RCVUSID.
You must use RCVTIME if you use the RUNTME parameter with the PITR
parameter.
Restriction: Do not use the RCVTIME parameter when recovering from a
nonstandard image copy at a tracking subsystem.
See 211 for more information on the RCVTIME parameter.
RCVUSID(usid)
Optional parameter you use to specify the effective update set identifier (USID)
to which the DBD or DEDB area was recovered.
This parameter must be specified if the database or DEDB area is covered by
RSR and RCVTIME was specified; it is not allowed if RCVTIME is not specified.
The usid you use is the one in the listing of the IMAGE record.
RUNUSID(usid)
Optional parameter you use to specify the current update set identifier (usid) at
the time the database or DEDB area was recovered. If this is a receive,
RUNUSID is the usid of the image copy that was used for recovery.
RUNUSID must be specified for recovery of an RSR-covered database or
DEDB area.

284 DBRC Guide & Reference

NOTIFY.RECOV
Example of Adding DBDS Recovery Information to RECON
In this example, information about recovery of a specified DBDS is to be added to
RECON. The RUNTIME parameter specifies the time stamp of the recovery of the
DBDS. The PITR parameter specifies a point-in-time recovery. The RCVTIME
parameter specifies the time stamp to which the specified DBDS was recovered.
//NFYRECOV JOB
.
.
.

//SYSIN DD *
NOTIFY.RECOV DBD(DB1) DDN(DDN1) -
RUNTIME(971351015366) -
RCVTIME(971350905297) -
PITR
/*

After the command is executed, a listing of the RECON shows the RECOV record,
as illustrated below.

RECOV
RUN = 1997.135 10:15:36.6 -08:00 * RUN USID = 0000000005
RECOV TO= 1997.135 09:05:29.7 -08:00 RECOV TO USID = 0000000004
POINT-IN-TIME

NOTIFY.REORG
CURRENT
OO NOTIFY.REORG DBD(name) DDN(name) O
RUNTIME(timestamp)

O O
1 1 ICDSN(name)
FILESEQ( value ) FILESEQ2( value )

O O
ICDSN2(name) RECDCT(value) 3400
UNIT( unittype )

O O
3400 ,
UNIT2( unittype )
VOLLIST( S volser )

O OP
, USID(value)

VOLLIST2( S volser )

Use a NOTIFY.REORG command to add a record to RECON about the reorganization

of the database to which an identified DBDS belongs.

Chapter 14. NOTIFY Commands 285

NOTIFY.REORG
The information in the reorganization record is used by DBRC to determine which
image copy data sets, change accumulation data sets, and log data sets are valid
as input to a subsequent recovery of the identified DBDS.

Restrictions:
v This command should not be used following the reorganization of a Fast Path
DEDB. Such data bases can be recovered across a reorganization.
v This command turns on the flag needed by the image copy process in the DBDS
record. You must either run an image copy or issue the CHANGE.DBDS ICOFF
command to turn off the flag.
v This command can also be used to record in RECON the equivalent of an image
copy data set that was created for the HISAM Reorganization Reload utility. Use
this command only if you are using these logs as an image copy data set.
v All optional parameters except CURRENT or RUNTIME apply only to the image
copy data set that was created as part of the processing by the HISAM
Reorganization Reload utility.
v You must specify a NOTIFY.REORG command for each DBDS in the database that
was reorganized. A DD statement for the IMS DBDLIB data set must be provided
in the job stream of the NOTIFY.REORG command.
v The NOTIFY.REORG command, and database reorganization in general, are invalid
for databases at an RSR tracking site.
v The NOTIFY.REORG command is not allowed for ILDS or Index DBDSs of HALDB
partitions.

Parameters
DBD(name)
Required parameter you use to identify the database name of the DBDS that
was reorganized.
DDN(name)
Required parameter you use to identify the data set ddname of the DBDS that
was reorganized.
CURRENT | RUNTIME(timestamp)
Mutually exclusive, optional parameters you use to specify the time stamp of
the reorganization of the identified DBDS.
CURRENT
Specifies that the current time stamp is to be placed in the reorganization
record. You can specify a NOTIFY.REORG command as a later step in the
same job that performs the reorganization if you specify CURRENT.
RUNTIME
Specifies that the actual time stamp of the reorganization is to be placed in
the reorganization record. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).
FILESEQ(1 | value)
Optional parameter you use to specify the file sequence number of the
identified DBDS that was included in the logs that were used as input to a run
of the HISAM Reorganization Reload utility. The description of the ICDSN
parameter contains information about the log data set with which this parameter
is associated. You use this parameter only when the VOLLIST parameter has
also been specified.

286 DBRC Guide & Reference

NOTIFY.REORG
FILESEQ2(1 | value)
Optional parameter you use to specify the file sequence number of the
identified DBDS when it was included in the logs that were used as input to the
HISAM Reorganization Reload utility. The description of the ICDSN2 parameter
contains information about the log data set with which this parameter is
associated. You use this parameter only when the VOLLIST2 parameter has
also been specified.
ICDSN(name)
Optional parameter you use to specify the data set name of the image copy
data set that was created as part of a HISAM reorganization of a database. (If
you reorganized your database using the HISAM Reorganization Reload utility,
the logs that were used as input to that utility can be used as image copy data
sets.)
You can specify an ICDSN parameter only if the corresponding DBDS was
identified to RECON with the NOREUSE attribute in an INIT.DBDS command.
ICDSN2(name)
Optional parameter you use to specify the data set name of the duplicate image
copy data set that was created as part of a HISAM reorganization of a
database. (If you reorganized your database using the HISAM Reorganization
Reload utility, the logs that were used as input to that utility can be used as
image copy data sets.)
You can specify an ICDSN2 parameter only if you have specified an ICDSN
parameter.
RECDCT(value)
Optional parameter you use to specify the number of records that are contained
in the identified DBDS. value must be a decimal number from 1 to
2 147 483 647.
UNIT(3400 | unittype)
Optional parameter you use to specify the unit type of the volumes on which the
image copy data set resides. The unit type can be up to eight alphanumeric
characters.
UNIT2(3400 | unittype)
Optional parameter you use to specify the unit type of the volumes on which the
duplicate image copy data set resides. The unit type can be up to eight
alphanumeric characters.
VOLLIST(volser)
Optional parameter you use to specify the volume serial numbers of the
volumes on which the image copy data set identified by the ICDSN keyword
resides. You can specify up to 255 volume serial numbers for volser; each
volser can be up to six alphanumeric characters.
VOLLIST2(volser)
Optional parameter you use to specify the volume serial numbers of the
volumes on which the duplicate image copy data set, identified by the ICDSN2
parameter, resides. You can specify up to 255 volume serial numbers for volser;
each can be up to six alphanumeric characters.
USID(value)
Optional parameter you use to specify the update set identifier of the database
or area when the reorganization occurred.
USID is required if the database or area is assigned to a global service group. If
the database or area is not assigned to a GSG, USID is optional.

Chapter 14. NOTIFY Commands 287

NOTIFY.REORG
Example Adding DBDS Reorganization Information to RECON
In this example, information about a reorganization of a specified DBDS is to be
added to RECON. The DBDLIB data set is specified, because DBRC requests a
search of it to verify that the reorganization occurred. The names of two image copy
data sets for the reorganized DBDS are given. They both follow the data set
naming convention, and a list of volumes is provided for both image copy data sets.
//NFYREORG JOB
.
.
.

//IMS DD DSN=IMS.DBDLIB,DISP=SHR
//SYSIN DD *
NOTIFY.REORG DBD(DB1) DDN(DD1) -
ICDSN(IMS.DB1.DD1.IC.ICDSN) -
VOLLIST(VOL001,VOL002,VOL003) FILESEQ(4) -
ICDSN2(IMS.DB1.DD1.IC2.ICDSN2) -
VOLLIST2(VOL004,VOL005,VOL006,VOL007) -
FILESEQ2(4) RECDCT(12345)
/*

NOTIFY.SECLOG (for OLDS)

OO NOTIFY.SECLOG OLDS(ddname) DSN(name) STARTIME(timestamp) O
RUNTIME(timestamp)

O O
FIRSTREC(number) GSG(gsgname) INTERIM LASTREC(number)

O OP
NXTOLDS(ddname) SSID(name)

Use a NOTIFY.SECLOG command to add information about a secondary OLDS to

RECON and to manually create an ISECOLDS record in RECON. RECON must
already contain a PRIOLDS record with the same SSID and STARTIME. This is
information that could not be added from the IMS log data exit routines. This
command is not normally required.

Parameters
OLDS(ddname)
Required parameter you use to specify that a record is to be created or updated
in RECON for the OLDS.
ddname is the ddname that the IMS online control region used when it used the
OLDS.
DSN(name) | RUNTIME(timestamp)
Mutually exclusive, required parameters.
DSN
Specifies the data set name of the secondary OLDS for which an online log
record is being created in RECON.

288 DBRC Guide & Reference

NOTIFY.SECLOG (for OLDS)
RUNTIME
Specifies the time stamp of an open or close operation of the specified
secondary OLDS. The time stamp must be in standard form (see “Standard
Time Stamp Format” on page 101).

DSN and RUNTIME are used in conjunction with the STARTIME and NXTOLDS
parameters to identify which type of secondary-online-log-data-set entry is to be
added to RECON. Table 8 indicates the keyword combinations that correspond
to the type of secondary-online-log data-set entry:
Table 8. Parameters of NOTIFY.SECLOG (for OLDS) Command for Open, Switch, and Close
Type of Online Log Entry Required Keywords
OLDS Open STARTIME, DSN, FIRSTREC
OLDS Switch FIRSTREC, STARTIME, DSN, NXTOLDS
OLDS Close LASTREC, STARTIME, RUNTIME

For each secondary OLDS, you must issue a separate NOTIFY.SECLOG

command for open, switch, and close operations.
STARTIME(timestamp)
Required parameter you use to specify the starting time of a secondary OLDS.
The time stamp must be in standard form (see “Standard Time Stamp Format”
on page 101).
See Table 8 for a description of the use of this parameter with other parameters
in the NOTIFY.SECLOG command.
FIRSTREC(number)
Optional parameter you use to specify the log record sequence number of the
first log record of the OLDS. For the first OLDS of the SECLOG, FIRSTREC
corresponds to the first log record that was written during initialization of the
IMS subsystem.
FIRSTREC is required for OLDS OPEN and SWITCH commands. It specifies the
first log record sequence number on the OLDS being opened. It is invalid for a
CLOSE command.
The log record sequence number can be one of the following:
v A hexadecimal number
This number is 1 to 16 characters, enclosed in single quotes and preceded
by the letter, X. For example: FIRSTREC(X'10B9C').
v A decimal number
This number is a decimal number from 0 to (2**64)-1, without delimiters. For
example: FIRSTREC(68508).

In either case, leading zeros can be omitted.

Chapter 14. NOTIFY Commands 289

NOTIFY.SECLOG (for OLDS)
LASTREC(number)
Optional parameter you use to specify the log record sequence number of the
last log record of the OLDS.
LASTREC is required for the OLDS CLOSEcommand. It is optional for the SWITCH
command; if it is omitted, the FIRSTREC value minus 1, is recorded for the
OLDS being closed. It is invalid for an OPEN command.
The log record sequence number can be one of the following:
v A hexadecimal number
This number is 1 to 16 characters, enclosed in single quotes and preceded
by the letter, X. For example: LASTREC(X'10B9C').
v A decimal number
This number is a decimal number from 0 to (2**64)-1, without delimiters. For
example: LASTREC(68508).

In either case, leading zeros can be omitted.

NXTOLDS(ddname)
Optional parameter you use when RECON is to be updated to reflect an OLDS
switch. The current OLDS is closed and an IMS online control region opens a
new OLDS. ddname is the DD statement of the OLDS being opened. You
specify the OLDS being closed with the OLDS(ddname) parameter. Use the
DSN parameter to specify the data set name of the OLDS being opened. Use
the STARTIME parameter to specify the close time of the OLDS being closed
and the open time of the OLDS being opened.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the log data set.
The SSID is an eight-character alphanumeric string that represents a valid IMS
subsystem identification name. If you do not specify SSID, DBRC uses the
default subsystem identifier in the RECON header record. You use the
INIT.RECON or CHANGE.RECON command to set the default subsystem identifier in
the RECON header record. If you have not specified a default in the RECON
header record, you must specify SSID.

Examples of Using the NOTIFY.SECLOG (for OLDS) Command

Here are some examples of using the NOTIFY.SECLOG (for OLDS)command.

Example of Creating the ISECOLDS Record That Corresponds to

the OLDS
In this example, an ISECOLDS record corresponding to the OLDS is created.
//NFYSECLG JOB
.
.
.

//SYSIN DD *
NOTIFY.SECLOG SSID(IMSA) OLDS(DFSOLS03) -
DSN(IMS.INTERIM.LOG) -
STARTIME(823220522348) -
INTERIM
/*

Example of Creating a SECOLDS Record for 2 Secondary OLDSs

In this example, you create a SECOLDS record for two secondary OLDSs that
belong to IMS online subsystem IMSA. Both secondary OLDSs are closed. The first

290 DBRC Guide & Reference

NOTIFY.SECLOG (for OLDS)
STARTIME parameter specifies the time stamp of the opening of the primary OLDS.
The DSN parameter indicates that information added relates to the opening of the
OLDS. NXTOLDS indicates an OLDS switch. The second STARTIME parameter
and second DSN indicate the start time and DSN of the next OLDS. The third
STARTIME parameter indicates the start time of the OLDS to be closed. The
RUNTIME parameter is the time stamp of the closing volume.
NOTIFY.SECLOG SSID(IMSA) STARTIME(812171212120) OLDS(DFSOLS01)-
DSN(IMS.OLSS01)
NOTIFY.SECLOG SSID(IMSA) STARTIME(812181212120) OLDS(DFSOLS01)-
DSN(IMS.OLSS02) NXTOLDS(DFSOLS02)
NOTIFY.SECLOG SSID(IMSA) STARTIME(812181212120) OLDS(DFSOLS02)-
RUNTIME(932191010101)

NOTIFY.SECLOG (for RLDS)

OO NOTIFY.SECLOG DSN(name) STARTIME(timestamp) O
RUNTIME(timestamp)

O O
0 CHKPTID(chkptid) 1
CHKPTCT( value ) FILESEQ( value )

LOCAL
O O
FIRSTREC(number) GSG(gsgname) INTERIM LASTREC(number) NONLOCAL

O OP
RLDS SSID(name) 3400 VOLSER(volser)
UNIT( unittype )

Use a NOTIFY.SECLOG command to add information about a secondary RLDS to

RECON and to manually create an ISECLOG record in RECON. RECON must
already contain a PRILOG with the same SSID and STARTIME. This is information
that could not be added from the IMS log data exit routines. This command is not
normally required.

This command adds or completes a data set entry in the Primary Log record. If you
are modifying an existing completed data set entry, you should use the
CHANGE.SECLOG (RLDS)command.

Parameters
DSN(name) | RUNTIME(timestamp)
Mutually exclusive, required parameters.
DSN
Specifies the data set name of the secondary RLDS for which a recovery
log record is being created in RECON.
RUNTIME
Specifies the time stamp of an open, close, or EOV operation of the
specified secondary RLDS. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).

Chapter 14. NOTIFY Commands 291

NOTIFY.SECLOG (for RLDS)
DSN and RUNTIME are used in conjunction with the STARTIME and VOLSER
parameters to identify which type of secondary recovery log data set entry is to
be added to RECON. Table 9 indicates the keyword combinations that
correspond to the type of secondary recovery log data set entry.
Table 9. Parameters of NOTIFY.SECLOG (for RLDS) Command for Open, EOV, and Close
Type of Recovery Log Entry Required Keywords
RLDS Open STARTIME, DSN, VOLSER
RLDS EOV STARTIME, VOLSER, RUNTIME
RLDS Close STARTIME, RUNTIME

For each secondary RLDS, you must issue a separate NOTIFY.SECLOG command
for open, zero or more ends-of-volume, and close processing.
STARTIME(timestamp)
Required parameter you use to specify the starting time of a secondary RLDS.
The time stamp must be in standard form (see “Standard Time Stamp Format”
on page 101).
If you issue a subsequent STARTIME parameter, that time is the start time of
the volume. See Table 9 for a description of the use of this parameter with other
parameters in the NOTIFY.SECLOG command.
CHKPTCT(0 | value)
Optional parameter you use to change the number of checkpoints completed on
the RLDS volumes.
The valid values for CHKPTCT are:
0 No checkpoints in the RLDS volume
1 A single checkpoint in the RLDS volume
2 More than one checkpoint in the RLDS volume

IMS uses the value of CHKPTCT to determine which logs are necessary to
recover a Fast Path area with concurrent image copy.
CHKPTID(chkptid)
Optional parameter you use to specify the oldest checkpoint ID for an active
PST on an RLDS volume. The checkpoint ID must be in standard form for a
time stamp (see “Standard Time Stamp Format” on page 101).
FILESEQ(1 | value)
Optional parameter you use to specify the file sequence number of the
secondary RLDS that is identified. You specify this parameter only if you have
also specified the VOLSER parameter.
FIRSTREC(number)
Optional parameter you use to specify the log record sequence number of the
first log record of the RLDS. For the first RLDS of the SECLOG, it corresponds
to the first log record that was written during initialization of the IMS subsystem.
FIRSTREC is required if DSN is specified and is invalid if RUNTIME is
specified.
The log record sequence number can be one of the following:
v A hexadecimal number
This number is 1 to 16 characters, enclosed in single quotes and preceded
by the letter, X. For example: FIRSTREC(X'10B9C').

292 DBRC Guide & Reference

NOTIFY.SECLOG (for RLDS)
v A decimal number
This number is a decimal number from 0 to (2**64)-1, without delimiters. For
example: FIRSTREC(68508).

In either case, leading zeros can be omitted.

GSG(gsgname)
Optional parameter you use to specify the GSG name of the IMS subsystem
that produced the RLDS.
GSG is required if NONLOCAL is specified.
INTERIM
Optional parameter you use to specify that an interim log data set record is to
be created.
LASTREC(number)
Optional parameter you use to specify the log record sequence number of the
last log record of the RLDS.
LASTREC is required if RUNTIME is specified and VOLSER is not specified
(that is, on a Close call). LASTREC is invalid if DSN is specified.
The log record sequence number can be one of the following:
v A hexadecimal number
This number is 1 to 16 characters, enclosed in single quotes and preceded
by the letter, X. For example: LASTREC(X'10B9C').
v A decimal number
This number is a decimal number from 0 to (2**64)-1, without delimiters. For
example: LASTREC(68508).

In either case, leading zeros can be omitted.

LOCAL | NONLOCAL
Mutually exclusive, optional parameters you use to specify where the RLDS
data was originally created. LOCAL is used if the RLDS was created by an
active IMS subsystem of the local service group. NONLOCAL is used if the
RLDS was originally created by an active IMS subsystem of the non-local
service group and transported to the tracking site.
LOCAL or NONLOCAL need only be specified when creating the SECLOG
record. The LOCAL and NONLOCAL keywords are ignored on subsequent
NOTIFY.SECLOG invocations for the SECLOG record.
If NONLOCAL is specified, none of the keywords CHKPTID, FILESEQ, UNIT, or
VOLSER can be specified (the data sets must be cataloged) on any
NOTIFY.SECLOG invocation for the SECLOG record.
RLDS
Optional parameter you use to specify that a record is to be created or updated
in RECON for an IMS RLDS.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the log data set.
The SSID is an eight-character alphanumeric string that represents a valid IMS
subsystem identification name. If you do not specify SSID, DBRC uses the
default subsystem identifier in the RECON header record. You use the

Chapter 14. NOTIFY Commands 293

NOTIFY.SECLOG (for RLDS)
INIT.RECON or CHANGE.RECON command to set the default subsystem identifier in
the RECON header record. If you have not specified a default in the RECON
header record, you must specify SSID.
UNIT(3400 | unittype)
Optional parameter you use to specify the unit type of the volumes on which the
secondary RLDSs reside. You only specify the UNIT parameter if you specify
the DSN parameter. The unit type can be up to eight alphanumeric characters.
VOLSER(volser)
Optional parameter you use to specify the volume serial number of the recovery
log volume that is being recorded for the identified secondary RLDS. For an
EOV notification, this volume serial number is that of the volume being started.
Table 9 on page 292 identifies when you use the VOLSER parameter.

Examples of Using the NOTIFY.SECLOG (for RLDS) Command

Here are some examples of using the NOTIFY.SECLOG (for RLDS) command.

Example of Adding Secondary RLDS Information to RECON

In this example, information about a secondary RLDS is to be added to RECON.
The STARTIME parameter identifies the secondary RLDS by its opening time
stamp. The VOLSER and DSN parameters indicate that the information to be added
relates to the opening of the primary RLDS. The first RUNTIME parameter specifies
the time stamp of the EOV of the secondary RLDS. The second RUNTIME
parameter specifies the time stamp of the closing of the secondary RLDS.
//NFYSECLG JOB
.
.
.

//SYSIN DD *
NOTIFY.SECLOG RLDS STARTIME(820670201010) -
DSN(DSN003) VOLSER (VOL001)
NOTIFY.SECLOG RLDS STARTIME(820670201010) -
RUNTIME(820680204500) VOLSER(VOL002)
NOTIFY.SECLOG RLDS STARTIME(820670201010) -
RUNTIME(820682030000)
/*

Example of Adding Interim Secondary RLDS Information to

RECON
In this example, information about the interim secondary RLDS is to be added to
RECON. The STARTIME parameter specifies the time stamp of the opening of the
interim-secondary RLDS, and the RUNTIME parameter specifies the time stamp of
the closing of the interim-secondary RLDS.
//NFYSECLG JOB
.
.
.

//SYSIN DD *
NOTIFY.SECLOG RLDS RUNTIME(822561630000)-
STARTIME(822541234561) INTERIM
/*

NOTIFY.SECLOG (for SLDS and TSLDS)

OO NOTIFY.SECLOG SLDS DSN(name) STARTIME(timestamp) O
TSLDS RUNTIME(timestamp)

294 DBRC Guide & Reference

NOTIFY.SECLOG (for SLDS and TSLDS)
O O
0 CHKPTID(chkptid) 1
CHKPTCT( value ) FILESEQ( value )

LOCAL
O O
FIRSTREC(number) GSG(gsgname) INTERIM LASTREC(number) NONLOCAL

O OP
SSID(name) 3400 VOLSER(volser)
UNIT( unittype )

Use a NOTIFY.SECLOG command to add information about a secondary SLDS or

TSLDS to RECON and to manually create an ISECSLDS record in RECON.
RECON must already contain a primary log data set record with the same SSID
and STARTIME. This is information that could not be added from the log data exists
of the IMS system. This command is not normally required.

This command adds or completes a data set entry in the Primary or Secondary Log
record. If you are modifying an existing completed data set entry, use the
CHANGE.SECLOG (for SLDS) command or the CHANGE.SECLOG (for TSLDS) command.

Parameters
SLDS
Required parameter you use to specify that an SLDS record is to be created.
If you do not specify SLDS or TSLDS, the default is RLDS. See
“NOTIFY.PRILOG (for RLDS)” on page 274 for more information on the RLDS
parameter.
TSLDS
Required parameter you use to specify that a TSLDS record is to be created.
If you do not specify SLDS or TSLDS, the default is RLDS. See
“NOTIFY.PRILOG (for RLDS)” on page 274 for more information on the RLDS
parameter.
DSN(name) | RUNTIME(timestamp)
Mutually exclusive, required parameters.
DSN
Specifies the data set name of the secondary SLDS or TSLDS for which a
system log record is being created in RECON.
RUNTIME
Specifies the time stamp of an open, close, or EOV operation of the
specified secondary SLDS. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).

DSN and RUNTIME are used in conjunction with the STARTIME and VOLSER
parameters to identify which type of secondary system log data set entry is to
be added to RECON. Table 10 indicates the keyword combinations that
correspond to the type of secondary system log data set entry.

Chapter 14. NOTIFY Commands 295

NOTIFY.SECLOG (for SLDS and TSLDS)
Table 10. Parameters of NOTIFY.SECLOG (for SLDS or TSLDS) Command for Open, EOV,
and Close
Type of System Log Entry Required Keywords
SLDS Open STARTIME, DSN, VOLSER
SLDS EOV STARTIME, VOLSER, RUNTIME
SLDS Close STARTIME, RUNTIME

For each secondary SLDS or TSLDS, you must issue a separate NOTIFY.SECLOG
command for open, zero or more ends-of-volume, and close processing.
STARTIME(timestamp)
Required parameter you use to specify the starting time of a secondary SLDS
or TSLDS. The time stamp must be in standard form (see “Standard Time
Stamp Format” on page 101).
See Table 10 for a description of the use of this parameter with other
parameters in the NOTIFY.SECLOG command.
CHKPTCT(0 | value)
Optional parameter you use to change the number of checkpoints completed on
the SLDS or TSLDS volumes.
The valid values for CHKPTCT are:
0 No checkpoints in the SLDS or TSLDS volume
1 A single checkpoint in the SLDS or TSLDS volume
2 More than one checkpoint in the SLDS or TSLDS volume

IMS uses the value of CHKPTCT to determine which logs are necessary to
recover a Fast Path area with concurrent image copy.
CHKPTID(chkptid)
Optional parameter you use to specify the oldest checkpoint ID for an active
PST on an SLDS or TSLDS volume. The checkpoint ID must be in standard
form for a time stamp (see “Standard Time Stamp Format” on page 101).
FILESEQ(1 | value)
Optional parameter you use to specify the file sequence number of the
secondary SLDS or TSLDS that is identified. You specify this parameter only if
you specify the VOLSER parameter.
FIRSTREC(number)
Optional parameter you use to specify the log record sequence number of the
first log record of the SLDS or TSLDS. For the first SLDS or TSLDS of the
SECSLD or SECTSLDS, FIRSTREC corresponds to the first log record that
was written during initialization of the IMS subsystem.
FIRSTREC is required if DSN is specified and is invalid if RUNTIME is
specified.
The log record sequence number can be one of the following:
v A hexadecimal number
This number is 1 to 16 characters, enclosed in single quotes and preceded
by the letter, X. For example: FIRSTREC(X'10B9C').
v A decimal number
This number is a decimal number from 0 to (2**64)-1, without delimiters. For
example: FIRSTREC(68508).

296 DBRC Guide & Reference

NOTIFY.SECLOG (for SLDS and TSLDS)
In either case, leading zeros can be omitted.
GSG(gsgname)
Optional parameter you use to specify the GSG name of the IMS subsystem
that produced the SLDS or TSLDS.
GSG is required if NONLOCAL is specified.
INTERIM
Optional parameter you use to specify that an interim log data set record is to
be created.
LASTREC(number)
Optional parameter you use to specify the log record sequence number of the
last log record of the SLDS.
LASTREC is required if RUNTIME is specified and VOLSER is not specified
(that is, on a close call). LASTREC is invalid if DSN is specified.
The log record sequence number can be one of the following:
v A hexadecimal number
This number is 1 to 16 characters, enclosed in single quotes and preceded
by the letter, X. For example: LASTREC(X'10B9C').
v A decimal number
This number is a decimal number from 0 to (2**64)-1, without delimiters. For
example: LASTREC(68508).

In either case, leading zeros can be omitted.

LOCAL | NONLOCAL
Mutually exclusive, optional parameters you use to specify where the SLDS or
TSLDS data was originally created. LOCAL is used if the SLDS or TSLDS was
created by an active IMS subsystem of the local service group. NONLOCAL is
used if the SLDS or TSLDS was originally created by an active IMS subsystem
of the non-local service group and transported to the tracking site.
LOCAL or NONLOCAL need only be specified when creating the SECSLD or
SECTSLDS record. The LOCAL and NONLOCAL keywords are ignored on
subsequent NOTIFY.SECLOG invocations for the SECSLD or SECTSLDS record.
If NONLOCAL is specified, none of the keywords CHKPTID, FILESEQ, UNIT, or
VOLSER can be specified (the data sets must be cataloged) on any
NOTIFY.SECLOG invocation for the SECSLD or SECTSLDS record.
SSID(name)
Optional parameter you use to specify the name of the IMS subsystem that
created the log data set.
The SSID is an eight-character alphanumeric string that represents a valid IMS
subsystem identification name. If you do not specify SSID, DBRC uses the
default subsystem identifier in the RECON header record. You use the
INIT.RECON or CHANGE.RECON command to set the default subsystem identifier in
the RECON header record. If you have not specified a default in the RECON
header record, you must specify SSID.
UNIT(3400 | unittype)
Optional parameter you use to specify the unit type of the volumes on which the
secondary SLDSs reside. You only specify the UNIT parameter if you specify
the DSN parameter. The unit type can be up to eight alphanumeric characters.

Chapter 14. NOTIFY Commands 297

NOTIFY.SECLOG (for SLDS and TSLDS)
VOLSER(volser)
Optional parameter you use to specify the volume serial number of the system
log volume that is being recorded for the identified secondary SLDS. For an
EOV notification, this volume serial number is that of the volume being started.
Table 10 on page 296 identifies when you use the VOLSER parameter.

Example of Adding Secondary SLDS Information to RECON

In this example, information about a secondary SLDS is to be added to RECON.
The STARTIME parameter identifies the secondary SLDS by its opening time
stamp. The VOLSER and DSN parameters indicate that the information to be added
relates to the opening of the secondary SLDS. The first RUNTIME parameter
specifies the time stamp of the EOV of the secondary SLDS or TSLDS. The second
RUNTIME parameter specifies the time stamp of the closing of the secondary SLDS
or TSLDS.
//NFYSECLG JOB
.
.
.

//SYSIN DD *
NOTIFY.SECLOG SLDS STARTIME(820670201010) -
SSID(IMSC) DSN(DSN006) VOLSER(VOL009)
NOTIFY.SECLOG SLDS STARTIME(820670201010) -
RUNTIME(820680204500) VOLSER(VOL003)
NOTIFY.SECLOG SLDS STARTIME(820670201010) -
RUNTIME(820682030000)
/*

NOTIFY.SUBSYS
NORMAL
OO NOTIFY.SUBSYS SSID(name) O
BACKIRLM(name) IRLMID(name) ABNORMAL

ONLINE ENDRECOV
O OP
BATCH STARTRCV

Use a NOTIFY.SUBSYS command to create a subsystem entry in RECON. A check is

made to ensure that a subsystem entry for the specified subsystem does not exist
in RECON. This command is not normally required.

If you specify this command when you are in a recovery-only environment, the
command fails.

Parameters
SSID(name)
Required parameter you use to specify the name of the subsystem for which
information is to be added. The SSID is an eight-character alphanumeric string
that represents a valid MVS and IMS subsystem identification name.
BACKIRLM(name)
Optional parameter you use to specify the name of the alternate subsystem

298 DBRC Guide & Reference

NOTIFY.SUBSYS
IRLM. name is a five-character alphanumeric string. When you specify
BACKIRLM, you must also specify IRLMID.
IRLMID(name)
Optional parameter you use to specify the name of the IRLM with which the
subsystem is communicating. The IRLMID is a five-character alphanumeric
string.
If IRLMID is not specified, the subsystem is not using an IRLM.
NORMAL | ABNORMAL
Mutually exclusive, optional parameters you use to specify the status of the
subsystem.
NORMAL
Specifies that the previous run of the subsystem ended normally and that
the subsystem is to continue normal processing.
ABNORMAL
Specifies that the previous run of the subsystem ended abnormally and
recovery processing is required.
ONLINE | BATCH
Mutually exclusive, optional parameters you use to specify the type of
subsystem from which notification is made.
ONLINE
Specifies that notification is made from an online subsystem.
BATCH
Specifies that notification is made from a batch subsystem.
STARTRCV | ENDRECOV
Mutually exclusive, optional parameters you use to specify the sign-on state of
the subsystem.
STARTRCV
Specifies that the subsystem has signed on for recovery-start processing.
ENDRECOV
Specifies that the subsystem has signed on normally or that a sign-on
recovery-complete call was successful.

Example of Adding a New Subsystem Record to RECON

In this example, a new subsystem record identified by the SSID parameter is added
to RECON. In addition, the subsystem record is marked as online.
//NOTIFYSS JOB
.
.
.

//SYSIN DD *
NOTIFY.SUBSYS SSID(IMS34) ONLINE
/*

NOTIFY.UIC
CURRENT
OO NOTIFY.UIC DBD(name) DDN(name) O
AREA(name) RUNTIME(timestamp) UDATA(string)

Chapter 14. NOTIFY Commands 299

NOTIFY.UIC
O OP
USID(number)

Use a NOTIFY.UIC command to add information to RECON about a nonstandard

image copy data set related to the DBDS or DEDB area that is identified in the
command. A nonstandard image copy data set is one that was not created by the
supported image copy utility such as, one created via a tape dump of the DASD
volume that contains the identified DBDS or DEDB area. Using the NOTIFY.UIC
command is the only way you can record in RECON the existence of nonstandard
image copy data sets.

You cannot issue this command for a DBDS defined with the REUSE attribute.

Restrictions:
v A nonstandard image copy data set cannot be used as input to the Database
Recovery utility (see page 211 for more information).
v This command is not allowed for ILDS or Index DBDSs of HALDB partitions.

Parameters
DBD(name)
Required parameter you use to specify the database name of the DBDS or
DEDB area for which the nonstandard image copy data set was created.
DDN(name) | AREA(name)
Mutually exclusive, required parameters you use to identify, by its name, the
DBDS or DEDB area for which the nonstandard image copy data set was
created.
CURRENT | RUNTIME(timestamp)
Mutually exclusive, optional parameters you use to specify the time stamp of
the creation of the nonstandard image copy data set.
CURRENT
Specifies that the current time stamp is to be used as the time stamp of the
creation of the specified image copy data set. You can create the
nonstandard image copy data set and record its creation in RECON as
separate steps of a single job if you specify CURRENT.
RUNTIME
Specifies the actual time stamp of the creation of the identified nonstandard
image copy data set. The time stamp must be in standard form (see
“Standard Time Stamp Format” on page 101).
UDATA(string)
Optional parameter you use to specify up to 80 bytes of information about the
identified, nonstandard image copy data set. You can use the variable field of
this parameter to describe how the nonstandard image copy data set was
created. string must be in character format in order to be visible in a listing of
RECON. It must be enclosed in parentheses.
USID(number)
Optional parameter you use to specify the value of the update set identifier of
the database or area when the image copy data set was created.
USID is required if the database or area is assigned to a GSG.

300 DBRC Guide & Reference

NOTIFY.UIC
Example of Adding Nonstandard ICDSN Information to RECON
In this example, information about a nonstandard image copy data set is to be
added to RECON. The RUNTIME parameter specifies the time stamp of the
creation of the nonstandard image copy data set. The UDATA parameter specifies
the user data to be recorded in the record in RECON that is updated by this
command.
//NFYUIC JOB
.
.
.

//SYSIN DD *
NOTIFY.UIC DBD(DB1) DDN(DD1) -
RUNTIME(820670201010) -
UDATA('DUMP OF VOLUME VOL001 AT 820670201010')
/*

Chapter 14. NOTIFY Commands 301

NOTIFY.UIC

302 DBRC Guide & Reference

Chapter 15. RESET Command
RESET.GSG
OO RESET.GSG GSGNAME(gsgname) BOTH OP
RECON1
RECON2

Use a RESET.GSG command after an unplanned RSR takeover to remove obsolete

recovery information about RSR-covered databases from the original active site
RECON. For each database or area that is assigned to the specified global service
group (GSG), all IC, UIC, ALLOC, RECOV, and REORG records are deleted. In
addition, all subsystem records of the GSG and related database authorization
information along with all OLDS, RLDS, or SLDS records are deleted. Affected CA
records are cleaned up, made available, or deleted as needed.

Before deleting the obsolete information a backup copy of the RECON is created
(RESET.GSG issues an internal BACKUP.RECON command). BACKUP.RECON invokes the
MVS AMS REPRO command, with its normal defaults, in order to create the backup
copy. Any restrictions applicable to the normal use of the REPRO command apply
also to this command.

Attention: Note that if your RECON RECORDSIZE is greater than 32K that
IDCAMS REPRO can handle the RECORDSIZE as long as the output data set is
NOT a sequential file (such as a tape file). Keeping the RECONs on DASD works
well.

If any failure occurs while the RESET.GSG command is processing, but after the
backup copy has been created (as indicated by the REPRO Completion message),
use the following procedure:
1. Correct the condition that caused the failure.
2. Restore the RECON from the backup data set.
3. Delete and re-allocate the backup data set.
4. Reissue the RESET.GSG command.

If RESET.GSG fails before the backup copy is complete, follow the same procedure,
omitting the third step.

This command fails if RSRFEAT=NO is specified in the IMSCTRL macro.

Parameters
GSGNAME(gsgname)
Required parameter you use to specify the GSGNAME.
BOTH | RECON1 | RECON2
Mutually exclusive, required parameters you use to specify which copy of the
RECON to use.
BOTH
Indicates that the RECON is to be copied to the data sets specified by the
BACKUP1 and BACKUP2 DD statements.

RESET.GSG
RECON1
Indicates that the RECON is to be copied to the data set specified by the
BACKUP1 DD statement.
RECON2
Indicates that the RECON is to be copied to the data set specified by the
BACKUP2 DD statement.

Example of the RESET.GSG Command

In the example, the RECON is copied to the BACKUP1 data set, and then the
obsolete information is deleted.
//
. JOB
.
.

//BACKUP1 DD . . .
//SYSIN DD *
RESET.GSG GSGNAME(IMSGSG1) RECON1
/*

304 DBRC Guide & Reference

Part 3. Appendixes

306 DBRC Guide & Reference
Appendix A. Introduction
The following appendixes are reference materials that may be helpful to you in
using DBRC.

In These Appendixes:
v “Appendix B. Understanding Skeletal JCL” on page 309
– “Using the Commands to Generate JCL and User-Defined Output” on
page 309
– “Using IBM-Supplied Skeletal JCL” on page 310
– “Writing Your Own Skeletal JCL” on page 310
– “Understanding the Skeletal JCL Data Set” on page 310
– “Understanding Skeletal JCL Syntax” on page 311
- “Understanding Simple Keywords” on page 311
- “Using Control Keywords” on page 313
- “Writing Control Keywords” on page 320
- “Understanding Skeletal JCL Default Members” on page 329
– “Understanding the Symbolic Keywords Recognized by DBRC” on page 331
- “All Supported Utilities” on page 331
- “Log Archive Utility (ARCHJCL)” on page 332
- “Database Change Accumulation Utility (CAJCL)” on page 333
- “Log Recovery Utility (LOGCLJCL)” on page 334
- “Database Image Copy Utility, Database Image Copy Utility 2, and Online
Database Image Copy Utility (ICJCL and OICJCL)” on page 335
- “Database Recovery Utility- Receive (ICRCVJCL)” on page 336
- “Database Recovery Utility-Recover (RECOVJCL)” on page 338
– “Understanding the IBM-Supplied Skeletal JCL Execution Members” on
page 340
- “The JOB Statement” on page 340
- “Log Archive Utility JCL (ARCHJCL)” on page 340
- “Database Change Accumulation Utility JCL (CAJCL)” on page 346
- “Log Recovery Utility JCL (LOGCLJCL)” on page 349
- “Database Image Copy Utility JCL (ICJCL)” on page 351
- “Online Database Image Copy Utility JCL (OICJCL)” on page 354
- “Database Recovery Utility JCL-Image Copy Receive-Tracking Site
(ICRCVJCL)” on page 356
- “Database Recovery Utility JCL (RECOVJCL)” on page 358
v “Appendix C. Sample Listings of RECONs” on page 367
– “Sample Listing of a RECON at the Active Site” on page 373
– “Sample Listing of a RECON at the Tracking Site” on page 401
– “Fields Present in a Listing of a RECON by Record Type” on page 416
v “Appendix D. Considering IMS DBRC RECON Data Set Placement” on page 453

Introduction to the Appendixes

308 DBRC Guide & Reference

Appendix B. Understanding Skeletal JCL
Using the Commands to Generate JCL and User-Defined Output
Eight GENJCL commands are part of the DBRC utility. Seven of these commands
generate the JCL and control statements necessary to run various IMS
recovery-related utilities. You can use the remaining command, GENJCL.USER, to
generate user-defined output, including JCL.

Table 11 lists the eight GENJCL commands and what they do.
Table 11. What the GENJCL Commands Do
Command (PDS Member) What the Command Generates
GENJCL.ARCHIVE (ARCHJCL) Log Archive utility JCL and control statements
GENJCL.CA (CAJCL) Database Change Accumulation utility JCL and control
statements
GENJCL.CLOSE (LOGCLJCL) Log Recovery utility JCL and control statements
GENJCL.IC (ICJCL) Database Image Copy or Database Image Copy 2
utility JCL and control statements
GENJCL.OIC (OICJCL) Online Database Image Copy utility JCL and control
statements
GENJCL.RECEIVE (ICRCVJCL) Database Recovery utility JCL and control statements
GENJCL.RECOV (RECOVJCL) Database Recovery utility JCL and control statements
GENJCL.USER ( ) User-defined output, including JCL and control
statements

Note: DSPUPJCL is provided and can be used with GENJCL.USER, but other
types of JCL can be used as well. No default is defined.

When you issue a GENJCL command, it uses a skeletal JCL execution member. The
execution member is a model of the JCL or user output that you are producing. The
execution member contains symbolic keywords. DBRC substitutes current
information for the symbolic keywords. The substituted information comes from
RECON and from skeletal JCL default members, and from your USERKEY values.
Typical of the information DBRC substitutes for symbolic keywords are data set
names and volume information. DBRC performs the keyword substitution and then
generates the JCL or user output you requested by issuing the GENJCL command.

IBM supplies a JOB statement execution member that is used by all GENJCL
commands. If the IBM-supplied skeletal JCL execution members meet your general
requirements, you can modify them slightly to provide installation-specific
information. Information on what needs to be modified is contained in “Using
IBM-Supplied Skeletal JCL” on page 310.

If the IBM-supplied skeletal JCL does not meet your general requirements or if you
plan to use the GENJCL.USER command, you must write your own skeletal JCL
members or define new keywords to include in the IBM-supplied skeletal JCL.
Information on these topics is in “Writing Your Own Skeletal JCL” on page 310.

Skeletal JCL

Using IBM-Supplied Skeletal JCL

If you are generating JCL for the IMS recovery-related utilities using the
IBM-supplied skeletal JCL execution members, the process is simple. It involves
modifying the IBM-supplied skeletal JCL execution members. For the skeletal JCL
execution members, see “Understanding the IBM-Supplied Skeletal JCL Execution
Members” on page 340. Before you use them:
v Add two DD statements (JCLPDS and JCLOUT) to the DBRC dependent
address space procedure used for online IMS. JCLPDS identifies the partitioned
data set containing the skeletal JCL execution members. JCLOUT identifies the
data set to which the generated job is to be written. Output is in card image
format. The output data set can be a punch file, a DASD data set that you plan
to examine before submitting the job for execution, or directly to the MVS internal
reader.
These two ddnames can be specified on the GENJCL command. When GENJCL is
used, the two specified data sets are in effect for the GENJCL command only, and
not for the life of the job. The JCLOUT data set is opened at the start of the
command execution and closed at the end of the command execution.
Consequently, if multiple GENJCL commands are concatenated in the job stream,
the JCLOUT data set (if other than the MVS internal reader) only contains the
results from the last command that was processed.
v Add any STEPLIB and STEPCAT DD names, and job accounting information that
your installation requires to the skeletal JCL execution member. Except for the
skeletal JCL member for the JOB statement, do not add any JOBCAT, JOBLIB,
and JES control statements to your skeletal JCL; doing so causes errors if
multiple steps are generated.
v Change the default value for the REGION parameter on the skeletal JCL EXEC
statement if the existing one is not correct for your installation.
v If you plan to generate JCL to run the Log Recovery utility (member LOGCLJCL),
replace the DFSWADS0 DD statement.

Recommendation: Exercise care when modifying the skeletal JCL, because

DBRC does not verify any of the JCL that is generated.

Writing Your Own Skeletal JCL

This section describes the things you need to know before writing your own skeletal
JCL or developing simple keywords to modify the IBM-supplied skeletal JCL. You
must write your own skeletal JCL or simple keywords if the IBM-supplied skeletal
JCL execution members do not meet your requirements or if you plan to use the
GENJCL.USER command. IBM provides no skeletal JCL execution member for the
GENJCL.USER command.

Understanding the Skeletal JCL Data Set

As shown in Figure 18 on page 311, the skeletal JCL data set contains the skeletal
JCL members used by the GENJCL command processor to generate output. The two
types of skeletal JCL members are execution members and default members.

Execution members are models of the output you are generating. Execution
members can be IBM supplied (as described in the previous section) or supplied by
you. Execution members contain symbolic keywords, which represent information
DBRC provides.

310 DBRC Guide & Reference

Skeletal JCL
Default members specify default values for symbolic keywords in the execution
members. The use of default members is optional. You provide the default
members. To use a default member, you specify the member on the GENJCL
command. Or, in the case of DBDS and CA groups, you can implicitly specify the
default member (explained in detail later).

Figure 18. Skeletal JCL Data Set

Understanding Skeletal JCL Syntax

Skeletal JCL execution members are models of the output to be produced.
Typically, execution members contain symbolic keywords. The symbolic keywords
represent information that DBRC is to provide. The two types of symbolic keywords
are simple keywords and control keywords. Simple keywords are keywords for
which DBRC substitutes a value in the output stream (for example, data set
names). Control keywords control what output is generated (for example, what
RECON records are to be used for keyword substitution).

Simple keywords and control keywords are explained in the following sections.

The keywords in skeletal JCL members must be in uppercase.

Understanding Simple Keywords

When JCL is generated, simple keywords in the skeletal JCL execution members
are replaced with the current keyword value. For example, the IBM-supplied skeletal

Appendix B. Understanding Skeletal JCL 311

Skeletal JCL Syntax
JCL execution members use %TIME as a simple keyword. When DBRC encounters
%TIME, it replaces it with the time of day. Keyword substitution occurs each time
DBRC encounters a simple keyword. Multiple simple keywords can exist in a
skeletal JCL execution member.

Simple keywords must be assigned a value before you use them. Keyword values
are assigned (or set) in several different ways, as shown in Figure 19 on page 313.
v The GENJCL command specifies values for some of the simple keywords in
skeletal JCL execution or default members. User-defined keywords are assigned
a value in the USERKEYS parameter in the command. Other keyword values are
set by various parameters on the command. For example, the SSID parameter
sets the value for the %SSID keyword (the subsystem ID).
v Skeletal JCL default members set default values for keywords in skeletal JCL
execution members.
v The RECON also provides keyword values. For example, when the
GENJCL.ARCHIVE command is issued, the ddnames and data set names for the
OLDS are obtained from the PRIOLDS and SECOLDS records.
v Some keyword values are implicitly known, for example the time of day.

If during the JCL generation process, a keyword is encountered that has not been
assigned a value, no substitution takes place. Instead, DBRC issues a warning
message.

When writing your own skeletal JCL execution members, you can define your own
simple keywords as well as use the simple keywords already recognized by DBRC.
For a list of the simple keywords that DBRC recognizes, see “Understanding the
Symbolic Keywords Recognized by DBRC” on page 331. You can also define your
own simple keywords and add them to the IBM-supplied skeletal JCL execution
members.

Here are some conventions, restrictions, and other detail you should know when
writing simple keywords:
v Keywords must begin with a percent (%) sign.
v The minimum keyword length is two characters, including the percent sign. The
maximum length is eight characters, including the percent sign.
v Keywords must be written using uppercase letters only (A rather than a).
v The first character after the percent sign must be alphabetic (A-Z); the remaining
characters must be alphanumeric (A-Z, 0-9). Keywords are delimited by a
non-alphanumeric character or when the maximum length is reached.
v DBRC does not use any keywords beginning with %W, %X, %Y, or %Z. You can,
therefore, use these characters for your own keywords without conflicting with
predefined keywords.
v User-defined simple keywords must be assigned a value with the USERKEYS
parameter on the GENJCL command or with a skeletal JCL default member.
v Keyword substitution is performed on columns 1-71 of the skeletal JCL records.
Columns 72-80 are not modified. If the keyword value is shorter than the
keyword, the remaining data on the record is shifted to the left and filled with
blanks. If the keyword value is longer than the keyword, the remaining data is
shifted to the right. If any non-blank characters are shifted beyond column 71, a
JCL continuation statement is generated. In some cases (for example, when the
output is not a JCL statement), it might not be possible to generate a JCL

312 DBRC Guide & Reference

Skeletal JCL Syntax
continuation statement, because a comma or blank must exist in the output
record for DBRC to split it. When DBRC cannot find a break in the statement, it
splits the statement at column 71.

Figure 19. How Simple Keyword Values Are Set

Using Control Keywords

Use control keywords to regulate what JCL (or other output) is generated. The
control keywords are:
v %SELECT
v %ENDSEL
v %DELETE
v %ENDDEL
v %SET MEMBER
v %SET TIMEFMT

The %SELECT keyword selects the RECON records that are needed in order to
resolve simple keywords. The %ENDSEL keyword indicates the end of the records
selected by the %SELECT keyword. These control keywords always occur in pairs. A
%SELECT keyword is followed by one or more execution member records, which is
followed by the %ENDSEL keyword. This sequence of records is called a control group
or, more specifically, a select group.

The %DELETE keyword deletes records from the generated output stream. Deletion
occurs based on a specific condition. The %ENDDEL keyword delimits the scope of
the %DELETE keyword. These control keywords always occur in pairs. A %DELETE
keyword is followed by one or more execution member records, which is followed
by the %ENDDEL keyword. This sequence of records is called a control group or,
more specifically, a delete group.

Appendix B. Understanding Skeletal JCL 313

Skeletal JCL Syntax
The %SET MEMBER keyword specifies a different skeletal JCL execution member that
is to be used in the next step of a multi-step job.

The %SET TIMEFMT keyword is used to specify a form for time stamps that appear in
GENJCL output.

Using the %SELECT and %ENDSEL Keywords

Use the %SELECT keyword to select one or more records from RECON. The selected
records identify IMS data sets or events tracked by DBRC. Information from the
selected records is used to resolve simple keywords in the select group. Simple
keywords can occur in the execution member records or in the %SELECT keyword
itself.

The format for a select group follows:

%SELECT record_type(selection_criteria)
execution_member_record(s)
%ENDSEL

Select groups can be nested within select groups.

%SELECT record_type(selection_criteria)
%SELECT record_type(selection_criteria)
execution_member_record(s)
%ENDSEL
%ENDSEL

The record_type is the type of RECON record to be selected. You can select any of
the following record_types:
v OLDS (PRIOLD)
v SLDS (PRISLD)
v RLDS (PRILOG)
v IC (IMAGE)
v CA (CA)
v ALLOC (ALLOC)
v DBDS (DBDS)

The selection_criteria depend on the type of record you select, and can be time
ranges and ddnames.

Both the record_type and selection_criteria can be simple keywords.

As RECON records are selected, information from them is used to set the values of
simple keywords. The keyword set depend on the type of record being selected and
are described in following sections.

Any values assigned to a keyword before the select group is processed are
overridden when the select group is processed. The keyword values in effect after
the select group is processed are the values set from the last selected record.
Keyword values remain unchanged if no records are selected. In this case, the
records in the select group are not processed. The next records to be processed
are those that appear just after the %ENDSEL statement. A select group can occur
within a delete group. When this occurs and the delete group is deleted, the select
group is not processed, and no keyword values are set (or changed).

314 DBRC Guide & Reference

Skeletal JCL Syntax
The selection_criteria for a select group can cause one or more RECON records
to be selected. One execution member can be output more than once depending
upon the type of records that have been selected.

When the output stream is JCL, a select group can generate either concatenated or
repeated DD statements. The first execution member record of the select group
determines which is to be generated. Repeated DD statements are generated if this
record is a JCL DD statement and the ddname is a simple keyword. Otherwise, a
concatenated DD statement is generated.

Example:

Assume that the first record is:

//DDNAME DD DSN= . . .

In this case, concatenated DD statements are generated. Alternatively, the first

record might be:
//%DDNAME DD DSN= . . .

In this case, repeated DD statements are generated. When repeated DD

statements are generated, you must provide some mechanism to ensure that the
repeated ddnames are unique. When selecting OLDSs, DBRC uses the OLDS
ddname, which is in the OLDS RECON record. DBRC does not track ddnames for
any other type of data set. Therefore, DBRC might not be able to generate unique
ddnames for data sets that are not OLDSs.

The two sections that follow explain the record_type and selection_criteria
parameters in more detail.

Specifying the Record Type Parameter

The types of records that can be specified on the %SELECT keyword are shown in
Table 12.
Table 12. Records That Can Be Selected Using the %SELECT Keyword
record_type What Is Selected
OLDS Specifies that OLDSs are to be selected. If dual logging is in effect,
both PRIOLDS and SECOLDS can be selected.
SLDS Specifies that PRISLDs are to be selected. The PRISLD is selected
unless the SLDS record in RECON shows the SLDS has an error. In
this case, the SECSLD is selected. The SLDS is the one created by
the Log Archive utility when archiving OLDSs, not the one created
by an IMS batch region. To select an IMS batch SLDS, specify
RLDS.
SSLDS Specifies that SECSLDs are to be selected.
RLDS Specifies that RLDSs are to be selected. The PRIRLDS is selected
unless the PRILOG record in RECON indicates the RLDS has an
error. In this case, the SECRLDS is selected. RLDS refers to both
the RLDS created by the Log Archive utility and the SLDS created
by an IMS batch region.
SRLDS Specifies that SECRLDSs are to be selected.
IC Specifies that image copy data sets are to be selected.
CA Specifies that change accumulation data sets are to be selected.

Appendix B. Understanding Skeletal JCL 315

Skeletal JCL Syntax
Table 12. Records That Can Be Selected Using the %SELECT Keyword (continued)
ALLOC Specifies that DBDS allocation records are to be selected.
DBDS Specifies that DBDS records are to be selected.

Understanding the Selection Criteria Parameter

The selection criteria depend on the record type you select. Selection criteria are
described under the sections on selecting individual record types.

The following common terms, used for selection criteria, are used in the remainder
of this chapter.
dbds qualifier
Specifies the DBDS with which the selected records are to be associated. The
DBDS can be specified as dbname, ddname, or CA group name. When a CA
group name is specified, all DBDSs in the CA group are used for selection. The
DBDS qualifier is used when selecting:
v RLDSs
v Change accumulation data sets
v Image copy data sets
v ALLOC records
v DBDSs
time qualifier
Specifies a time stamp or a range of time stamps.
DBRC selects RECON records by their record key. Many records contain a time
stamp and the time that is contained in the record key is signified by an
adjacent asterisk (*) in a listing. The time qualifier that is specified in a
FROMTIME or TOTIME parameter determines what records DBRC selects.
Some records such as PRILOG or PRISLD records consist of multiple DSN
entries, each of which has a start time and stop time. DBRC cannot select
specific DSN entries without first selecting the entire log record. The
FROMTIME and TOTIME values must be specified such that the entire log
record that contains desired DSN entries is selected based on the time stamp
that is in the record key.
For example, if you specify a FROMTIME of 12:00, DSN entries with time
stamps later than 12:00 (but that are included in a PRISLDS record with a start
time of 11:00) would not be selected and displayed by DBRC, because the
PRISLDS record itself has a time stamp earlier than the specified FROMTIME.
You can specify a zero time value. The time qualifier can be specified in the
forms described in “Standard Time Stamp Format” on page 101 in “Chapter 7.
DBRC Commands” on page 99.
FIRST
Specifies that the oldest record is to be selected.
LAST
Specifies that the most recent record is to be selected.
(FROM(time),TO(time)) or (FROM(time)) or FROM(time) or (TO(time)) or
TO(time)
Specifies that all records with time greater than or equal to the FROM time
and less than or equal to the TO time are to be selected.
ALL
Specifies that all records are to be selected.

316 DBRC Guide & Reference

Skeletal JCL Syntax
Using the %DELETE and %ENDDEL Keywords
Use the %DELETE and %ENDDEL keywords to delete records from the output stream
based on a specific condition. The syntax of a delete group follows:

OO %DELETE S (relational expression) execution_member_record(s) O

O %ENDDEL OP

%DELETE statements cannot be nested. Each %DELETE keyword must be followed by

a corresponding %ENDDEL before another %DELETE keyword is encountered.

The relational expression must be of the form %keyword op 'value' or %keyword op

'%userkey' where:
v %keyword is any simple keyword.
v 'value' is any character string enclosed in single quotes. A null string ('') can
be specified for the value. You can specify a zero time value. The time qualifier
can be specified in the forms described in “Standard Time Stamp Format” on
page 101 in “Chapter 7. DBRC Commands” on page 99.
v %userkey is any keyword defined via the USERKEYS parameter in the GENJCL
command. The %userkey must be enclosed in quotes and the %userkey value
must exclude leading zeros.
v op is one of the following operators:
EQ Equal
NE Not equal
LT Less than
LE Less than or equal
GT Greater than
GE Greater than or equal

When a %DELETE keyword is encountered in a skeletal JCL execution member, the

relational expression is evaluated. If the expression is true, the delete group is
deleted from the output stream. If the expression is false, the applicable records are
copied to the output stream after keywords are resolved. If a value has not been
assigned to a keyword, the value is the null string (''). If an undefined keyword is
encountered in the skeletal JCL, an error message is received and no substitution
takes place.

Specifying Complex Expressions: You can specify complex expressions

consisting of multiple relational expressions joined by connectives

Definitions: A connective is one of the following logical functions:

& AND function
| OR function

The following is an example of a complex expression:

Appendix B. Understanding Skeletal JCL 317

Skeletal JCL Syntax
%DELETE (relexp1 | relexp2 & relexp3)

The DELETE group is deleted when the entire complex expression is logically true.
Complex expressions should have the following characteristics:
v The entire DELETE statement (including the %DELETE) is limited to 80 characters,
within which up to five expressions are allowed.
v A connective must be the first character following a relational expression (blanks
are optional).
v The statement is processed from left to right with no connective priority and no
bracketing.

where:
relexpx = relational expression

This complex expression takes the results of the OR operation between relexp1 and
relexp2 and performs the AND operation with relexp3.

Using the %SET MEMBER Keyword

The %SET MEMBER keyword can be used when you are generating multi-step jobs
(such as GENJCL.CA with the VOLNUM parameter specified). You use %SET MEMBER to
specify a different skeletal JCL execution member than the one that is executed for
the first step of the job. The execution member you specify is used in all job steps
after the first. You can explicitly code various %keywords in the execution member
that is used in job steps after the first one. For example, you can explicitly code the
%CAODSN keyword, which is the name of the input change accumulation data set.

The syntax of the %SET MEMBER keyword is:

OO %SET_MEMBER=newmbrname OP

The %SET MEMBER keyword can be placed anywhere in the current skeletal JCL
execution member. However, it takes effect only after processing of the current
execution member is complete. If you specify more than one %SET MEMBER keyword,
the last one specified is the one that is used. In the new member, you can place a
%SET statement that specifies any member name.

newmbrname is the name of the skeletal JCL execution member that is to be used for
all job steps after the first job step. newmbrname must reside in the library named in
the JCLPDS DD statement. newmbrname is not used until it is necessary to begin
processing of the new member. It is possible to specify an incorrect member name
and not have an error condition occur until a GENJCL command is issued that causes
enough steps to be generated to cause the member to be read.

Using the %SET TIMEFMT Keyword

The %SET TIMEFMT keyword is used to specify a format for time stamps that appear
in GENJCL output.

For GENJCL.USER, the default is:

TIMEFMT(O,O,C,2,1)

318 DBRC Guide & Reference

Skeletal JCL Syntax
Note that the GENJCL TIMEFMT default values have been chosen to produce correct
output with IBM-supplied skeletal JCL. If you use the %SET statement to change the
TIMEFMT values in a way that affects the values substituted into the IBM-supplied
JCL statements, the results are unpredictable.

Example:

Here is an example of the %SET TIMEFMT keyword in skeletal JCL.

%SET TIMEFMT(,N)
%SELECT RLDS(%SSID,LAST)
LOGEND =%LOGETIM
%ENDSEL

And here is what the output from the preceding example of %SET would render:
LOGEND =960111315000

The subsequent four examples are based on the following skeletal JCL member
(called USER01) that is used with GENJCL.USER.
%SELECT RLDS(%SSID,LAST)
LOGETIM=%LOGETIM
%ENDSEL

v This sample output format was obtained by using the USER01 JCL, specifying
SSID(XXXX) and using the default for TIMEFMT which is:
TIMEFMT(O,O,C,2,1)

LOGETIM=960021315001-0700

v This sample output format was obtained by using the USER01 JCL, specifying
SSID(XXXX) and using the default for TIMEFMT on an open log.
LOGETIM=000000000000+0000

v This sample output format was obtained by using the USER01 JCL, specifying
SSID(XXXX) and using the specification, TIMEFMT(,N).
LOGETIM=960111314544

v This sample output format was obtained by using the USER01 JCL, specifying
SSID(XXXX) and using the specification, TIMEFMT(,,P,4).
LOGETIM=1996.011 13:15:00.0 -07:00

Restriction: The %SET TIMEFMT keyword affects GENJCL output only if it is issued
via the GENJCL command or from a %SET statement in the skeletal JCL.

The syntax of the %SET TIMEFMT keyword is:

OO %SET_TIMEFMT(subparm,[subparm],...) OP

Related Reading: For detailed information about the TIMEFMT keyword, its
parameters, and format, see “TIMEFMT Parameter Sublist” on page 102 but
remember that the TIMEFMT keyword affects GENJCL output only if it is issued via the
GENJCL command or from a %SET statement in the skeletal JCL.

Appendix B. Understanding Skeletal JCL 319

Skeletal JCL Syntax
Writing Control Keywords
When writing control keywords, you need to observe the following conventions and
restrictions:
v Control keywords must begin in column 1 of a skeletal JCL execution member
record.
v Everything specified for the keyword must be contained on one record. Any data
following the control statement is ignored.
v Any number of skeletal JCL execution member records can be contained in a
control group.
v Delete groups and select groups cannot be nested. However, a select group can
be contained within a delete group, or a delete group can be contained within a
select group.
v Execution member records containing control keywords are not copied to the
output stream.

Selecting OLDSs
The syntax of the %SELECT keyword to select OLDSs is as follows:

OO %SELECT OLDS(ssid,olds_qualifier) OP

ssid
Subsystem ID of the IMS online control region that created the OLDS.
olds_qualifier
Specifies the OLDSs that are to be selected as follows:
INUSE
Specifies that the OLDS that is currently in use by the specified subsystem
is to be selected. If dual logging is in effect, both the primary and secondary
OLDSs are selected.
LATEST
Specifies that the OLDS that was most recently opened by the specified
subsystem is to be selected. If dual logging is in effect, both the primary
and secondary OLDSs are selected.
UNARCH
Specifies that all unarchived OLDSs for the specified subsystem are to be
selected. If dual logging is in effect, both the primary and secondary OLDSs
are selected.
(DDNAME)
Specifies one or more OLDSs by ddname. If dual logging is in effect and
both the primary and secondary OLDS are to be selected, both ddnames
should be specified.
ALL
Specifies that all OLDSs for the specified subsystem are to be selected.

In the execution member records following the %SELECT keyword, you use simple
keywords to specify the type of information to be gathered for each OLDS record
that is selected. The types of information you can gather are:
%OLDSDDN The ddname of the OLDS.
%OLDSDSN The data set name of the OLDS.

320 DBRC Guide & Reference

Skeletal JCL Syntax
%OLDSTYP The OLDS type. DBRC sets the %OLDSTYP to P for primary OLDS or
S for secondary OLDS.
%OLDOTIM The time the OLDS was opened. DBRC sets %OLDOTIM in the form
yydddhhmmsst{offset}.
%OLDCTIM The time the OLDS was closed. DBRC sets %OLDCTIM in the form
yydddhhmmsst{offset}. If the OLDS has not been closed, DBRC
sets the time to 000000000000+0000.
%OLDSSEL Set to YES if any OLDS was selected. Otherwise, set to NO.
%OLDFRID The log record sequence number of the first log record of the
OLDS.
%OLDLRID The log record sequence number of the last log record of the
OLDS.

Example 1: The following select group generates repeated DD statements for all
unarchived OLDSs belonging to subsystem IMSA.
%SELECT OLDS(IMSA,UNARCH)
//%OLDSDDN DD DSN=%OLDSDSN,DISP=SHR
%ENDSEL

The JCL generated by this select group might be:

//DFSOLP00 DD DSN=IMS.OLDSP00,DISP=SHR
//DFSOLS00 DD DSN=IMS.OLDSS00,DISP=SHR
//DFSOLP01 DD DSN=IMS.OLDSP01,DISP=SHR
//DFSOLS01 DD DSN=IMS.OLDSS01,DISP=SHR

Example 2: The following select group generates a list of all OLDSs belonging to
subsystem IMSA:
%SELECT OLDS(IMSA,ALL)
%OLDSTYPOLDS DD NAME=%OLDSDDN
DSN=%OLDSDSN
CLOSE TIME=%OLDSCTIM
%ENDSEL

The output generated by this select group might be:

POLDS DD NAME=DFSOLP00
DSN=IMS.POLDS00
CLOSE TIME=842351638193+0012
POLDS DD NAME=DFSOLP01
DSN=IMS.POLDS01
CLOSE TIME=842351712246+0055
POLDS DD NAME=DFSOLP02
DSN=IMS.POLDS02
CLOSE TIME=000000000000+0000

Selecting SLDSs
The syntax of the %SELECT keyword to select SLDS is:

OO %SELECT slds_type(ssid,time_qualifier) OP

slds_type
Can be specified as SLDS (for the PRISLD) or SSLDS (for the SECSLD). This

Appendix B. Understanding Skeletal JCL 321

Skeletal JCL Syntax
keyword selects the entire RECON record, not individual data sets. Therefore,
all data sets identified in the SLDS record are selected.
If the selected PRILOG data set is marked in error, DBRC selects the
associated secondary data set if one that is not also in error exists. If the
associated data set exists but is also in error, DBRC selects the original record.
If SSLDS is specified, the SECLOG data set is selected regardless of if whether it
is marked in error. An SLDS record might not contain a DSN entry. In this case,
the values for %SLDSDSN(%LOGDSN), %SLDUNIT (%LOGUNIT), and %SLDVOLS (%LOGVOLS)
are null. You must use the %DELETE statement in order to ensure that DBRC
substitutes valid data in the generated JCL. See “Example 4” on page 323.
ssid
The subsystem ID (of the IMS online control region) that created the OLDSs
that were archived to become SLDSs.
time_qualifier
The time qualifier as specified in the section “Understanding the Selection
Criteria Parameter” on page 316.

In the execution member records following the %SELECT keyword, you specify (using
simple keywords) the type of information to be gathered for each SLDS record that
is selected. The types of information you can gather are:
%SLDSDSN The data set name of the SLDS.
%SLDUNIT The unit type of the SLDS.
%SLDVOLS The volume serial number of the SLDS.
%SLDFSEQ The file sequence number of the SLDS.
%SLDSTIM The start time of the SLDS. DBRC sets the %SLDSTIM in the form
yydddhhmmsst{offset}.
%SLDETIM The stop time of the SLDS. DBRC sets the %SLDETIM in the form
yydddhhmmsst{offset}.
%SLDSSEL Set to YES if any SLDS was selected. Otherwise, set to NO.
%SLDRMT Set to YES if the SLDS was created at the tracking site. Otherwise,
set to NULL.
%SLDFRID The log record sequence number of the first log record of the
SLDS.
%SLDLRID The log record sequence number of the first log record of the
SLDS.

Example 3: The following select group generates the most recent SLDS for
subsystem IMSA.
%SELECT SLDS(IMSA,LAST)
LATEST SLDS: DSN=%SLDSDSN
STOP TIME=%SLDETIM
%ENDSEL

The output generated by this select group might be:

LATEST SLDS: DSN=IMS.SLDS
STOP TIME=841230812339

322 DBRC Guide & Reference

Skeletal JCL Syntax
If the SLDS record has more than one data set, then all the data sets to be
selected and your output may look like this:
LATEST SLDS: DSN=IMS.IMSA.SLDSP.D97107.T1405235.V06
STOP TIME=971071420469+0100
LATEST SLDS: DSN=IMS.IMSA.SLDSP.D97107.T1420469.V03
STOP TIME=971071420579+0100
LATEST SLDS: DSN=IMS.IMSA.SLDSP.D97107.T1420579.V00
STOP TIME=971071430087+0100

Example 4: The following select group generates a concatenated DD statement

for all SLDSs for subsystem IMSA that have an open time greater than or equal to
840031903298.
%SELECT SLDS(IMSA,FROM(840031903298))
%DELETE (%SLDSDSN EQ '')
//SLDS DD DSN=%SLDSDSN,DISP=OLD,
// UNIT=%SLDUNIT,
// VOL=SER=(%SLDVOLS),
// LABEL=(1,SL)
%ENDDEL
%ENDSEL

The generated DD statements might be:

//SLDS DD DSN=IMS.SLDS1,DISP=OLD,
// UNIT=3400,
// VOL=SER=(VOLUM1,VOLUM2,VOLUM3),
// LABEL=(1,SL)
// DD DSN=IMS.SLDS2,DISP=OLD,
// Unit=3400,
// VOL=SER=(VOLUM4,VOLUM5,VOLUM6,
// VOLUM7, C
// VOLUM8,VOLUM9),
// LABEL=(1,SL)

Attention: In this example, a JCL continuation card was generated. This is

because the volume serial number list was longer than the output record.

The %DELETE statement prevents the JCL statement from being generated for an
SLDS record that does not contain a DSN entry.

Selecting RLDSs
The syntax of the %SELECT keyword to select RLDSs can be specified in one of the
following ways:

OO %SELECT RLDS(ssid,time_qualifier ) OP
,max_volumes

OO %SELECT SRLDS(ssid,time_qualifier ) OP
,max_volumes

OO %SELECT RLDS(dbds_qualifier,time_qualifier ) OP
,max_volumes

Appendix B. Understanding Skeletal JCL 323

Skeletal JCL Syntax
Use SRLDS to request that secondary RLDS records be selected. Secondary RLDS
records can be specifically requested only when you specify SSID. When you
specify dbds_qualifier, you are specifically requesting primary RLDS records. If
the primary RLDS is marked in error, DBRC selects the associated secondary data
set if one that is not also in error exists. If no associated data set exists or if it is
also in error, DBRC selects the original record.
ssid
The subsystem ID of the IMS online control region or an IMS batch region.
PRILOG (or SECLOG) records corresponding to the specified SSID are
selected to satisfy the specified search criteria. Because RECON records are
selected, all data sets identified by the record are selected.
time_qualifier
Time qualifier as specified in the section “Understanding the Selection Criteria
Parameter” on page 316.
dbds_qualifier
DBDS qualifier as specified in the section “Understanding the Selection Criteria
Parameter” on page 316. When a dbds_qualifier is specified, only RLDSs that
contain log records corresponding to the specified DBDS are selected. (In other
words, those RLDSs for which an ALLOC record exists in RECON.) Only
primary RLDSs can be selected when the dbds_qualifier is specified.
max_volumes
The maximum number of log volumes to be selected. If max_volumes is
specified, processing of the select group terminates when the specified number
of log volumes is reached. If max_volumes is specified and a log merge situation
exists, more than the specified number of volumes can be selected. This is to
ensure that a valid subset of logs is selected.

In the execution member records following the %SELECT keyword, you use simple
keywords to specify the type of information to be gathered for each RLDS record
that is selected. The types of information you can gather are:
%LOGDSN The data set name of the RLDS.
%LOGFSEQ The file sequence number of the RLDS.
%LOGUNIT The unit type of the RLDS.
%LOGVOLS The volume serial number of the RLDS.
%LOGSTIM The start time of the RLDS. DBRC sets %LOGSTIM in the form
yydddhhmmsst{offset}.
%LOGETIM The stop time of the RLDS. DBRC sets %LOGETIM in the form
yydddhhmmsst{offset}. If the data set is still open, the time is set to
000000000000+0000.
%LOGSEL Set to YES if any log data sets were selected. Otherwise, set to NO.
%LOGMERG Set to YES if a log merge is required. Otherwise, set to NO. %LOGMERG
is always set to NO if SSID is specified.
%LOGONL Set to YES if the RLDS is associated with an online region. Set to NO
for batch logs.
%LOGRMT Set to YES if the RLDS was created at the tracking site. Otherwise,
set to NULL.
%LOGFRID The log record sequence number of the first log record of the
RLDS.

324 DBRC Guide & Reference

Skeletal JCL Syntax
%LOGLRID The log record sequence number of the last log record of the
RLDS.

Example 5: The following select group generates a DD statement for the

most-recent RLDS for subsystem BATCHJOB. This example assumes the RLDS is
still open.
%SELECT RLDS(BATCHJOB,LAST)
%DELETE (%LOGETIM NE '000000000000+0000')
//LOGDD DD DSN=%LOGDSN,DISP=OLD,
// UNIT=%LOGUNIT,
// VOL=SER=(%LOGVOLS),
// LABEL=(%LOGFSEQ,SL)
%ENDDEL
%ENDSEL

If no RLDS is recorded in RECON for the subsystem or if the most-recent RLDS

has been closed, no DD statement is generated. Otherwise, the generated DD
statement might be:
//LOGDD DD DSN=IMS.RLDS,DISP=OLD,
// UNIT=3400,
// VOL=SER=(VOLUM1,VOLUM2)
// LABEL=(1,SL)

Selecting Image Copy Data Sets

The syntax of the %SELECT keyword to select image copy data sets is:

OO %SELECT IC(dbds_qualifier,time_qualifier) OP

dbds_qualifier and time_qualifier

DBDS qualifier and time qualifier are as specified in “Understanding the
Selection Criteria Parameter” on page 316.

In the execution member records following the %SELECT keyword, you specify (using
simple keywords) the type of information to be gathered for each image copy record
that is selected. If the duplicate image copy is marked in error, the DBRC selects
the primary image copy. The types of information you can gather are:
%ICDSN The data set name of the image copy data set.
%ICTYPE The image copy’s type: BATCH, ONLINE, CIC, SMSCIC, or
SMSNOCIC.
%ICFSEQ The file sequence number of the image copy data set if it is a
NONHSSP type; otherwise, ICFSEQ is null.
%ICSEL Set to YES if any image copy data set was selected. Otherwise,
ICSEL is set to NO.
%ICSTOP The stop time of the image copy data set ID that is present;
otherwise ICSTOP is null.
%ICTIME The run time of the image copy. DBRC sets %ICTIME in the form
yydddhhmmsst{offset}.
%ICUNIT The unit type of the image copy data set if it is a NONHSSP type;
otherwise, ICUNIT is null.

Appendix B. Understanding Skeletal JCL 325

Skeletal JCL Syntax
%ICVCNT The number of volumes of the image copy data set if it is a
NONHSSP type; otherwise, ICVCNT is null.
%ICVOLS The volume serial number list of the image copy data set if it is a
NONHSSP type; otherwise, ICVOLS is null.
%ICUSID The update set identifier (USID).
%ICCAT Set to YES if the image copy is cataloged (HSSP CICs only).
Otherwise, ICCAT is set to NO.
%IC2SEL Set to YES if a duplicate image copy data set is associated with the
selected image copy data set. Otherwise, IC2SEL is set to NO.

The following keywords are set only when a duplicate image copy data set exists;
otherwise, they are null:
%IC2DSN The data set name of the duplicate image copy data set.
%IC2FSEQ The file sequence number of the duplicate image copy data set. If
the IC was created by HSSP, IC2FSEQ is set to null.
%IC2UNIT The unit type of the duplicate image copy data set. If the IC was
created by HSSP, IC2UNIT is set to null.
%IC2VCNT The number of volumes of the duplicate image copy data set. If the
IC was created by HSSP, IC2VCNT is set to null.
%IC2VOLS The volume serial number list of the duplicate image copy data set.
If the IC was created by HSSP, IC2VOLS is set to null.

Example 6: The following select group generates a DD statement for the oldest
image copy data set for the DBDS with a database name of SHISAMDB and a
ddname of SHISAMDD.
%SELECT IC((SHISAMDB,SHISAMDD),FIRST)
//ICDD DD DSN=%ICDSN,DISP=OLD,
// VOL=SER=(%ICVOLS),
// UNIT=%ICUNIT,
// LABEL=(%ICFSEQ,SL)
%ENDSEL

The generated DD statement might be:

//ICDD DD DSN=SHISAMDB.SHISAMDD.IC,DISP=OLD,
// VOL=SER=(VOLUM1),
// UNIT=3400,
// LABEL=(1,SL)

Selecting Change Accumulation Data Sets

The syntax of the %SELECT keyword to select change accumulation data sets is:

OO %SELECT CA(dbds_qualifier,time_qualifier) OP

dbds_qualifier and time_qualifier

DBDS qualifier and time qualifier are as specified in the section “Understanding
the Selection Criteria Parameter” on page 316.

In the execution member records following the %SELECT keyword, you use simple
keywords to specify the type of information to be gathered for each change
accumulation record that is selected. The types of information you can gather are:

326 DBRC Guide & Reference

Skeletal JCL Syntax
%CADSN The change accumulation data set name.
%CAFSEQ The file sequence number of the change accumulation data set.
%CAUNIT The unit type of the change accumulation data set.
%CAVCNT The number of volumes of the change accumulation data set.
%CAVOLS The volume serial number list of the change accumulation data set.
%CALGTM The volume stop time of the last log volume that was used as input
to the change accumulation data set. DBRC sets %CALGTM in the
form yydddhhmmsst{offset}.
%CATIME The change accumulation data set time in the form
yydddhhmmsst{offset}.
%CASEL Set to YES if any change accumulation data sets are selected.
Otherwise, set to NO.

Example 7: The following select group lists all change accumulation data sets
created since time 842310000000+0000 for CA group CAGRP1.
%SELECT CA((CAGRP1),FROM(842310000000+0000))
DSNAME=%CADSN
VOLUMES=%CAVOLS
RUNTIME=%CATIME
LOGTIME=%CALGTM
%ENDSEL

The generated output might be:

DSNAME=CAGRP1.DSN1
VOLUMES=VOLUM1,VOLUM2,VOLUM3,
VOLUM4, C
// VOLUM5,VOLUM6
RUNTIME=842310618230
LOGTIME=842302315557

DSNAME=CAGRP1.DSN2
VOLUMES=VOLUM1,VOLUM2
RUNTIME=842361824443
LOGTIME=842360934519

In this example, the volume serial number list for the first data set does not fit on
the output record. Therefore, a JCL continuation statement is generated (even
though JCL is not being generated).

Selecting DBDS Allocation (ALLOC) Records

The syntax of the %SELECT keyword to select ALLOC records can be one of the
following:

OO %SELECT ALLOC(dbds_qualifier,time_qualifier) OP

OO %SELECT ALLOC(PRILOG,time_qualifier) OP

dbds_qualifier and time_qualifier

DBDS qualifier and time qualifier are as specified in the section “Understanding
the Selection Criteria Parameter” on page 316. When a dbds_qualifier is

Appendix B. Understanding Skeletal JCL 327

Skeletal JCL Syntax
specified, ALLOC records corresponding to the specified DBDSs are selected.
All ALLOC records for the specified DBDS with allocation times within the
bounds of the specified time_qualifier are selected. When PRILOG is specified,
all ALLOC records corresponding to PRILOG records within the specified time
bounds are selected.

In the execution member records following the %SELECT keyword, you use simple
keywords to specify the type of information to be gathered for each ALLOC record
that is selected. The types of information you can gather are:
%DBNAME The database name.
%DBDDN The database ddname or area name.
%ALLTIME The allocation time stamp in the form yydddhhmmsst{offset}.
%DALTIME The deallocation time stamp in the form yydddhhmmsst{offset}. Set
to 000000000000+0000 if there is no deallocation time stamp.
%ALLDSSN The data set sequence number.
%PLGTIME The start time of the corresponding PRILOG record.
%ALLSEL Set to YES if any ALLOC records are selected. Otherwise, ALLSEL is
set to NO.
%ALLUSID The update set identifier (USID)

Example 8: The following select group generates a list of information about all
ALLOC records for the DBDS with a database name of SHISAMDB and ddname of
SHISAMDD:
%SELECT ALLOC((SHISAMDB,SHISAMDD),ALL)
DBNAME %DBNAME
DDNAME %DBDDN
ALLOC time %ALLTIME
DEALL time %DALTIME
PRILOG time %PLGTIME

The generated output might be:

DBNAME SHISAM
DDNAME SHISAM
ALLOC TIME 832560800000+0000
DEALL TIME 000000000000+0000
PRILOG TIME 832560630000+0000

Selecting DBDS Records

The syntax of the %SELECT keyword to select DBDS records is:

OO %SELECT DBDS(dbds_qualifier) OP

dbds_qualifier
DBDS qualifier is as specified in the section “Understanding the Selection
Criteria Parameter” on page 316. For DEDBs, the select group is processed
once for each defined area data set (ADS) for each specified area. For other
types of databases, the select group is processed once for each specified
DBDS.

328 DBRC Guide & Reference

Skeletal JCL Syntax
In the execution member records following the %SELECT keyword, you use simple
keywords to specify the type of information to be gathered for each DBDS record
that is selected. The types of information you can gather are:
%DBNAME The database name.
%DBDDN The DBDS ddname or DEDB area name.
%DBTYPE Set to FP when the selected DBDS is an area of a Fast Path
database. Set to DLI for DBDSs of non-HALDBs. Set to PDATA for
data DBDSs of HALDBs. Set to PINDEX for primary index DBDSs of
HALDBs. Set to PILDS for ILDS DBDSs of HALDBs.
%DBDSN The data set name of the DBDS or ADS.
%DBADDN For DEDBs, the ddname of the ADS. For other types of databases,
DBADDN is set to null.
%DBADSAV For DEDBs, set to AVAIL if the ADS is indicated as available in
RECON. Set to UNAVAIL if the ADS is unavailable. For other types
of databases, DBADSAV is set to null.
%DBDSSEL Set to YES if any DBDS records are selected. Otherwise, DBDSDEL is
set to NO.
%DBUSID For DEDBs, the update set identifier (USID) of the area. For other
types of databases, DBUSID is set to NULL.
%DBDSNRV Set to YES if the DBDS is non-recoverable. Otherwise, DBDSNRV is
set to NO.

Example 9: The following select group generates a series of DD statements for

available area data sets for the area named DBHVSAM1. This area is in the DEDB
named DIVNTZ04.
%SELECT DBDS((DIVNTZ04,DBHVSAM1))
%DELETE (%DBADSAV ne 'AVAIL')
//%DBADDN DD DSN=%DBDSN,DISP=OLD
%ENDDEL
%ENDSEL

The generated output might be:

//FP1ADD1 DD DSN=IMS.FP1ADD1,DISP=OLD
//FP1ADD2 DD DSN=IMS.FP1ADD2,DISP=OLD

Understanding Skeletal JCL Default Members

Skeletal JCL default members are used to set default values for keywords you have
defined in the skeletal JCL execution members. The use of default members is
optional. You must supply any default members to be used.

Writing Default Members

Default members can have two types of records: assignment records or comment
records. Assignment records assign default values to user-defined keywords.
Assignment records must contain a percent sign (%) in column 1. If a record does
not contain a percent sign in column 1, it is a comment record, which DBRC
ignores.

OO %user defined keyword='value' OP

Appendix B. Understanding Skeletal JCL 329

Skeletal JCL Syntax
The value assigned to the keyword can be any text string, including the null string
(''). If the value contains a single quote, you must use two single quotes. The
entire value must be contained on one record. Any data following the closing single
quote is ignored. A closing single quote is required. If a closing single quote is
missing, an error message is generated and the GENJCL command fails.

Example 10: A default member contains these records:

%DEDBNAM = 'DIVNTZ04'
%AREANAM = 'DBHVSAM1'

A skeletal JCL member contains:

DATABASE NAME = %DEDBNAM
AREA NAME = %AREANAM

Using the DEFAULTS parameter and assuming the values are not overridden, the
GENJCL command generates the following:
DATABASE NAME = DIVNTZ04
AREA NAME = DBHVSAM1

Specifying Default Members

You can specify default members either explicitly or implicitly.

Members are explicitly specified using the DEFAULTS parameter on the GENJCL
command. Up to 10 default members can be specified.

Implicit specification can be used for the GENJCL commands that apply to a DBDS
(GENJCL.IC, GENJCL.OIC, and GENJCL.RECOV) or CA group (GENJCL.CA). In addition,
implicit specification can be used on the GENJCL.USER command. The default
members to be implicitly used are specified using the DEFLTJCL parameter on the
INIT.DBDS, CHANGE.DBDS, INIT.CAGRP, and CHANGE.CAGRP commands. Only one
default member is allowed per DBDS or CA group.

The use of an implicit default member can be overridden with the NODEFLT
parameter on the GENJCL command. When both explicitly and implicitly specified
default members are used, explicitly specified members have precedence. That is, if
a keyword is assigned a value in both members, the value assigned by the explicitly
specified member is used.

If a keyword is assigned a value both in a default member and in the USERKEYS

parameter of the GENJCL command, the latter value is used. USERKEYS parameter
values override default member values.

Using User-Supplied or Modified Skeletal JCL

Before using your skeletal JCL execution or default members, you must do the
following:
v Add the JCLPDS and JCLOUT ddnames to the JCL required to run DBRC. JCLPDS
identifies the partitioned data set containing the skeletal JCL execution members.
JCLOUT identifies the data set to which the generated job is to be written. Output
is in card image format. The output data set can be a punch file, a DASD data
set that you plan to examine before submitting the job for execution, or directly to
the MVS internal reader.
v Add to the skeletal JCL execution member any STEPLIB and STEPCAT ddnames
and job accounting information that your installation requires. If the DD
statements contain comments or continuation characters, they are ignored when

330 DBRC Guide & Reference

Skeletal JCL Syntax
the JCL is generated. Except for the skeletal JCL member for the JOB statement,
do not add to your skeletal JCL any JOBCAT, JOBLIB, and JES control statements;
doing so causes errors if multiple steps are generated.

Understanding the Symbolic Keywords Recognized by DBRC

Table 13 through Table 19 on page 338 show the symbolic keywords that DBRC
recognizes in the IBM-supplied skeletal JCL execution members.

Table 13 shows the keywords that all supported utilities recognize.

Table 14 on page 332 through Table 19 on page 338 show the keywords that each
individual utility recognizes.

These figures and the figures in “Understanding the IBM-Supplied Skeletal JCL
Execution Members” on page 340 are presented in the order of the GENJCL
commands:
v GENJCL.ARCHIVE (Log Archive utility; see “GENJCL.ARCHIVE” on page 185 for
details of the command usage.)
v GENJCL.CA (Database Change Accumulation utility; see “GENJCL.CA” on
page 189 for details of the command usage.)
v GENJCL.CLOSE (Log Recovery utility; see “GENJCL.CLOSE” on page 193 for
details of the command usage.)
v GENJCL.IC and GENJCL.OIC (Database Image Copy utility, and Database Image
Copy 2 utility; Online Database Image Copy utility; see “GENJCL.IC” on
page 195 and “GENJCL.OIC” on page 202 for details of the commands usage.)
v GENJCL.RECEIVE (Database Recovery utility; see “GENJCL.RECEIVE” on
page 207 for details of the command usage.)
v GENJCL.RECOV (Database Recovery utility; see “GENJCL.RECOV” on page 211 for
details of the command usage.)

All Supported Utilities

Table 13 explains the symbolic keywords recognized by all the supported utilities.
Table 13. Symbolic Keywords in Skeletal JCL
Keyword Description
%RCNDSN1 Name of the RECON1 data set if RECONs are allocated by JCL. Set to null if
RECONs are dynamically allocated.
%RCNDSN2 Name of the RECON2 data set if RECONs are allocated by JCL. Set to null if
RECONs are dynamically allocated.
%RCNDSN3 Name of the RECON3 data set if RECONs are allocated by JCL. Set to null if
RECONs are dynamically allocated.

Appendix B. Understanding Skeletal JCL 331

Symbolic Keywords
Table 13. Symbolic Keywords in Skeletal JCL (continued)
Keyword Description
%STPNO The current step number. The step number is set to 0 if the JOB parameter
was specified on the GENJCL command. The step number is increased by 1
when DBRC first encounters it in a skeletal JCL execution member. The step
number remains at that value while the execution member is processed. As
the keyword is encountered in the remaining skeletal JCL, the current value is
substituted.

The JCL execution member can be processed again because of a multi-step

generation, or because the subsequent GENJCL command specifies NOJOB.
When it is processed again the step number is increased by 1 from its current
value when the keyword is first encountered in the next skeletal JCL
execution member. This increase takes place before the keyword value is
substituted.
%TIME The time of day, in the form hhmmss.
%GRPINDX The DBDS group member index. This keyword is set only when a DBDS
group is specified, implicitly or explicitly, on the GENJCL command. (A DBDS
group can be specified on the GENJCL.IC, GENJCL.OIC, GENJCL.RECOV, and
GENJCL.USER commands.)

When you specify a DBDS group, the keyword is initialized to 1. It is then

increased by 1 as each successive group member is processed.
%CNTR A counter controlled by DBRC. The counter is set to 0 whenever the first
GENJCL command is issued or a JOB statement is reproduced from the skeletal
JCL execution member JOBJCL. DBRC increases the counter by 1 each time
the keyword is encountered in a skeletal JCL execution member.

The JCL execution member can be processed again because of a multi-step

generation, or because the subsequent GENJCL command specifies NOJOB. If
so, the counter continues to increase from its current value when the keyword
is encountered in next skeletal JCL execution member. This increase takes
place before the keyword value is substituted.
%DATE The day of the year, in the form yyddd.
%DATE7 The day of the year, in the form yyyyddd.

Log Archive Utility (ARCHJCL)

Table 14 explains the symbolic keywords recognized by the Log Archive utility.
Table 14. Symbolic Keywords for Log Archive Utility
Keyword Description
%SSID The subsystem ID, which is set from the SSID parameter on the
GENJCL.ARCHIVE command. If the SSID parameter is not specified, the default
subsystem ID is used. The default subsystem ID is set by you in the
INIT.RECON or CHANGE.RECON command. If no default subsystem ID was
specified, the command fails.
%DDNAMES The ddnames of the OLDSs that are to be archived. If ALL is specified or
used as the default on the GENJCL.ARCHIVE command, the ddnames of all
unarchived OLDSs are determined from RECON. Otherwise, the ddnames
specified on the command are used.
%OLDSDDN The ddname of one or more specific OLDS.
%OLDSDSN The data set name of the one or more OLDS.

332 DBRC Guide & Reference

Symbolic Keywords
Table 14. Symbolic Keywords for Log Archive Utility (continued)
Keyword Description
%ARDATE The date (from the open time stamp) of the first OLDS that is to be archived.
The date is in the form yyddd where:
yy is the year
ddd is the day
%ARDATE7 The date (from the open time stamp) of the first OLDS that is to be archived.
The date is in the form yyyyddd where:
yyyy is the 4-digit year
ddd is the Julian day
%ARTIME The time (from the open time stamp) of the first OLDS that is to be archived.
The time is in the form hhmmsst where:
hh is the hour
mm is the minute
ss is the second
t is the tenth of a second
%ARVERS The archive version number of the first OLDS to be archived.
%ARCSLDS Set to YES when the SLDS parameter is specified.

Database Change Accumulation Utility (CAJCL)

Table 15 explains the symbolic keywords recognized by the Database Change
Accumulation utility.
Table 15. Symbolic Keywords for Database Change Accumulation Utility
Keyword Description
%CAGRP The CA group name.
%DSLLGTM The start time for selecting input log data. If an input change accumulation
data set is used, %DSLLGTM is set to the volume stop time of the
last-accumulated log volume.
%CAODSN The data set name of the input change accumulation data set. This keyword
is set to null if no existing change accumulation data set is defined in RECON
for the CA group.
%CAOUNIT The unit type of the input change accumulation data set. This keyword is set
to null if no existing change accumulation data set is defined in RECON for
the CA group.
%CAOVOLS The volume serial number list of the input change accumulation data set. This
keyword is set to null if there is no existing change accumulation data set is
defined in RECON for the CA group.
%CAOFSEQ The file sequence number of the input change accumulation data set. This
keyword is set to null if no existing change accumulation data set is defined in
RECON for the CA group.
%CANDSN The data set name of the output change accumulation data set. If REUSE is
specified for the CA group, the keyword is set from information in RECON. If
NOREUSE is specified, DBRC generates a data set name. The generated name
is:
IMS.cagrpname.CA.CAhhmmss

where cagrpname is the CA group name, and hhmmss is the current time of day.

Appendix B. Understanding Skeletal JCL 333

Symbolic Keywords
Table 15. Symbolic Keywords for Database Change Accumulation Utility (continued)
Keyword Description
%CANUNIT The unit type of the output change accumulation data set. If REUSE is specified
for the CA group, the keyword is set from information in RECON. If NOREUSE is
specified, this keyword is set from the UNIT parameter on the GENJCL.CA
command. If UNIT is not specified, the keyword is set to 3400.
%CANVCNT The number of volumes in the output change accumulation data set. If REUSE
is specified for the CA group, the keyword is set from information in RECON.
If NOREUSE is specified, this keyword is set from the VOLLIST parameter on the
GENJCL.CA command.
%CANVOLS The volume serial number list of the output change accumulation data set. If
REUSE is specified for the CA group, the keyword is set from information in
RECON. If NOREUSE is specified, this keyword is set from the VOLLIST
parameter on the GENJCL.CA command.
%CABFSEQ The file sequence number of the output change accumulation data set. If
REUSE is specified for the CA group, the keyword is set from information in
RECON. If NOREUSE is specified, this keyword is set to 1.
%LOGDSN The data set name of the log data set.
%LOGUNIT The unit type of the log data set.
%LOGVSEQ The volume sequence number of the log data set.
%LOGVOLS The volume serial numbers of the log data set.
%LOGFSEQ The file sequence number of the log data set.
%LOGSEL Set to YES if any log data sets were selected. Otherwise, set to NO.
%CADB0 This keyword generates the DB0 control statements for the Database Change
Accumulation utility.

Log Recovery Utility (LOGCLJCL)

Table 16 explains the symbolic keywords recognized by the Log Recovery utility.
Table 16. Symbolic Keywords for Log Recovery Utility
Keyword Description
%SSID The subsystem ID, which is set from the SSID parameter on the GENJCL.CLOSE
command. If the SSID parameter is not specified, the default subsystem ID is
used. The default subsystem ID is set by you in the INIT.RECON or
CHANGE.RECON command. If no default subsystem ID is specified, the
command fails.
%CDDNAME The ddname of the OLDS to be closed. This keyword is set from the OLDS
parameter on the GENJCL.CLOSE command. If GENJCL.CLOSE did not specify an
OLDS, the most recent open OLDS for the specified subsystem is used.
%OLDSTYP The type of OLDS, primary or secondary (set to P or S, respectively).
%OLDSDSN The data set name of the OLDS.
%WADS If the OLDS to be closed is currently open, this keyword is set to YES.
Otherwise, this keyword is set to NO.
%NDDNAME The ddname of the 'next OLDS' to be used to close the OLDS. If %WADS is set
to NO, this keyword is set to the ddname of the OLDS used immediately after
the OLDS being closed. If %WADS is set to YES, this keyword is set to null.
%PDDNAME The ddname of the immediately prior OLDS to be used to close the OLDS by
providing a last block sequence number for base point information.

334 DBRC Guide & Reference

Symbolic Keywords
Database Image Copy Utility, Database Image Copy Utility 2, and
Online Database Image Copy Utility (ICJCL and OICJCL)
Table 17 explains the symbolic keywords recognized by the Database Image Copy
utilities.
Table 17. Symbolic Keywords for Database Image Copy and Online Database Image Copy
Utility
Keyword Description
%PSB The PSB name, which is set from the PSB parameter on the GENJCLcommand.
This keyword is applicable only for the Database Online Image Copy utility.
%DBNAME The database name, which is set from the DBD parameter on the GENJCL
command.
%DBDDN The DBDS ddname, which is set from the DDN parameter on the GENJCL
command.
%DBDSN The DBDS data set name, which is set from the DBDS record in RECON.
%DBDSAM This keyword is set to VSAM for VSAM DBDS. Otherwise, it is set to null.
%DBADDN For DEDBs, the ddname of the ADS. Otherwise, set to null. This keyword is
applicable only for the Database Image Copy utility.
%DBADSAV For DEDBs, set to AVAIL if RECON indicates that the ADS is available, or
UNAVAIL if the ADS is unavailable. For other types of databases, this keyword is
set to null. This keyword is applicable only for the Database Image Copy utility.
%COPIES The number of image copy data sets to be produced. This keyword is set to 1 or
2 from the COPIES parameter on the GENJCL command.
%MDBNAME The HALDB master name, if this is a DBDS of a HALDB partition. This keyword
is set to NULL for non-HALDBs.
%SMS Indicates whether a Database Image Copy 2 (DFSUMDT0) image copy data set
is being used for the requested utility execution. If used, the keyword is set to 1;
otherwise, the keyword is set to 0.
%ICSYSIN The Database Image Copy utility control statement. Columns in the statement are
set as follows:
Column Setting
1 D
2 Number of image copy data sets to be produced (either 1 or 2)
4-11 Database name
13-20 ddname of the DBDS
22-30 ddname of the primary image copy data set
31-38 ddname of the duplicate image copy data set, if one is
produced.
40-43 Checkpoint interval (applicable only for Online Database Image
Copy utility).
All other columns are set to blanks.

Appendix B. Understanding Skeletal JCL 335

Symbolic Keywords
Table 17. Symbolic Keywords for Database Image Copy and Online Database Image Copy
Utility (continued)
Keyword Description
%ICDSN1, The data set name of the image copy data set is %ICDSN1. If NOREUSE is specified
%ICDSN2, for the DBDS, DBRC generates the following data set name:
%ICDSN3, IMS.dbname.ddname.IC.IChhmmss
%ICDSN4
where:
v dbname is the database name of the DBDS
v ddname is the ddname of the DBDs
v hhmmss is the current time of day
If multiple image copy data sets are to be produced, %ICDSN3, or %ICDSN4 are set
similarly.
%ICUNIT1, The unit type of the image copy data set. If NOREUSE is specified for the DBDS,
%ICUNIT2, %ICUNIT1 is set from the UNIT parameter on the command. If multiple image copy
%ICUNIT3, data sets are to be produced, %ICUNIT2, %ICUNIT3, or %ICUNIT4 are set similarly.
%ICUNIT4
%ICFSEQ1, The file sequence number of the image copy data set. If NOREUSE is specified for
%ICFSEQ2, the DBDS, %ICFSEQ1 is set to 1. If multiple image copy data sets are to be
%ICFSEQ3, produced, %ICFSEQ2, %ICFSEQ3, or %ICFSEQ4 are set similarly.
%ICFSEQ4
%ICVOLS1, The volume serial number of the image copy data set. If NOREUSE is specified for
%ICVOLS2, the DBDS, %ICVOLS1 is set from the VOLLIST parameter on the command. If
%ICVOLS3, multiple image copy data sets are to be produced, %ICVOLS2, %ICVOLS3, or
%ICVOLS4 %ICVOLS4 are set similarly.
%ICVCNT1, The number of volumes of the image copy data set. If NOREUSE is specified for the
%ICVCNT2, DBDS, %ICVCNT1 is set to the number of volumes specified on the VOLLIST
%ICVCNT3, parameter on the command. If multiple image copy data sets are to be produced,
%ICVCNT4 %ICVCNT2, %ICVCNT3, or %ICVCNT4 is set similarly.

Database Recovery Utility- Receive (ICRCVJCL)

Table 18 explains the symbolic keywords recognized by the Database Recovery
(Receive) utility.
Table 18. Symbolic Keywords for Database Recovery Utility
Keyword Description
%DBNAME The database name of the DBDS to be covered. %DBNAME is set from the DBD
parameter on the GENJCL.RECEIVE command.
%DBDDN The ddname of the DBDS, %DBDDN is set from the DDN parameter on the
GENJCL.RECEIVE command.
%DBDSN The data set name of the DBDS, %DBDSN is set from the DBDS record in RECON.
%DBDSAM Set to VSAM for a VSAM DBDS. Otherwise, set to null.
%DBUSID The update set identifier for the DBDS.
%ALLUSID The update set identifier of the most-recent ALLOC record for the DBDS.
%MDBNAME The HALDB master name, if this is a DBDS of a HALDB partition. This keyword
is set to NULL for non-HALDBs.
%DSLLGTM The start time for selecting input log data. If an input change accumulation data
set is used, %DSLLGTM is set to the volume stop time of the last-accumulated log
volume. Otherwise, the keyword value is set to image copy time.

336 DBRC Guide & Reference

Symbolic Keywords
Table 18. Symbolic Keywords for Database Recovery Utility (continued)
Keyword Description
%ICDSN The data set name of the image copy data set. Set to null if the USEDBDS
parameter is specified on the GENJCL.RECEIVE command. Otherwise set from the
image copy record for the DBDS.
%ICUNIT The unit type of the image copy data set. Set to null if the USEDBDS parameter is
specified on the GENJCL.RECEIVE command. Otherwise set from the image copy
record for the DBDS.
%ICVOLS The volume serial number list of the image copy data set. Set to null if the
USEDBDS parameter is specified on the GENJCL.RECEIVE command. Otherwise set
from the image copy record for the DBDS.
%ICFSEQ The file sequence number of the image copy data set. Set to null if the USEDBDS
parameter is specified on the GENJCL.RECEIVE command. Otherwise set from the
image copy record for the DBDS.
%ICUSID The update set identifier for the image copy.
%CADSN The data set name of the change accumulation data set. Set to null if no change
accumulation is available for the DBDS. Otherwise set from the change
accumulation record.
%CAUNIT The unit type of the change accumulation data set. Set to null if no change
accumulation is available for the DBDS. Otherwise set from the change
accumulation record.
%CAVOLS The volume serial number list of the change accumulation data set. Set to null if
no change accumulation is available for the DBDS. Otherwise set from the
change accumulation record.
%CAFSEQ The file sequence number of the change accumulation data set. Set to null if no
change accumulation is available for the DBDS. Otherwise set from the change
accumulation record.
%OLDFLRID The log record sequence number (log record ID) of the first log record in the
OLDS.
%OLDLLRID The log record sequence number (log record ID) of the last log record in the
OLDS. If the OLDS has not been closed, %OLDLLRID is set to null.
%SLDFLRID The log record sequence number (log record ID) of the first log record in the
SLDS.
%SLDFSEQ The file sequence number of the SLDS.
%SLDLLRID The log record sequence number (log record ID) of the last log record in the
SLDS. If the SLDS has not been closed, %SLDLLRID is set to null.
%SLDREMOT Set to YES if the SLDS data was created by an active IMS subsystem at a
tracking site. That is, the SLDS was received and written locally by the log router.
%SLDREMOT is set to null if the SLDS was created locally by an active IMS
subsystem.
%SLDUNIT Set to null if the SLDS data was created by an active IMS subsystem at a
tracking site. SLDSs received from an active site are always cataloged.
%SLDVOLS Set to null if the SLDS data was created by an active IMS subsystem at a
tracking site. SLDSs received from an active site are always cataloged.
%LOGDSN The data set name of the log data set.
%LOGUNIT The unit type of the log data set. Set to null if the RLDS data was created by an
active IMS subsystem at a tracking site. RLDSs received from an active site are
always cataloged.
%LOGVSEQ The volume sequence number of the log data set.

Appendix B. Understanding Skeletal JCL 337

Symbolic Keywords
Table 18. Symbolic Keywords for Database Recovery Utility (continued)
Keyword Description
%LOGVOLS The volume serial numbers of the log data set. Set to null if the RLDS data was
created by an active IMS subsystem at a tracking site. RLDSs received from an
active site are always cataloged.
%LOGFSEQ The file sequence number of the log data set.
%LOGSEL Set to YES if any log data sets are selected by the select group; in this case, the
delete group following the select group is deleted. Otherwise, the %LOGSEL
keyword is set to NO, and a DD DUMMY statement is generated.
%LOGFLRID The log record sequence number (log record ID) of the first log record in the
RLDS.
%LOGLLRID The log record sequence number (log record ID) of the last log record in the
RLDS. If the RLDS has not been closed, %LOGLLRID is set to null.
%LOGREMOT Set to YES if the RLDS data was created by an active IMS subsystem at a
tracking site. That is, the RLDS was received and written locally by the log router.
%LOGREMOT is set to null if the RLDS was created locally by an active IMS
subsystem.
%RVSYSIN The Database Recovery utility control statement. Columns in the statement are
set as follows:
Column Setting
1 S
4-11 Database name
13-20 Data set or area ddname
22-29 DFSUDUMP
All other columns are set to blanks.

Database Recovery Utility-Recover (RECOVJCL)

Table 19 explains the symbolic keywords recognized by the Database Recovery
(Recover) utility.
Table 19. Symbolic Keywords for Database Recovery Utility
Keyword Description
%DBNAME The database name of the DBDS to be RSR-covered. %DBNAME is set from the DBD
parameter on the GENJCL.RECOV command.
%DBDDN The ddname of the DBDS; %DBDDN is set from the DDN parameter on the
GENJCL.RECOV command.
%DBDSN The data set name of the DBDS; %DBDSN is set from the DBDS record of the
DBDSs.
%DBDSAM Set to VSAM for a VSAM DBDS. Otherwise, set to null.
%MDBNAME The HALDB master name, if this is a DBDS of a HALDB partition. This keyword
is set to NULL for non-HALDBs.
%DSLLGTM The start time for selecting input log data. If an input change accumulation data
set is used, %DSLLGTM is set to the volume stop time of the last-accumulated log
volume. Otherwise, the keyword value is set to image-copy time.
%SMS Indicates whether or not an Image Copy 2 image copy data set is being used for
the requested utility execution. Set to 1 if yes; otherwise, set to 0.

338 DBRC Guide & Reference

Symbolic Keywords
Table 19. Symbolic Keywords for Database Recovery Utility (continued)
Keyword Description
%ICDSN The data set name of the image copy data set. Set to null if the USEDBDS
parameter is specified on the GENJCL.RECOV command. Otherwise set from the
image copy record for the DBDS.
%ICUNIT The unit type of the image copy data set. Set to null if the USEDBDS parameter is
specified on the GENJCL.RECOV command. Otherwise set from the image copy
record for the DBDS.
%ICVOLS The volume serial number list of the image copy data set. Set to null if the
USEDBDS parameter is specified on the GENJCL.RECOV command. Otherwise set
from the image copy record for the DBDS.
%ICFSEQ The file sequence number of the image copy data set. Set to null if the USEDBDS
parameter is specified on the GENJCL.RECOV command. Otherwise set from the
image copy record for the DBDS.
%CADSN The data set name of the change accumulation data set. Set to null if no change
accumulation is available for the DBDS. Otherwise set from the change
accumulation record.
%CAUNIT The unit type of the change accumulation data set. Set to null if no change
accumulation is available for the DBDS. Otherwise set from the change
accumulation record.
%CAVOLS The volume serial number list of the change accumulation data set. Set to null if
no change accumulation is available for the DBDS. Otherwise set from the
change accumulation record.
%CAFSEQ The file sequence number of the change accumulation data set. Set to null if no
change accumulation is available for the DBDS. Otherwise set from the change
accumulation record.
%LOGDSN The data set name of the log data set.
%LOGUNIT The unit type of the log data set.
%LOGVSEQ The volume sequence number of the log data set.
%LOGVOLS The volume serial numbers of the log data set.
%LOGFSEQ The file sequence number of the log data set.
%LOGSEL Set to YES if any log data sets are selected by the select group; in this case, the
delete group following the select group is deleted. Otherwise, the %LOGSEL
keyword is set to NO, and a DD DUMMY statement is generated.
%RCSYSIN The Database Recovery utility control statement. Columns in the statement are
set as follows:
Column Setting
1 S
4-11 Database name
13-20 Data set ddname
31-42 The specified time stamp if the RCVTIME parameter was
specified on the GENJCL.RECOV command. Otherwise, blank.
44 C, if the USEDBDS parameter was specified on the GENJCL.RECOV
command. Otherwise, blank.
All other columns are set to blanks.
%RCVFULL Indicates whether full recoveries are to be generated. When set to YES, full
recoveries are generated. If the RCVTIME parameter was specified on the
GENJCL.RECOV command, %RCVFULL is set to NO.

Appendix B. Understanding Skeletal JCL 339

IBM-Supplied Skeletal JCL
Understanding the IBM-Supplied Skeletal JCL Execution Members
This section lists and describes each of the skeletal JCL execution members that
are provided by IBM. This skeletal JCL generates executable JCL for running the
applicable utilities.

Related Reading: Instructions on what you must do before using the skeletal JCL
execution members are in “Using IBM-Supplied Skeletal JCL” on page 310.

The JOB Statement

The IBM-supplied skeletal JCL execution member for the JOB statement is named
JOBJCL. JOBJCL is invoked when any GENJCL command is issued.

JOBJCL consists of a single statement, as follows:

//JT%TIME JOB

You need to modify JOBJCL to add job accounting information that is required by
your installation. In addition, you can add JOBLIB, STEPLIB, and JES control
statements to JOBJCL. The default job name can be modified. If you use this
supplied JOB statement, the job name is generated as JThhmmss, where hhmmss is
the time (hour, minute, second) it took for the GENJCL command to be executed.

Log Archive Utility JCL (ARCHJCL)

The IBM-supplied skeletal JCL execution member for the Log Archive utility is
named ARCHJCL. ARCHJCL is used when the GENJCL.ARCHIVE command is issued.

A description of the statements in ARCHJCL follows Figure 20 on page 341.

340 DBRC Guide & Reference

IBM-Supplied Skeletal JCL
Note: The following is the OLDS archive EXEC statement.
%DELETE (%ARCSLDS EQ 'YES')
//AR%STPNO EXEC PGM=DFSUARC0,PARM='%SSID'
%ENDDEL
Note: The following is the SLDS archive EXEC statement.
%DELETE (%ARCSLDS EQ 'NO')
//AR%STPNO EXEC PGM=DFSUARC0,PARM='DBRC=Y'
%ENDDEL
//*
//* THIS JCL ORIGINATES FROM THE USER'S 'JCLPDS' LIBRARY.
//* KEYWORDS ARE REPLACED BY THE GENJCL FUNCTION OF
//* THE IMS/ESA DATABASE RECOVERY CONTROL FEATURE.
//*
//* JCL FOR ARCHIVE UTILITY
//*
//STEPLIB DD DSN=IMSVS.RESLIB,DISP=SHR
//SYSPRINT DD SYSOUT=A
%DELETE (%RCNDSN1 EQ '')
//RECON1 DD DSN=%RCNDSN1,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN2 EQ '')
//RECON2 DD DSN=%RCNDSN2,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN3 EQ '')
//RECON3 DD DSN=%RCNDSN3,DISP=SHR
%ENDDEL
Note: The following lines are used to archive OLDS.
%DELETE (%ARCSLDS EQ 'YES')
%SELECT OLDS(%SSID,(%ddnames))
//%OLDSDDN DD DSN=%OLDSDSN,DISP=SHR
%ENDSEL
//DFSSLOGP DD DSN=IMS.SLDSP.%SSID.D%ARDATE.T%ARTIME.V%ARVERS,
// UNIT=3400,VOL=(,,,99),
// DISP=(NEW,KEEP),LABEL=(1,SL)
//DFSSLOGS DD DSN=IMS.SLDSS.%SSID.D%ARDATE.T%ARTIME.V%ARVERS,
// UNIT=3400,VOL=(,,,99),
// DISP=(NEW,KEEP),LABEL=(1,SL)
//RLDSDD1 DD DSN=IMS.RLDSP.%SSID.D%ARDATE.T%ARTIME.V%ARVERS,
// UNIT=3400,VOL=(,,,99),
// DISP=(NEW,KEEP),LABEL=(1,SL)
//RLDSDD2 DD DSN=IMS.RLDSS.%SSID.D%ARDATE.T%ARTIME.V%ARVERS,
// UNIT=3400,VOL=(,,,99),
// DISP=(NEW,KEEP),LABEL=(1,SL)
%ENDDEL

Figure 20. IBM-Supplied Skeletal JCL for the Log Archive Utility (Part 1 of 3)

Appendix B. Understanding Skeletal JCL 341

IBM-Supplied Skeletal JCL
Note: The following lines are used to archive primary SLDSs.
%DELETE (%ARCSLDS EQ 'NO')
%SELECT SLDS(%SSID,ALL)
//DFSSLDSP DD DSN=%SLDSDSN,DISP=(OLD,PASS)
%ENDSEL
%ENDDEL
%DELETE (%ARCSLDS EQ 'NO' | %SLDSSEL EQ 'NO')
//DFSSLOGP DD DSN=IMSVS.ARCH1.%SSID.D%ARDATE.T%ARTIME,
// UNIT=3400,VOL=(,,,99),
// DISP=(NEW,PASS),LABEL=(1,SL)
//RLDSDD1 DD DSN=IMSVS.RLDS1.%SSID.D%ARDATE.T%ARTIME,
// UNIT=3400,VOL=(,,,99),
// DISP=(NEW,PASS),LABEL=(1,SL)
%ENDDEL
Note: The following lines are used to archive secondary SLDSs.
%DELETE (%ARCSLDS EQ 'NO')
%SELECT SSLDS(%SSID,ALL)
//DFSSLDSS DD DSN=%SLDSDSN,DISP=(OLD,PASS)
%ENDSEL
%ENDDEL
%DELETE (%ARCSLDS EQ 'NO' | %SLDSSEL EQ 'NO')
//DFSSLOGS DD DSN=IMSVS.ARCH2.%SSID.D%ARDATE.T%ARTIME,
// UNIT=3400,VOL=(,,,99),
// DISP=(NEW,PASS),LABEL=(1,SL)
//RLDSDD2 DD DSN=IMSVS.RLDS2.%SSID.D%ARDATE.T%ARTIME,
// UNIT=3400,VOL=(,,,99),
// DISP=(NEW,PASS),LABEL=(1,SL)
%ENDDEL
Note: The following lines are common to both processes.
//SYSIN DD *
SLDS FEOV(08000)
COPY DDNOUT1(RLDSDD1) DDNOUT2(RLDSDD2) DBRECOV
/*

Figure 20. IBM-Supplied Skeletal JCL for the Log Archive Utility (Part 2 of 3)

342 DBRC Guide & Reference

IBM-Supplied Skeletal JCL
Note: The following lines are used for the SLDSs process
%DELETE (%ARCSLDS EQ 'NO')
//****************************************************************
//* *
//* The following optional steps are used to manage the data *
//* sets used in the previous SLDS archive step. If the previous *
//* step completed successfully, the input data sets will be *
//* deleted and the output data sets will be cataloged. The *
//* output data sets will be deleted if the previous step *
//* failed. *
//* *
//****************************************************************
//GOODRC%STPNO EXEC PGM=IEFBR14,COND=(0,NE,AR%STPNO)
%SELECT SLDS(%SSID,ALL)
//PSLDS1 DD DSN=%SLDSDSN,DISP=(OLD,DELETE)
%ENDSEL
%SELECT SSLDS(%SSID,ALL)
//SSLDS1 DD DSN=%SLDSDSN,DISP=(OLD,DELETE)
%ENDSEL
//DD1 DD DSN=*.AR%STPNO.DFSSLOGP,DISP=(OLD,CATLG)
//DD2 DD DSN=*.AR%STPNO.DFSSLOGS,DISP=(OLD,CATLG)
//DD3 DD DSN=*.AR%STPNO.RLDSDD1,DISP=(OLD,CATLG)
//DD4 DD DSN=*.AR%STPNO.RLDSDD2,DISP=(OLD,CATLG)
/*
//BADRC%STPNO EXEC PGM=IEFBR14,COND=(0,EQ,AR%STPNO)
//DD1 DD DSN=*.AR%STPNO.DFSSLOGP,DISP=(OLD,DELETE)
//DD2 DD DSN=*.AR%STPNO.DFSSLOGS,DISP=(OLD,DELETE)
//DD3 DD DSN=*.AR%STPNO.RLDSDD1,DISP=(OLD,DELETE)
//DD4 DD DSN=*.AR%STPNO.RLDSDD2,DISP=(OLD,DELETE)
/*
%ENDDEL

Figure 20. IBM-Supplied Skeletal JCL for the Log Archive Utility (Part 3 of 3)

You can modify this JCL to suit your needs. It is important to maintain the position
of the output DD statements (DFSSLOGP and RLDSDD1) or (DFSSLOGS and
RLDSDD2) with respect to the correct %SELECT group. So, the DD statements for the
primary output data sets (DFSSLOGP and RLDSDD1) must follow the %SELECT
SLDS(%SSID,ALL) select group and precede the %SELECT SSLDS(%SSID,ALL) select
group.

Restriction: The %ARVERS keyword is not supported for the SLDS archive process
and must not be used.
EXEC Statement
The %STPNO keyword is replaced with the current step number; then the current
step number is increased by 1. The %SSID keyword is replaced with the ID of
the IMS subsystem that created the OLDSs.

The DD Statements:
STEPLIB DD Statement
DBRC makes no changes to this statement.
SYSPRINT DD Statement
DBRC makes no changes to this statement.
RECONn DD Statements
The RECON DD statements identify the RECONs.
Each of these statements is within a delete group that is controlled by a
%RCNDSN keyword. The %RCNDSN keyword values are set from the RECON names
that are used when the GENJCL command is executed.

Appendix B. Understanding Skeletal JCL 343

IBM-Supplied Skeletal JCL
v If RECONs are allocated dynamically, the %RCNDSN keywords are set to null,
and the RECONn DD statements are deleted.
v If RECONs are allocated with JCL, the %RCNDSN keywords are set to the
name of the corresponding RECON in the GENJCL command.
v If a RECON is not used when the GENJCL command is executed (for example,
no spare RECON exists), the keyword is set to null, and the DD statement is
deleted.
OLDS DD Statements
The DD statements for the OLDSs that are to be archived are generated with a
select group. The %SSID keyword identifies the subsystem ID. The %DDNAMES
keyword identifies the OLDSs. A DD statement is generated for each specified
OLDS. The OLDS ddname replaces the %OLDSDDN keyword. The data set name
replaces the %OLDSDSN keyword.
DFSSLOGP DD Statement
This DD statement defines the primary SLDS to be created. The subsystem ID
replaces the %SSID keyword. The %ARDATE and %ARTIME keywords are replaced
with the date (yyddd) and time (hhmmsst) from the open time stamp of the oldest
OLDS being archived. The %ARVERS keyword is replaced with the archive version
number (nn) of the oldest OLDS being archived.
DFSSLOGS DD Statement
This DD statement defines the secondary SLDS that is to be created. The
subsystem ID replaces the %SSID keyword. The %ARDATE and %ARTIME keywords
are replaced with the date (yyddd) and time (hhmmsst) from the open time stamp
of the oldest OLDS that is being archived. The %ARVERS keyword is replaced
with the archive version number (nn) of the oldest OLDS that is being archived.
If you are not using dual SLDS logging, delete this DD statement from the
skeletal JCL execution member.
RLDSDD1 DD Statement
This DD statement defines the primary RLDS that is to be created. The
subsystem ID replaces the %SSID keyword. The %ARDATE and %ARTIME keywords
are replaced with the date (yyddd) and time (hhmmsst) from the open time stamp
of the oldest OLDS that is being archived. The %ARVERS keyword is replaced
with the archive version number (nn) of the oldest OLDS that is being archived.
If you are not using an RLDS, delete this statement and the RLDSDD2 DD
statement from the execution member. If this statement is deleted, the utility
control COPY statement must be deleted from the SYSIN data. DBRC does not
verify that the SYSIN data matches the DD statements.
RLDSDD2 DD Statement
This DD statement defines the secondary RLDS that is to be created. The
subsystem ID replaces the %SSID keyword. The %ARDATE and %ARTIME keywords
are replaced with the date (yyddd) and time (hhmmsst) from the open time stamp
of the oldest OLDS that is being archived. The %ARVERS keyword is replaced
with the archive version number (nn) of the oldest OLDS being archived.
If you are not using RLDS logging, delete this statement from the execution
member. If this statement is deleted, the DDNOUT2(RLDSDD2) parameter must be
deleted from the utility control COPY statement in the SYSIN data. DBRC does
not verify that the SYSIN data matches the DD statements.
SYSIN DD Statement
DBRC makes no changes to the SYSIN DD statement or to the utility control
statements in the SYSIN data.

344 DBRC Guide & Reference

IBM-Supplied Skeletal JCL
DFSSLDSP DD Statements
The DD statements for the primary SLDSs that are to be archived are
generated with a select group. The %SSID keyword identifies the subsystem ID.
A DD statement is generated for each unarchived SLDS. The SLDS data set
name replaces the %SLDSDSN keyword.
DFSSLDSS DD Statements
The DD statements for the secondary SLDSs that are to be archived are
generated with a select group. The %SSID keyword identifies the subsystem ID.
A DD statement is generated for each unarchived SLDS. The SLDS name
replaces the %SLDSDSN keyword.
DFSSLOGP DD Statement
This DD statement defines the primary SLDS that is to be created. The
subsystem ID replaces the %SSID keyword. The %ARDATE and %ARTIME keywords
are replaced with the date (yyddd) and time (hhmmsst) from the open time
stamp of the oldest OLDS or SLDS that is being archived. The %ARVERS keyword
is replaced with the archive version number (nn) of the oldest OLDS being
archived.
DFSSLOGS DD Statement
This DD statement defines the secondary SLDS that is to be created The
subsystem ID replaces the %SSID keyword. The %ARDATE and %ARTIME keywords
are replaced with the date (yyddd) and time (hhmmsst) from the open time
stamp of the oldest OLDS or SLDS that is being archived. The %ARVERS keyword
is replaced with the archive version number (nn) of the oldest OLDS that is
being archived.
If you are not using dual SLDS logging, delete these DD statements and the
DD2 DD statements from the skeletal JCL execution member.
RLDSDD1 DD Statement
This DD statement defines the primary RLDS that is to be created. The
subsystem ID replaces the %SSID keyword. The %ARDATE and %ARTIME keywords
are replaced with the date (yyddd) and time (hhmmsst) from the open time
stamp of the oldest OLDS or SLDS being archived. The %ARVERS keyword is
replaced with the archive version number (nn) of the oldest OLDS being
archived.
If you are not using an RLDS, delete these statements, the RLDSDD2 DD
statements, and the DD3 and DD4 DD statements from the execution member.
If these statements are deleted, the utility control COPY statement must be
deleted from the SYSIN data. DBRC does not verify that the SYSIN data
matches the DD statements.
RLDSDD2 DD Statement
This DD statement defines the secondary RLDS that is to be created. The
subsystem ID replaces the %SSID keyword. The %ARDATE and %ARTIME keywords
are replaced with the date (yyddd) and time (hhmmsst) from the open time
stamp of the oldest OLDS or SLDS that is being archived. The %ARVERS keyword
is replaced with the archive version number (nn) of the oldest OLDS that is
being archived.
If you are not using dual logging, delete these statements and the DD4 DD
statements from the execution member. If these statements are deleted, the
DDNOUT2(RLDSDD2) parameter must be deleted from the utility control COPY
statement in the SYSIN data. DBRC does not verify that the SYSIN data
matches the DD statements.

Appendix B. Understanding Skeletal JCL 345

IBM-Supplied Skeletal JCL
Database Change Accumulation Utility JCL (CAJCL)
The IBM-supplied skeletal JCL execution member for the Database Change
Accumulation utility is named CAJCL. CAJCL is used when the GENJCL.CA
command is issued. You can specify an execution member other than CAJCL by
using the CAJCL parameter on the INIT.CAGRP or CHANGE.CAGRP commands.

A description of the statements in CAJCL follows Figure 21 on page 347.

346 DBRC Guide & Reference

IBM-Supplied Skeletal JCL
//CA%STPNO EXEC PGM=DFSUCUM0,PARM='CORE=100000',REGION=800K
//*
//* THIS JCL ORIGINATES FROM THE USER'S 'JCLPDS' LIBRARY.
//* KEYWORDS ARE REPLACED BY THE GENJCL FUNCTION OF
//* THE IMS/ESA DATABASE RECOVERY CONTROL FEATURE.
//*
//* JCL FOR CHANGE ACCUMULATION
//*
//STEPLIB DD DSN=IMS.RESLIB,DISP=SHR
//SYSPRINT DD SYSOUT=A
%DELETE (%RCNDSNl EQ '')
//RECON1 DD DSN=%RCNDSNl,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN2 EQ '')
//RECON2 DD DSN=%RCNDSN2,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN3 EQ '')
//RECON3 DD DSN=%RCNDSN3,DISP=SHR
%ENDDEL
//IMS DD DSN=IMS.DBDLIB,DISP=SHR
//SYSOUT DD SYSOUT=A
//SORTLIB DD DSN=SYS1.SORTLIB,DISP=SHR
//SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(2),,CONTIG)
//SORTWK02 DD UNIT=SYSDA,SPACE=(CYL,(2),,CONTIG)
//SORTWK03 DD UNIT=SYSDA,SPACE=(CYL,(2),,CONTIG)
//SORTWK04 DD UNIT=SYSDA,SPACE=(CYL,(2),,CONTIG)
//SORTWK05 DD UNIT=SYSDA,SPACE=(CYL,(2),,CONTIG)
//SORTWK06 DD UNIT=SYSDA,SPACE=(CYL,(2),,CONTIG)
%DELETE (%CAODSN EQ '')
//DFSUCUMO DD DSN=%CAODSN,UNIT=%CAOUNIT,
// VOL=(PRIVATE,,,,SER=(%CAOVOLS)),
// LABEL=(%CAOFSEQ,SL),
// DISP=OLD
%ENDDEL
%DELETE (%CAODSN NE '')
//DFSUCUMO DD DUMMY,DCB=BLKSIZE=100
%ENDDEL
//DFSUCUMN DD DSN=%CANDSN,UNIT=%CANUNIT,
// VOL=(PRIVATE,,,%CANVCNT,SER=(%CANVOLS)),
// LABEL=(%CANFSEQ,SL),
// DISP=(NEW,KEEP)
%SELECT RLDS((%CAGRP),(FROM(%DSLLGTM)))
//DFSULOG DD DSN=%LOGDSN,UNIT=%LOGUNIT,
// VOL=(PRIVATE,,%LOGVSEQ,,SER=(%LOGVOLS)),
// LABEL=(%logfseq,SL),
// DCB=RECFM=VB,
// DISP=OLD
%ENDSEL
%DELETE (%LOGSEL EQ 'YES')
//DFSULOG DD DUMMY,DCB=BLKSIZE=100
%ENDDEL
//DFSUDD1 DD DUMMY
//SYSIN DD *
%CADB0
/*

Figure 21. IBM-Supplied Skeletal JCL for the Database Change Accumulation Utility

EXEC Statement
The %STPNO keyword is replaced with the current step number; then the current
step number is increased by 1.

The DD Statements:

Appendix B. Understanding Skeletal JCL 347

IBM-Supplied Skeletal JCL
STEPLIB DD Statement
DBRC makes no changes to this statement.
SYSPRINT DD Statement
DBRC makes no changes to this statement.
RECONn DD Statements
The RECON DD statements identify the RECONs.
Each of these statements is within a delete group that is controlled by a
%RCNDSN keyword. The %RCNDSN keyword values are set from the RECON names
that are used when the GENJCL command is executed.
v If RECONs are allocated dynamically, the %RCNDSN keywords are set to null,
and the RECONn DD statements are deleted.
v If RECONs are allocated with JCL, the %RCNDSN keywords are set to the
name of the corresponding RECON in the GENJCL command.
v If a RECON is not used when the GENJCL command is executed (for example,
no spare RECON exists), the keyword is set to null, and the DD statement is
deleted.
IMS DD Statement
DBRC makes no changes to this statement.
SYSOUT DD Statement
DBRC makes no changes to this statement.
SORTLIB DD Statement
DBRC makes no changes to this statement.
SORTWKn DD Statements
DBRC makes no changes to these statements.
DFSUCUMO DD Statement
This statement identifies a previously created change accumulation data set
that is used as input.
Two delete groups are used to generate this DD statement. If no existing
change accumulation data set is defined in RECON for the CA group, the value
of the %CAODSN keyword is null. Thus, the first delete group is deleted, and the
DFSUCUMO DD statement is generated as DUMMY,DCB=BLKSIZE=100.
If an input change accumulation data set is defined in RECON, the %CAODSN
keyword is set to the data set name. Thus, the second delete group is deleted,
and the DFSUCUMO DD statement identifies the input data set. Other keywords
relating to the output data set are replaced as follows:
%CAODSN Data set name
%CAOUNIT Unit type
%CAOVOLS Volume serial number list
%CAOFSEQ File sequence number
DFSUCUMN DD Statement
This DD statement identifies the output change accumulation data set. Other
keywords relating to the output data set are replaced as follows:
%CANDSN Data set name
%CANUNIT Unit type
%CANVCNT Volume count
%CANVOLS Volume serial numbers

348 DBRC Guide & Reference

IBM-Supplied Skeletal JCL
%CANFSEQ File sequence number
DFSULOG DD Statement
This DD statement identifies the IMS log data sets that are to be used as input
to the Database Change Accumulation utility. A select group selects the required
log data sets. %CAGRP identifies the CA group for which log data sets are to be
selected. All log volumes that are not previously processed for the CA group are
selected. Other keywords for the selected data sets are replaced as follows:
%LOGDSN Data set name
%LOGUNIT Unit type
%LOGVSEQ Volume sequence number
%LOGVOLS Volume serial numbers
%LOGFSEQ File sequence numbers

If any log data sets are selected by the select group, the value of the %LOGSEL
keyword in the next delete group is YES; this causes the delete group to be
deleted. Otherwise, the %LOGSEL keyword is set to NO, and a DD DUMMY statement
is generated.
DFSUDD1 DD Statement
DBRC makes no changes to this statement.
The DFSUDD1 DD statement identifies the optional output log data set that is
produced by the Database Change Accumulation utility. DBRC does not record
the optional output log data set; therefore, the skeletal JCL execution member
specifies the DFSUDD1 DD statement as DUMMY.
SYSIN DD Statement
DBRC makes no changes to this statement.
DB0 Control Statements
A DB0 control statement is generated for each DBDS in the CA group. Each
generated DB0 control statement has:
columns 1-3 DB0
columns 4-11 The database name
columns 12-20 The image-copy time stamp (in the form
yydddhhmm)
columns 21-28 The database ddname

Log Recovery Utility JCL (LOGCLJCL)

The IBM-supplied skeletal JCL execution member for the Log Recovery utility is
named LOGCLJCL. LOGCLJCL is used when the GENJCL.CLOSE command is
issued.

A description of the statements in LOGCLJCL follows Figure 22 on page 350.

Appendix B. Understanding Skeletal JCL 349

IBM-Supplied Skeletal JCL
//CL%STPNO EXEC PGM=DFSULTR0,PARM='IMSID=%SSID'
//*
//* THIS JCL ORIGINATES FROM THE USER'S 'JCLPDS' LIBRARY.
//* KEYWORDS ARE REPLACED BY THE GENJCL FUNCTION OF
//* THE IMS/ESA DATABASE RECOVERY CONTROL FEATURE.
//*
//* JCL FOR LOG RECOVERY UTILITY
//*
//STEPLIB DD DSN=IMS.RESLIB,DISP=SHR
//SYSPRINT DD SYSOUT=A
%DELETE (%RCNDSNl EQ '')
//RECON1 DD DSN=%RCNDSN1,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN2 EQ '')
//RECON2 DD DSN=%RCNDSN2,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN3 EQ '')
//RECON3 DD DSN=%RCNDSN3,DISP=SHR
%ENDDEL
%SELECT OLDS(%SSID,(%CDDNAME))
//DFSOL%OLDSTYP DD DSN=%OLDSDSN,DISP=SHR
%ENDSEL
%DELETE (%WADS EQ 'NO')
//DFSWADS0 DD DSN=IMS.WADS0,DISP=OLD
%ENDDEL
%DELETE (%WADS EQ 'YES')
%SELECT OLDS(%SSID,(%NDDNAME))
//DFSNOL%OLDSTYP DD DSN=%OLDSDSN,DISP=SHR
%ENDSEL
%ENDDEL
%DELETE (%PDDNAME EQ '')
%SELECT OLDS(%SSID, (%PDDNAME))
//DFSPOL%OLDSTYP DD DSN=%OLDSDSN,DISP=SHR
%ENDSEL
%ENDDEL
//SYSIN DD *
CLS
/*

Figure 22. IBM-Supplied Skeletal JCL for the Log Recovery Utility

EXEC Statement
The %STPNO keyword is replaced with the current step number; then the current
step number is increased by 1. The %SSID keyword is replaced with the ID of
the IMS subsystem that created the OLDS that is to be closed.
STEPLIB DD Statement
DBRC makes no changes to this statement.
SYSPRINT DD Statement
DBRC makes no changes to this statement.
RECONn DD Statements
The RECON DD statements identify the RECONs.
Each of these statements is within a delete group that is controlled by a
%RCNDSN keyword. The %RCNDSN keyword values are set from the RECON names
that are used when the GENJCL command is executed.
v If RECONs are allocated dynamically, the %RCNDSN keywords are set to null,
and the RECONn DD statements are deleted.
v If RECONs are allocated with JCL, the %RCNDSN keywords are set to the
name of the corresponding RECON in the GENJCL command.

350 DBRC Guide & Reference

IBM-Supplied Skeletal JCL
v If a RECON is not used when the GENJCL command is executed (for example,
no spare RECON exists), the keyword is set to null, and the DD statement is
deleted.
OLDS DD Statement
This DD statement identifies the OLDS that is to be closed. A select group is
used to select the OLDS. The %SSID keyword identifies the subsystem ID, and
the %CDDNAME identifies the OLDS by its DD name. The OLDS type, primary or
secondary, replaces the %OLDSTYP keyword. The resulting ddname is DFSOLP or
DFSOLS. The %OLDSDSN keyword is replaced with the data set name of the OLDS.
WADS DD Statement
This statement is provided only as a model. You must change it before using
the skeletal JCL execution member.
The supplied DFSWADS0 DD statement must be replaced with DD statements
DFSWADS0 through DFSWADSn. n+1 is the number of WADSs that the online IMS
control region uses. The WADS DD statements are contained in a select group
that is controlled by the keyword %WADS. The GENJCL.CLOSE command processor
sets the value of the %WADS keyword to YES if the OLDS is to be closed using the
WADS. The command processor sets the value to NO if the OLDS is to be
closed using the next OLDS. The WADS DD statements are, therefore, deleted if
the OLDS is to be closed using the next OLDS.
Next OLDS DD Statements
If the OLDS is to be closed using the next OLDS, these DD statements identify
the next OLDSs. These statements are contained in a delete group that is
controlled by the %WADS keyword. Thus, if the OLDS is to be closed using the
WADS, these statements are deleted. A select group is used in order to select
the next OLDSs. The %SSID keyword identifies the subsystem ID. The %NDDNAME
keyword identifies the next OLDS by ddname. The OLDS type, primary or
secondary, replaces the %OLDSTYP keyword. The resulting ddname is DFSNOLP or
DFSNOLS. The %OLDSDSN keyword is replaced with the data set name of the
OLDS.
Prior OLDS DD Statements
If an immediately prior OLDS exists, the corresponding DD statement identifies
the immediately prior OLDS. These statements are contained in a delete group
that is controlled by the %PDDNAME keyword. If its value is not null, a select group
is used in order to select the immediately prior OLDS. The resulting ddname is
DFSPOLP or DFSPOLS. Processing of the other keywords is as described under
Next OLDS DD Statements, above.
SYSIN DD Statement
DBRC makes no changes to the SYSIN DD statement or to the utility control
statements in the SYSIN data.

Database Image Copy Utility JCL (ICJCL)

The IBM-supplied skeletal JCL execution member for the Database Image Copy
and Database Image Copy 2 utility is named ICJCL.

ICJCL is used when the GENJCL.IC command is issued. You can specify an
execution member other than ICJCL by using the ICJCL parameter on the INIT.DBDS
or CHANGE.DBDS commands.

A description of the statements in ICJCL follows Figure 23 on page 352.

Appendix B. Understanding Skeletal JCL 351

IBM-Supplied Skeletal JCL
//IC%STPNO EXEC PGM=%PGMIC,REGION=800K,
// PARM='%PARMX'
//*
//*
//* THIS JCL ORIGINATES FROM THE USER'S 'JCLPDS' LIBRARY.
//* KEYWORDS ARE REPLACED BY THE GENJCL FUNCTION OF
//* THE IMS/ESA DATA BASE RECOVERY CONTROL FEATURE.
//*
//* JCL FOR IMAGE COPY.
//*
//STEPLIB DD DSN=IMSVS.RESLIB,DISP=SHR
//SYSPRINT DD SYSOUT=A
%DELETE (%RCNDSN1 EQ '')
//RECON1 DD DSN=%RCNDSN1,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN2 EQ '')
//RECON2 DD DSN=%RCNDSN2,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN3 EQ '')
//RECON3 DD DSN=%RCNDSN3,DISP=SHR
%ENDDEL
//IMS DD DSN=IMSVS.DBDLIB,DISP=SHR
%SELECT DBDS((%DBNAME,%DBDDN))
%DELETE (%DBADSAV NE 'AVAIL')
//%DBADDN DD DSN=%DBDSN,DISP=%CICDISP
%ENDDEL
%DELETE (%DBADSAV NE '')
//%DBDDN DD DSN=%DBDSN,DISP=%CICDISP
%ENDDEL
%ENDSEL
//DATAOUT1 DD DSN=%ICDSN1,UNIT=%ICUNIT1,
// VOL=(PRIVATE,,,%ICVCNT1,SER=(%ICVOLS1)),
// LABEL=(%ICFSEQ1,SL),
%DELETE (%SMS EQ '1')
// DISP=(NEW,KEEP),DCB=BUFNO=10
%ENDDEL
%DELETE (%SMS NE '1')
// DISP=(NEW,KEEP)
%ENDDEL

Figure 23. IBM-Supplied Skeletal JCL for the Database Image Copy Utility (Part 1 of 2)

352 DBRC Guide & Reference

IBM-Supplied Skeletal JCL
%DELETE (%COPIES EQ '1' | %SMS EQ '1')
//DATAOUT2 DD DSN=%ICDSN2,UNIT=%ICUNIT2,
// VOL=(PRIVATE,,,%ICVCNT2,SER=(%ICVOLS2)),
// LABEL=(%ICFSEQ2,SL),
// DISP=(NEW,KEEP),DCB=BUFNO=10
%ENDDEL
%DELETE (%COPIES EQ '1' | %SMS NE '1')
//DATAOUT2 DD DSN=%ICDSN2,UNIT=%ICUNIT2,
// VOL=(PRIVATE,,,%ICVCNT2,SER=(%ICVOLS2)),
// LABEL=(%ICFSEQ2,SL),
// DISP=(NEW,KEEP)
%ENDDEL
%DELETE (%COPIES LE '2' | %SMS EQ '1')
//DATAOUT3 DD DSN=%ICDSN3,UNIT=%ICUNIT3,
// VOL=(PRIVATE,,,%ICVCNT3,SER=(%ICVOLS3)),
// LABEL=(%ICFSEQ3,SL),
// DISP=(NEW,KEEP),DCB=BUFNO=10
%ENDDEL
%DELETE (%COPIES LE '2' | %SMS NE '1')
//DATAOUT3 DD DSN=%ICDSN3,UNIT=%ICUNIT3,
// VOL=(PRIVATE,,,%ICVCNT3,SER=(%ICVOLS3)),
// LABEL=(%ICFSEQ3,SL),
// DISP=(NEW,KEEP)
%ENDDEL
%DELETE (%COPIES LE '3' | %SMS EQ '1')
//DATAOUT4 DD DSN=%ICDSN4,UNIT=%ICUNIT4,
// VOL=(PRIVATE,,,%ICVCNT4,SER=(%ICVOLS4)),
// LABEL=(%ICFSEQ4,SL),
// DISP=(NEW,KEEP),DCB=BUFNO=10
%ENDDEL
%DELETE (%COPIES LE '3' | %SMS NE '1')
//DATAOUT4 DD DSN=%ICDSN4,UNIT=%ICUNIT4,
// VOL=(PRIVATE,,,%ICVCNT4,SER=(%ICVOLS4)),
// LABEL=(%ICFSEQ4,SL),
// DISP=(NEW,KEEP)
%ENDDEL
//SYSIN DD *
%ICSYSIN
/*

Figure 23. IBM-Supplied Skeletal JCL for the Database Image Copy Utility (Part 2 of 2)

EXEC Statement
The %STPNO keyword is replaced with the current step number; then the current
step number is increased by 1.
STEPLIB DD Statement
DBRC makes no changes to this statement.
SYSPRINT DD Statement
DBRC makes no changes to this statement.
RECONn DD Statements
The RECON DD statements identify the RECONs.
Each of these statements is within a delete group that is controlled by a
%RCNDSN keyword. The %RCNDSN keyword values are set from the RECON names
that are used when the GENJCL command is executed.
v If RECONs are allocated dynamically, the %RCNDSN keywords are set to null,
and the RECONn DD statements are deleted.
v If RECONs are allocated with JCL, the %RCNDSN keywords are set to the
name of the corresponding RECON in the GENJCL command.

Appendix B. Understanding Skeletal JCL 353

IBM-Supplied Skeletal JCL
v If a RECON is not used when the GENJCL command is executed (for example,
no spare RECON exists), the keyword is set to null, and the DD statement is
deleted.
IMS DD Statement
DBRC makes no changes to this statement.
%DBADDN DD Statement
This statement identifies the available ADS that is to be used. The %DBADDN
keyword is replaced with the ddname of the ADS. The %DBDSN keyword is
replaced with the ADS name.
%DBDNN DD Statement
This statement identifies the DBDS that is to be copied. The %DBDDN keyword is
replaced with the ddname of the DBDS. The %DBDSN keyword is replaced by the
data set name of the DBDS.
DATAOUT1 DD Statement
This statement identifies the first image copy data set that is produced by an
Image Copy utility. Other keywords relating to the image copy data set are
replaced as follows:
%ICDSN1 Data set name
%ICVCNT1 Volume count
%ICVOLS1 Volume serial number list
%ICUNIT1 Unit type
%ICFSEQ1 File sequence number
DATAOUT2 | 3 | 4 DD Statement
These statement identifies the subsequent images that are produced by the
Image Copy utility. This DD statement is within a delete group that is controlled
by the %COPIES keyword. The %COPIES keyword is set to 1 if a single image copy
data set is to be produced or to a 2, 3, or 4 if multiple image copy data sets
are to be produced. If %COPIES is 1, the group is deleted.
The %ICDSNx, %ICVCNTx, %ICVOLSx, %ICUNITx, and %ICFSEQx keywords are
replaced with the same type of information as is shown under the %DATAOUT1 DD
statement just preceding. x can be either 2, 3 or 4.
SYSIN DD Statement
DBRC makes no changes to this statement.
%ICSYSIN Statement
The Image Copy utility control statement replaces the %ICSYSIN keyword.
The %ICSYSIN statement is required. If the %ICSYSIN statement is deleted, the
GENJCL.IC command fails.

Online Database Image Copy Utility JCL (OICJCL)

The IBM-supplied skeletal JCL execution member for the Online Image Copy utility
is named OICJCL. OICJCL is used when the GENJCL.OIC command is issued. You
can specify an execution member other than OICJCL by using the OICJCL
parameter on the INIT.DBDS or CHANGE.DBDS commands.

A description of the statements in OICJCL follows Figure 24 on page 355.

354 DBRC Guide & Reference

IBM-Supplied Skeletal JCL
//OIC%STPNO EXEC PGM=DFSRRC00,PARM='BMP,DFSUICP0,%PSB,,MASTER',
// REGION=700K
//*
//* THIS JCL ORIGINATES FROM THE USER'S 'JCLPDS' LIBRARY.
//* KEYWORDS ARE REPLACED BY THE GENJCL FUNCTION OF
//* THE IMS/ESA DATABASE RECOVERY CONTROL FEATURE.
//*
//* JCL FOR ONLINE IMAGE COPY
//*
//STEPLIB DD DSN=IMS.RESLIB,DISP=SHR
//SYSPRINT DD SYSOUT=A
%DELETE (%RCNDSN1 EQ '')
//RECON1 DD DSN=%RCNDSN1,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN2 EQ '')
//RECON2 DD DSN=%RCNDSN2,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN3 EQ '')
//RECON3 DD DSN=%RCNDSN3,DISP=SHR
%ENDDEL
//IMS DD DSN=IMS.DBDLIB,DISP=SHR
//DATAOUT1 DD DSN=%ICDSN1,UNIT=%ICUNIT1,
// VOL=(PRIVATE,,,%ICVCNT1,SER=(%ICVOLS1)),
// LABEL=(%ICFSEQ1,SL),
// DISP=(NEW,KEEP)
%DELETE (%COPIES, EQ '1')
//DATAOUT2 DD DSN=%ICDSN2,UNIT=%ICUNIT2,
// VOL=(PRIVATE,,,%ICVCNT2,SER=(%ICVOLS2)),
// LABEL=(%ICFSEQ2,SL),
// DISP=(NEW,KEEP)
%ENDDEL
//DFSUCKPT DD DSN=IMS.%DBNAME.%DBDDN.CHECKPT.IC%time,
// UNIT=SYSDA,SPACE=(TRK,1),DISP=(NEW,CATLG)
//SYSIN DD *
%ICSYSIN
/*

Figure 24. IBM-Supplied Skeletal JCL for the Online Database Image Copy Utility

EXEC Statement
The %STPNO keyword is replaced with the current step number; then the current
step number is increased by 1. The PSB name that is specified on the
GENJCL.OIC command replaces the %PSB keyword.
STEPLIB DD Statement
DBRC makes no changes to this statement.
SYSPRINT DD Statement
DBRC makes no changes to this statement.
RECONn DD Statements
The RECON DD statements identify the RECONs.
Each of these statements is within a delete group that is controlled by a
%RCNDSN keyword. The %RCNDSN keyword values are set from the RECON names
that are used when the GENJCL command is executed.
v If RECONs are allocated dynamically, the %RCNDSN keywords are set to null,
and the RECONn DD statements are deleted.
v If RECONs are allocated with JCL, the %RCNDSN keywords are set to the
name of the corresponding RECON in the GENJCL command.
v If a RECON is not used when the GENJCL command is executed (for example,
no spare RECON exists), the keyword is set to null, and the DD statement is
deleted.

Appendix B. Understanding Skeletal JCL 355

IBM-Supplied Skeletal JCL
IMS DD Statement
DBRC makes no changes to this statement.
DATAOUT1 DD Statement
This statement identifies the first image copy data set that is produced by the
Image Copy utility. Other keywords relating to the online image copy data set
are replaced as follows:
%ICDSN1 Data set name
%ICVCNT1 Volume count
%ICVOLS1 Volume serial number list
%ICUNIT1 Unit type
%ICFSEQ1 File sequence number
DATAOUT2 DD Statement
This statement identifies the duplicate image copy data set that produced by the
Image Copy utility. This DD statement is within a delete group controlled by the
%COPIES keyword. The %COPIES keyword is set to 1 if a single image copy data
set is to be produced or to 2 if duplicate image copy data sets are to be
produced. If %COPIES is 1, the group is deleted.
The %ICDSN2, %ICVCNT2, %ICVOLS2, %ICUNIT2, and %ICFSEQ1 keywords are
replaced with the same type of information as is shown under the %DATAOUT1 DD
statement just preceding.
DFSUCKPT DD Statement
The DFSUCKPT DD statement identifies the optional online image copy checkpoint
data set. Keywords relating to this optional data set are replaced as follows:
%DBNAME Database name
%DBDDN ddname
%TIME Current time of day (in the form hhmmss)

The volume serial number and device type for the checkpoint data set are not
specified in the IBM-supplied skeletal JCL. You must supply these if checkpoint
data sets are to be used.

The DFSUCKPT DD statement is optional. If checkpoint data sets are not to be

used by the Online Image Copy utility, the statement can be deleted.
SYSIN DD Statement
DBRC makes no changes to this statement.
%ICSYSIN Statement
The Image Copy utility control statement replaces the %ICSYSIN keyword.

Database Recovery Utility JCL-Image Copy Receive-Tracking Site

(ICRCVJCL)
The IBM-supplied skeletal JCL execution member for the Database Recovery utility
(as used at the tracking site to receive the image copy) is named ICRCVJCL.
ICRCVJCL is used when the GENJCL.RECEIVE command is issued. You can specify
an execution member other than ICRCVJCL by using the RECVJCL parameter on the
INIT.DBDS or CHANGE.DBDS commands.

A description of the statements in ICRCVJCL follows Figure 25 on page 357.

356 DBRC Guide & Reference

IBM-Supplied Skeletal JCL
//RCV%STPNO EXEC PGM=DFSRRC00,REGION=1300K,
// PARM='UDR,DFSURDB0,%DBNAME',,,,,,,,,,,,,,,,,,,,,%GSGNAME'
//*
//* THIS JCL ORIGINATES FROM THE USER'S 'JCLPDS' LIBRARY.
//* KEYWORDS ARE REPLACED BY THE GENJCL FUNCTION OF
//* THE IMS/VS DATA BASE RECOVERY CONTROL FEATURE.
//*
//* JCL FOR IMAGE COPY RECEIVE
//*
//STEPLIB DD DSN=IMSVS.RESLIB,DISP=SHR
//SYSPRINT DD SYSOUT=A
%DELETE (%RCNDSN1 EQ '')
//RECON1 DD DSN=%RCNDSN1,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN2 EQ '')
//RECON2 DD DSN=%RCNDSN2,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN3 EQ '')
//RECON3 DD DSN=%RCNDSN3,DISP=SHR
%ENDDEL
//IMS DD DSN=IMSVS.DBDLIB,DISP=SHR
//%DBDDN DD DSN=%DBDSN,
%DELETE (%DBDSAM EQ 'VSAM')
// UNIT=SYSDA,
// VOL=SER=VOLSER,
// SPACE=(CYL,(20,2)),
// DISP=(NEW,KEEP),
// DCB=BUFNO=10
%ENDDEL
%DELETE (%DBDSAM NE 'VSAM')
// DISP=OLD
%ENDDEL
//DFSUDUMP DD DSN=%ICDSN,UNIT=%ICUNIT,
// VOL=(PRIVATE,,,,SER=(%ICVOLS)),
// LABEL=(%ICFSEQ,SL),
// DISP=(OLD,KEEP),DCB=BUFNO=10
%DELETE (%LOGSEL EQ 'YES')
//DFSULOG DD DUMMY
%ENDDEL
%DELETE (%CADSN NE '')
//DFSUCUM DD DUMMY
%ENDDEL
//DFSVSAMP DD *
1024,4
4096,4
//SYSIN DD *
%RVSYSIN
/*

Figure 25. IBM-Supplied Skeletal JCL for the Database Recovery Utility

EXEC Statement
The %STPNO keyword is replaced with the current step number; then the current
step number is increased by 1. The %DBNAME keyword is replaced with the
database name of the DBDS or area that is being received.

The DD Statements:
STEPLIB DD Statement
DBRC makes no changes to this statement.
SYSPRINT DD Statement
DBRC makes no changes to this statement.

Appendix B. Understanding Skeletal JCL 357

IBM-Supplied Skeletal JCL
RECONn DD Statements
The RECON DD statements identify the RECONs.
Each of these statements is within a delete group that is controlled by a
%RCNDSN keyword. The %RCNDSN keyword values are set from the RECON names
that are used when the GENJCL command is executed.
v If RECONs are allocated dynamically, the %RCNDSN keywords are set to null,
and the RECONn DD statements are deleted.
v If RECONs are allocated with JCL, the %RCNDSN keywords are set to the
name of the corresponding RECON in the GENJCL command.
v If a RECON is not used when the GENJCL command is executed (for example,
no spare RECON exists), the keyword is set to null, and the DD statement is
deleted.
IMS DD Statement
DBRC makes no changes to this statement.
%DBDDN DD Statement
The %DBDDN keyword is replaced by the ddname of the DBDS that is being
received. The %DBDSN keyword is replaced by the data set name of the DBDS or
area.
Delete groups control the remainder of the %DBDDN DD statement. The access
method of the DBDS controls the content of the delete groups. If the access
method is VSAM, DISP=OLD is generated. Otherwise, the UNIT, VOL, SPACE, DISP,
and DCB parameters are generated.
DFSUDUMP DD Statement
This DD statement identifies the image copy data set that is to be received. The
%ICDSN, %ICUNIT, %ICVOLS, and %ICFSEQ keywords are set from the appropriate
fields in the image copy RECON record.
DFSUCUM DD Statement
This DD statement is always listed as DUMMY at the tracking site.
DFSULOG DD Statement
This DD statement is always listed as DUMMY at the tracking site.
DFSVSAMP DD Statement
The DFSVSAMP DD statement identifies information that is required by the DL/I
buffer handler. DBRC makes no changes to these statements.
SYSIN DD Statement
This DD statement contains database recovery statements that control the
processing.
%RVSYSIN Statement
DBRC replaces the %RVSYSIN keyword.

Database Recovery Utility JCL (RECOVJCL)

The IBM-supplied skeletal JCL execution member for the Database Recovery utility
is named RECOVJCL. RECOVJCL is used when the GENJCL.RECOV command is
issued. You can specify an execution member other than RECOVJCL by using the
RECOVJCL parameter on the INIT.DBDS or CHANGE.DBDS commands.

A description of the statements in RECOVJCL follows:

358 DBRC Guide & Reference

IBM-Supplied Skeletal JCL
%DELETE (%MDBNAME NE ’’)
//RCV%STPNO EXEC PGM=DFSRRC00,REGION=1300K,
// PARM='UDR,DFSURDB0,%DBNAME,,,,,,,,,,,,,,,,,,,%GSGNAME'
%ENDDEL
%DELETE (%MDBNAME EQ ’’)
//RCV%STPNO EXEC PGM=DFSRRC00,REGION=1300K,
// PARM=’UDR,DFSURDB0,%MDBNAME,,,,,,,,,,,,,,,,,,%GSGNAME’
%ENDDEL
//*
//*
//* THIS JCL ORIGINIATES FROM THE USER’S ’JCLPDS’ LIBRARY.
//* KEYWORDS ARE REPLACED BY THE GENJCL FUNCTION OF
//* THE IMS/VS DATA BASE RECOVERY CONTROL FEATURE.
//*
//* JCL FOR RECOVERY.
//*
//STEPLIB DD DSN=IMSVS.SDFSRESL,DISP=SHR
//SYSPRINT DD SYSOUT=A
%DELETE (%RCNDSN1 EQ '')
//RECON1 DD DSN=%RCNDSN1,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN2 EQ '')
//RECON2 DD DSN=%RCNDSN2,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN3 EQ '')
//RECON3 DD DSN=%RCNDSN3,DISP=SHR
%ENDDEL
//IMS DD DSN=IMSVS.DBDLIB,DISP=SHR
//%DBDDN DD DSN=%DBDSN,
%DELETE (%DBDSAM EQ 'VSAM' | %SMS EQ '1')
// UNIT=SYSDA,
// VOL=SER=VOLSER,
// SPACE=(CYL,(20,2)),
// DISP=(NEW,KEEP),
// DCB=BUFNO=10
%ENDDEL
%DELETE (%DBDSAM EQ 'VSAM' | %SMS EQ '0')
// UNIT=SYSDA,
// VOL=SER=VOLSER,
// SPACE=(CYL,(20,2)),
// DISP=(NEW,KEEP)
%ENDDEL
%DELETE (%DBDSAM NE 'VSAM')
// DISP=OLD
%ENDDEL
%DELETE (%ICDSN EQ '')
//DFSUDUMP DD DSN=%ICDSN,
%ENDDEL

Figure 26. IBM-Supplied Skeletal JCL for the Database Recovery Utility (Part 1 of 3)

Appendix B. Understanding Skeletal JCL 359

IBM-Supplied Skeletal JCL
%DELETE (%ICCAT EQ ’YES’)
// UNIT=%ICUNIT,
// VOL=(PRIVATE,,,,SER=(%ICVOLS)),
// LABEL=(%ICFSEQ,SL),
%ENDDEL
%DELETE (%ICDSN EQ ’’ | %SMS EQ ’1’)
// DISP=(OLD,KEEP),DCB=BUFNO=10
%ENDDEL
%DELETE (%ICDSN EQ ’’ | %SMS EQ ’0’
// DISP=(OLD,KEEP),DCB=BUFNO=10
%ENDDEL
%DELETE (ICDSN EQ ’’ | %SMS EQ ’0’)
// DISP=(OLD,KEEP)
%ENDDEL
%DELETE (%AICDSN NE ’’)
//DFSUDUMP DD DUMMY
%ENDDEL
//DFSVDUMP DD DUMMY
%DELETE (%CADSN EQ ’’)
//DFSUCUM DD DSN=%CADSN,UNIT=%CAUNIT,
// VOL=(PRIVATE,,,,SER=(%CAVOLS)),
// LABEL=(%CAFSEQ,SL),
// DISP=(OLD,KEEP),DCB=BUFNO=10
%ENDDEL
%DELETE (%CADSN NE ’’)
//DFSUCUM DD DUMMY
%ENDDEL
%SELECT RLDS((%DBNAME,%DBDDN),FROM(%DSLLGTM))
%DELETE (%LOGVOLS EQ ’’)
//DFSULOG DD DSN=%LOGDSN,UNIT=%LOGUNIT,
// VOL=(PRIVATE,,%LOGVSEQ,,SER=(%LOGVOLS)),
// LABEL=(%LOGFSEQ,SL),
// DCB=RECFM=VB,
// DISP=OLD
%ENDDEL
%DELETE (%LOGVOLS NE ’’)
//DFSULOG DD DSN=%LOGDSN,DISP=OLD
%ENDDEL
%ENDSEL
%DELETE (%LOGSEL EQ ’YES’)
//DFSULOG DD DUMMY
%ENDDEL
%DELETE (%TRACK EQ ’NO’)
//DFSTRCV DD DSN=??????,
// DISP=OLD
%ENDDEL
//DFSVSAMP DD *
1024,4
4096,4
//SYSIN DD *
%RCSYSIN
/*
%DELETE (%ICCAT EQ 'YES')
// UNIT=%ICUNIT,
// VOL=(PRIVATE,,,,SER=(%ICVOLS)),
// LABEL=(%ICFSEQ,SL),
%ENDDEL
%DELETE (%ICDSN EQ '' | %SMS EQ '1')
// DISP=(OLD,KEEP),DCB=BUFNO=10
%ENDDEL
%DELETE (%ICDSN EQ '' | %SMS EQ '0')
// DISP=(OLD,KEEP)
%ENDDEL
%DELETE (%ICDSN NE '')

Figure 26. IBM-Supplied Skeletal JCL for the Database Recovery Utility (Part 2 of 3)

360 DBRC Guide & Reference

IBM-Supplied Skeletal JCL

//DFSUDUMP DD DUMMY
%ENDDEL
//DFSVDUMP DD DUMMY
%DELETE (%CADSN EQ '')
//DFSUCUM DD DSN=%CADSN,UNIT=%CAUNIT,
// VOL=(PRIVATE,,,,SER=(%CAVOLS)),
// LABEL=(%CAFSEQ,SL),
// DISP=(OLD,KEEP),DCB=BUFNO=10
%ENDDEL
%DELETE (%CADSN NE '')
//DFSUCUM DD DUMMY
%ENDDEL
%SELECT RLDS((%DBNAME,%DBDDN),FROM(%DSLLGTM))
%DELETE (%LOGVOLS EQ '')
//DFSULOG DD DSN=%LOGDSN,UNIT=%LOGUNIT,
// VOL=(PRIVATE,,%LOGVSEQ,,SER=(%LOGVOLS)),
// LABEL=(%LOGFSEQ,SL),
// DCB=RECFM=VB,
// DISP=OLD
%ENDDEL
%DELETE (%LOGVOLS NE '')
//DFSULOG DD DSN=%LOGDSN,DISP=OLD
%ENDDEL
%ENDSEL
%DELETE (%LOGSEL EQ 'YES')
//DFSULOG DD DUMMY
%ENDDEL
%DELETE (%TRACK EQ 'NO')
//DFSTRCV DD DSN=??????,
// DISP=OLD
%ENDDEL
//DFSVSAMP DD *
1024,4
4096,4
//SYSIN DD *
%RCSYSIN
/*

Figure 26. IBM-Supplied Skeletal JCL for the Database Recovery Utility (Part 3 of 3)

EXEC Statement
The %STPNO keyword is replaced with the current step number; then the current
step number is increased by 1. For HALDB, the HALDB master name,
%MDBNAME, of the DBDs being recovered is used in the EXEC statement. For all
others, the database name, %DBNAME, is used.

Appendix B. Understanding Skeletal JCL 361

IBM-Supplied Skeletal JCL
v If RECONs are allocated with JCL, the %RCNDSN keywords are set to the
name of the corresponding RECON in the GENJCL command.
v If a RECON is not used when the GENJCL command is executed (for example,
no spare RECON exists), the keyword is set to null, and the DD statement is
deleted.
IMS DD Statement
DBRC makes no changes to this statement.
%DBDDN DD Statement
The %DBDDN keyword is replaced by the ddname of the DBDS that is being
recovered. The %DBDSN keyword is replaced by the data set name of the DBDS.
Delete groups control the remainder of the %DBDDN DD statement. The access
method of the DBDS controls the content of the delete groups. If the access
method is VSAM, DISP=OLD is generated. Otherwise, the UNIT, VOL, SPACE, DISP,
and DCB parameters are generated.
DFSUDUMP DD Statement
This DD statement identifies the image copy data set, if any, that is to be used
for recovery. Delete groups, which are controlled by the %ICDSN keyword, are
used to generate this DD statement.
If the USEIC parameter was specified or if it was the default, on the
GENJCL.RECOV command, the %ICDSN keyword is set to its data set name. Thus,
the first delete group for DFSUDUMP is used, and the second delete group is
deleted. Other keywords within the first delete group are unchanged.
If the USEDBDS or USEAREA keyword was specified on the GENJCL.RECOV
command, the DFSUDUMP DD statement is generated as DUMMY.
DFSVDUMP DD Statement
The DFSVDUMP DD statement is always generated as DUMMY.
DFSUCUM DD Statement
This DD statement identifies the change accumulation data set, if any, to be
used as input to recovery. Delete groups, which are controlled by the %CADSN
keyword, are used to generate the DFSUCUM DD statement. If the DBDS belongs
to a CA group, the %CADSN keyword is set to the data set name of the
most-recent change accumulation data set. If the DBDS does not belong to a
CA group or if no usable change accumulation data set exists, the %CADSN
keyword is set to null.
v If the %CADSN keyword is null, the DFSUCUM DD statement is generated as
DUMMY.
v If the %CADSN keyword is not null, the DFSUCUM DD statement identifies the
change accumulation data set.

Other keywords relating to the change accumulation data set are replaced as
follows:
%CAVOLS Volume serial number list
%CAUNIT Unit type
%CAFSEQ File sequence number
DFSULOG DD Statement
This DD statement identifies the log data sets that are to be used as input to
the Database Recovery utility.
A select group selects the required log data sets. The %DBNAME and %DBDDN
keywords identify the DBDS for which log data sets are to be selected. All log

362 DBRC Guide & Reference

IBM-Supplied Skeletal JCL
volumes that contain change records for the DBDS, that are not included in the
change accumulation data sets, are selected. Other keywords relating to the log
data sets are replaced as follows:
%LOGDSN Log data set name
%LOGUNIT Unit type
%LOGVSEQ Volume sequence number
%LOGVOLS Volume serial numbers
%LOGFSEQ File sequence number

If any log data sets are selected, the value of the %LOGSEL keyword is YES, and
the following delete group is deleted. Otherwise, the %LOGSEL keyword is NO, and
a DD DUMMY statement is generated.
DFSTRCV DD Statement
The DFSTRCV DD statement identifies the DBDS for which one or more tracks is
being recovered. If the TRACK parameter was not specified on the GENJCL
command, this statement does not appear in the generated JCL.
You must modify the DFSTRCV DD statement to include in it the appropriate data
set name and unit information. You can modify it in either the skeletal JCL or
generated JCL.
DFSVSAMP DD Statement
The DFSVSAMP DD statement identifies information required by the DL/I buffer
handler. DBRC makes no changes to these statements.
SYSIN DD Statement
This DD statement contains database recovery statements that control the
processing.
%RCSYSIN Statement
DBRC replaces the %RCSYSIN keyword.
%RCVFULL
The %RCVFULL keyword indicates what type of recovery is being generated. It is
set to NO when the RCVTIME parameter (timestamp recovery) is specified on the
GENJCL.RECOV command. It is set to YES to indicate full recoveries.
This keyword is useful if, for example, you want to turn ON the IC-NEEDED flag
in the DBDS record following a time stamp recovery. You could add the
following JCL to the end of your RECOVJCL skeletal JCL member to
accomplish this.
%DELETE (%RCVFULL EQ 'YES')
//RCV%STPNO EXEC PGM=DSPURX00
//STEPLIB DD DSN=IMS.RESLIB,DISP=SHR
%ENDDEL
%DELETE (%RCVFULL EQ 'YES' | %RCNDSN1 EQ '')
//RECON1 DD DSN=%RCNDSN1,DISP=SHR
%ENDDEL
%DELETE (%RCVFULL EQ 'YES' | %RCNDSN2 EQ '')
//RECON2 DD DSN=%RCNDSN2,DISP=SHR
%ENDDEL
%DELETE (%RCVFULL EQ 'YES' | %RCNDSN3 EQ '')
//RECON3 DD DSN=%RCNDSN3,DISP=SHR
%ENDDEL
%DELETE (%RCVFULL EQ 'YES')
//SYSIN DD *

Appendix B. Understanding Skeletal JCL 363

IBM-Supplied Skeletal JCL
CHANGE.DBDS DBD(%DBNAME) DDN(%DBDDN) ICON
/*
%ENDDEL

Sample JCL for HALDB INDEX/ILDS Rebuild Utility (DSPUPJCL)

DFSPREC0 is used to rebuild the ILDS and/or prime index datasets of a HALDB
partition.

The DB Recovery utility and the image copy utilities cannot be used on ILDS and
prime index datasets. The GENJCL commands RECOV, RECEIVE, IC, and OIC fail
when attempted specifically for one of them. GENJCL commands on groups, either
explicit (using the GROUP keyword) or implicit (DBD with no DDN keyword), do not
generate any JCL for ILDS or prime index datasets. They are skipped over.
GENJCL.USER can specify ILDS and prime index datasets. They are not skipped
over for this command.

After the timestamp recovery of a HALDB partition (i.e., the data DBDSs of the
HALDB partition), the applicable ILDS and/or prime index datasets must be rebuilt.
There is no specific GENJCL support for these datasets, but GENJCL.USER can be
used. The IBM-supplied skeletal JCL execution member is named DSPUPJCL.
Here is a suggestion for implementation:
GENJCL.USER MEMBER (DSPUPJCL) -
USERKEYS ((%MDBNAME, 'DBHDOJ01'),(%DBDNAME,'PART1'), -
(%RCVTYP, 'ILE')

A description of the statements in DSPUPJCL follows Figure 27 on page 365.

364 DBRC Guide & Reference

IBM-Supplied Skeletal JCL
//UPREC%STPNO EXEC PGM=DFSRRC00,REGION=1300K,
// PARM='ULU,DFSPREC0,%MDBNAME,,,,,,,,,,,,,,,,,,,Y,N'
//*
//***************************************************************************************
//**
//* Licensed Materials - Property of IBM*
//**
//* "Restricted Materials of IBM"*
//**
//* 5655-158 (C) Copyright IBM Corp. 1974,1999
//**
//***************************************************************************************
//*
//* THIS JCL ORIGINATES FROM THE USER'S 'JCLPDS' LIBRARY.
//* KEYWORDS ARE REPLACED BY THE GENJCL FUNCTION.
//*
//* User JCL for rebuilding the Index and/or ILDS data
//* sets for a Partition of a HALDB.
//*
//SYSPRINT DD SYSOUT=A
%DELETE (%RCNDSN1 EQ '')
//RECON1 DD DSN=%RCNDSN1,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN2 EQ '')
//RECON2 DD DSN=%RCNDSN2,DISP=SHR
%ENDDEL
%DELETE (%RCNDSN3 EQ '')
//RECON3 DD DSN=%RCNDSN3,DISP=SHR
%ENDDEL
//IMS DD DSN=IMS.DBDLIB,DISP=SHR
//DFSVSAMP DD DSN=IMS.VSAM.PARM(OPTIONS),DISP=SHR
//SYSIN DD *
PARTITION=%DBNAME,RECOVTYP=%RCVTYP
/*

Figure 27. IBM-Supplied Skeletal JCL for the HALDB Index/ILDS Rebuild Utility

EXEC Statement
The %STPNO keyword is replaced with the current step number; then the current
step number is increased by 1. The %MDBNAME keyword is replaced with the
HALDB master name of the DBDS that is being recovered.

The DD Statements:
SYSPRINT DD Statement
DBRC makes no changes to this statement.
RECONn DD Statements
The RECON DD statements identify the RECONs.
Each of these statements is within a delete group that is controlled by a
%RCNDSN keyword. The %RCNDSN keyword values are set from the RECON names
that are used when the GENJCL command is executed.
v If RECONs are allocated dynamically, the %RCNDSN keywords are set to null,
and the RECONn DD statements are deleted.
v If RECONs are allocated with JCL, the %RCNDSN keywords are set to the
name of the corresponding RECON in the GENJCL command.
v If a RECON is not used when the GENJCL command is executed (for example,
no spare RECON exists), the keyword is set to null, and the DD statement is
deleted.

Appendix B. Understanding Skeletal JCL 365

IBM-Supplied Skeletal JCL
IMS DD Statement
DBRC makes no changes to this statement.
DFSVSAMP DD Statement
The DFSVSAMP DD statement identifies information required by the DL/I buffer
handler. DBRC makes no changes to these statements.
SYSIN DD Statement
This DD statement contains database recovery statements that control the
processing.
PARTITION=%DBNAME
This statement indicates the HALDB partition name of the ILDS or prime index
data sets being rebuilt. For a description of the %DBNAME keyword values, see
the IMS Version 7 Utilities Reference: Database and Transaction Manager.
RECOVTYP=%RCVTYP
This statement indicates which type of data sets (ILDS or prime index) are
being rebuilt. For a description of the %RCVTYP keyword values, see the IMS
Version 7 Utilities Reference: Database and Transaction Manager.

366 DBRC Guide & Reference

Appendix C. Sample Listings of RECONs
The following listings show the format and content of various records of RECONs
as they were listed by LIST.RECON commands.

In This Appendix:
v “Sample Listing of a RECON at the Active Site” on page 373
v “Sample Listing of a RECON at the Tracking Site” on page 401
v “Fields Present in a Listing of a RECON by Record Type” on page 416

Figure 29 on page 374 begins a listing of a RECON from an active site in an RSR
environment. Figure 38 on page 401 is a listing of a RECON from a tracking site in
an RSR environment.

The LIST command causes the RECON to be read.

The sample listings illustrate:

v These records: PRILOG, PRISLD, PRIOLD, LOGALL, GSG, SSYS, and
BACKOUT
v DBDS group records including DBDSs, CAGRPs and DEDB areas
v DB records showing various share levels and authorization states
v DBDS records, including area data sets that support DEDB areas
v Information corresponding to the database activity regarding:
– image copy data set information
– change accumulation information
– reorganization information
– recovery information
– and depending upon database activity:
- ALLOC records
- IMAGE records
- CA records
- REORG records
- nd RECOV records

To find the DSECTS defining the formats of the RECON records in DBRC in
ADFSMAC and SDFSMAC, run the generate job with SDFSMAC=ALL. The member
names are:
DSPALLRC ALLOC record
DSPBKORC BACKOUT record
DSPCAGRC CAGRP record
DSPCHGRC CA record
DSPDBHRC DB record
DSPDGRC DBDSGRP record
DSPGSGRC Global Service Group record
DSPDSHRC DBDS record
DSPIMGRC IC record

Sample RECON Listing Active Site
DSPLGARC LOGALL record
DSPLOGRC PRILOG / SECLOG record
DSPOLDRC PRIOLD / SECOLD record
DSPTHTRC THT record
DSPRCR1 HEADEREXT record
DSPRCNRC HEADER record
DSPRCVRC RECOV record
DSPRRGRC REORG record
DSPSLDRC PRISLD / SECSLD / PRITSLDS / SECTSLDS record
DSPSSRC SUBSYS record

Sample Listing of LIST.HISTORY Output

You use the LIST.HISTORY command to produce a history of activity for DBDSs or
DEDB areas. You can produce a RECON listing using LIST.HISTORY from either an
active or a remote site. Figure 28 on page 369 is an example of LIST.HISTORY
output that includes a time line.

368 DBRC Guide & Reference

LIST.HISTORY Sample
IMS/ESA VERSION 7 RELEASE 1 DATA BASE RECOVERY CONTROL PAGE 0001
LIST.HISTORY DBD(DEDBDD01) AREA(DD01AR0)
99.365 16:22:58.7 LISTING OF RECON PAGE 0002
-------------------------------------------------------------------------------
DB
DBD=DEDBDD01 DMB#=2 TYPE=FP
SHARE LEVEL=3
FLAGS: COUNTERS:
RECOVERY NEEDED COUNT =0
IMAGE COPY NEEDED COUNT =0
PROHIBIT AUTHORIZATION=OFF AUTHORIZED AREAS =0
RECOVERABLE =YES EEQE COUNT =0
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
DBDS
DBD=DEDBDD01 AREA=DD01AR0 TYPE=FP
SHARE LEVEL=3 DSID=001 DBORG=DEDB DSORG=VSAM
GSGNAME=**NULL** USID=0000000004
AUTHORIZED USID=0000000004 RECEIVE USID=0000000004 HARD USID=0000000004
RECEIVE NEEDED USID=0000000000
CAGRP=CAGRP1 GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000003
NOREUSE RECOVPD=0 NOVSO NOPREOPEN NOPRELOAD
CFSTR1=**NULL** CFSTR2=**NULL** NOLKASID
DEFLTJCL=**NULL** ICJCL=ICJCL RECVJCL=ICRCVJCL RECOVJCL=RECOVJCL
FLAGS: COUNTERS:
PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =0
HELD AUTHORIZATION STATE=0
IC NEEDED =OFF ADS AVAIL # =1
RECOV NEEDED =OFF REGISTERED ADS # =1
EEQE COUNT =0
RECEIVE NEEDED =OFF
OFR REQUIRED =NO
TRACKING SUSPENDED =NO
HSSP CIC IN PROGRESS =NO

ADS LIST:
CREATE
-ADS DDN--ADS DSN- -STAT- -RUNNING-
DD01AR0 DD01AR0 AVAIL NO
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
IMAGE
RUN = 99.365 15:49:12.0 * RECORD COUNT =84
STOP = 00.000 00:00:00.0 BATCH USID=0000000002

IC1
DSN=IMSVS.DEDBDD01.DD01AR0.IC.IC154909 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

ALLOC
ALLOC =99.365 15:50:15.3 * ALLOC LRID =0000000000000000
DSSN=0000000002 USID=0000000003 START = 99.365 15:41:20.4
DEALLOC =99.365 16:14:59.9 DEALLOC LRID =0000000000000000

Figure 28. Sample LIST.HISTORY Output (Part 1 of 5)

Appendix C. Sample Listings of RECONs 369

LIST.HISTORY Sample
99.365 16:22:58.7 LISTING OF RECON PAGE 0003

ALLOC
ALLOC =99.365 15:50:15.8 * ALLOC LRID =0000000000000000
DSSN=0000000002 USID=0000000003 START = 99.365 15:44:10.4
DEALLOC =99.365 16:15:00.4 DEALLOC LRID =0000000000000000

CA
DSN=IMSVS.CAGRP1.CA.CA001301 FILE SEQ=1
CAGRP=CAGRP1 STOP = 99.365 16:12:44.9 *
UNIT=SYSDA VOLS DEF=1 VOLS USED=1
VOLSER=222222
RUN = 99.365 16:13:34.7 SUBSET
DBD=DEDBDD01 DDN=DD01AR0 PURGETIME = 99.365 15:49:12.0
CHANGES ACCUMULATED=YES COMPLETE CA=NO INDOUBT EEQES=NO
LSN = 000000000000 DSSN = 0000000002
LRID = 0000000000001596 USID = 0000000000

CA
DSN=IMSVS.CAGRP1.CA.CA001501 FILE SEQ=1
CAGRP=CAGRP1 STOP = 99.365 16:15:02.0 *
UNIT=SYSDA VOLS DEF=1 VOLS USED=1
VOLSER=222222
RUN = 99.365 16:15:29.1
DBD=DEDBDD01 DDN=DD01AR0 PURGETIME = 99.365 15:49:12.0
CHANGES ACCUMULATED=YES COMPLETE CA=YES INDOUBT EEQES=NO
LSN = B3611B99C9C4 DSSN = 0000000002
LRID = 000000000000162B USID = 0000000003

RECOV
RUN = 99.365 16:16:31.6 * RUN USID = 0000000003

ALLOC
ALLOC =99.365 16:17:29.9 * ALLOC LRID =0000000000000000
DSSN=0000000003 USID=0000000004 START = 99.365 15:41:20.4

ALLOC
ALLOC =99.365 16:18:25.4 * ALLOC LRID =0000000000000000
DSSN=0000000003 USID=0000000004 START = 99.365 15:44:10.4
DSP0181I NO REORG RECORD FOUND

Figure 28. Sample LIST.HISTORY Output (Part 2 of 5)

370 DBRC Guide & Reference

LIST.HISTORY Sample
99.365 16:22:58.7 LISTING OF RECON PAGE 0004
-------------------------------------------------------------------------------
PRILOG
START = 99.365 15:41:20.4 * SSID=SYS3 VERSION=7.1
STOP = 99.365 16:22:02.3 #DSN=3
GSGNAME=**NULL**
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 0
EARLIEST CHECKPOINT = 99.365 15:41:22.6

DSN=IMSVS.RLDSP.SYS3.D99365.T1541204.V00 UNIT=SYSDA
START = 99.365 15:41:20.4 FIRST DS LSN= 0000000000000001
STOP = 99.365 16:12:44.9 LAST DS LSN= 000000000000178A
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 99.365 16:12:44.9

CKPTCT=1 CHKPT ID = 99.365 15:41:22.6

DSN=IMSVS.RLDSP.SYS3.D99365.T1612449.V00 UNIT=SYSDA
START = 99.365 16:12:44.9 FIRST DS LSN= 000000000000178B
STOP = 99.365 16:15:00.8 LAST DS LSN= 0000000000001826
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 99.365 16:15:00.8

CKPTCT=0 CHKPT ID = 99.365 15:41:22.6

DSN=IMSVS.RLDSP.SYS3.D99365.T1615008.V00 UNIT=SYSDA
START = 99.365 16:15:00.8 FIRST DS LSN= 0000000000001827
STOP = 99.365 16:22:02.3 LAST DS LSN= 0000000000002749
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 99.365 16:22:02.3

CKPTCT=2 CHKPT ID = 99.365 16:22:01.7

Figure 28. Sample LIST.HISTORY Output (Part 3 of 5)

Appendix C. Sample Listings of RECONs 371

LIST.HISTORY Sample
-------------------------------------------------------------------------------
99.365 16:22:58.7 LISTING OF RECON PAGE 0005
-------------------------------------------------------------------------------
PRILOG
START = 99.365 15:44:10.4 * SSID=IMS2 VERSION=7.1
STOP = 99.365 16:22:11.2 #DSN=4
GSGNAME=**NULL**
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 0
EARLIEST CHECKPOINT = 99.365 15:44:13.4

DSN=IMSVS.RLDSP.IMS2.D99365.T1544104.V00 UNIT=SYSDA
START = 99.365 15:44:10.4 FIRST DS LSN= 0000000000000001
STOP = 99.365 16:13:13.5 LAST DS LSN= 0000000000001612
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 99.365 16:13:13.5

CKPTCT=1 CHKPT ID = 99.365 15:44:13.4

DSN=IMSVS.RLDSP.IMS2.D99365.T1613135.V00 UNIT=SYSDA
START = 99.365 16:13:13.5 FIRST DS LSN= 0000000000001613
STOP = 99.365 16:15:00.6 LAST DS LSN= 0000000000001646
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 99.365 16:15:00.6

CKPTCT=0 CHKPT ID = 99.365 15:44:13.4

DSN=IMSVS.RLDSP.IMS2.D99365.T1615006.V00 UNIT=SYSDA
START = 99.365 16:15:00.6 FIRST DS LSN= 0000000000001647
STOP = 99.365 16:15:02.0 LAST DS LSN= 0000000000001661
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 99.365 16:15:02.0

CKPTCT=0 CHKPT ID = 99.365 15:44:13.4

DSN=IMSVS.RLDSP.IMS2.D99365.T1615020.V01 UNIT=SYSDA
START = 99.365 16:15:02.0 FIRST DS LSN= 0000000000001662
STOP = 99.365 16:22:11.2 LAST DS LSN= 000000000000252B
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 99.365 16:22:11.2

CKPTCT=2 CHKPT ID = 99.365 16:22:10.4

Figure 28. Sample LIST.HISTORY Output (Part 4 of 5)

372 DBRC Guide & Reference

LIST.HISTORY Sample
-------------------------------------------------------------------------------
99.365 16:22:58.7 LISTING OF RECON PAGE 0006
+------------------------------------------------------------------------------+
|Timeline for AREA: DEDBDD01 DD01AR0 Ref |
| USID=00000000 AUTHORIZED=00000000 Page|
| RECEIVE=00000000 HARD=00000000 0002|
+-Time------------+Events----+---+--+------------------------------------------+
| |IC | | | |
| |REORG | |US|Subsystem |
| |RECOV |CA |ID|Logs and Allocs |
+-----------------+----------+---+--+------------------------------------------+
99.365 15:41:20.4 SYS3 0004
99.365 15:44:10.4 | IMS2 0005
99.365 15:49:12.0 B < 2 | | 0002
99.365 15:50:15.3 | 3 A | 0002
99.365 15:50:15.8 | | | A 0002
99.365 16:12:44.9 S | s |
99.365 16:13:13.5 | | | s
99.365 16:13:34.7 Ryi | | | 0003
99.365 16:14:59.9 | | D |
99.365 16:15:00.4 | 3 | D
99.365 16:15:00.6 | s
99.365 16:15:00.8 s |
99.365 16:15:02.0 S | s
99.365 16:15:29.1 Ryc | | 0003
99.365 16:16:31.6 R | | 0003
99.365 16:17:29.9 4 A | 0003
99.365 16:18:25.4 | | A 0003
99.365 16:22:02.3 | C |
99.365 16:22:11.2 4 C
+-----------------+----------+---+--+------------------------------------------+
In the timeline, only the last digit of USID is shown.
IC: B = Batch, U = UIC, O = OIC, C = CIC, s = Stop
RECOV: R = Run time, * = RECOVTO time (if any)
CA: R = Run time, S = Stop time, < = Purge time
y/n = CHANGES ACCUMULATED, i/c = (IN)/COMPLETE
Logs: SSID = Open time, C = Log Close,
v = Vol close, s = DS close
Allocs: D = Dealloc time, A = Alloc time
+------------------------------------------------------------------------------+
DSP0180I NUMBER OF RECORDS LISTED IS 12
DSP0203I COMMAND COMPLETED WITH CONDITION CODE 00
DSP0220I COMMAND COMPLETION TIME 99.365 16:22:59.5

Figure 28. Sample LIST.HISTORY Output (Part 5 of 5)

Related Reading: See “LIST.HISTORY” on page 252 for more information about
the LIST.HISTORY command.

Sample Listing of a RECON at the Active Site

Beginning with Figure 29 on page 374, the following figures comprise a listing of a
RECON from an active site in an RSR environment. “Fields Present in a Listing of a
RECON by Record Type” on page 416 describes the fields that can be present in a
listing of the RECON.

Appendix C. Sample Listings of RECONs 373

Sample RECON Listing Active Site
RECON Status Record
IMS/ESA VERSION 7 RELEASE 1 DATA BASE RECOVERY CONTROL
/* LIST IN LOCAL TIME */
LIST.RECON TIMEFMT(L,O,P,4)
1999.251 11:46:24.1 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
RECON
RECOVERY CONTROL DATA SET, IMS/ESA V7R1
DMB#=9 INIT TOKEN=99251F1858079F
NOFORCER LOG DSN CHECK=CHECK17 STARTNEW=NO
TAPE UNIT=3400 DASD UNIT=SYSDA TRACEOFF SSID=**NULL**
LIST DLOG=YES CA/IC/LOG DATA SETS CATALOGED=NO
LOG RETENTION PERIOD=00.000 00:15:00.0
SIZALERT DSNUM=15 VOLNUM=16 PERCENT= 95
LOGALERT DSNUM=3 VOLNUM=16

TIME STAMP INFORMATION:

TIMEZIN = %SYS -LABEL- -OFFSET-

PDT -07:00
PST -08:00

OUTPUT FORMAT: DEFAULT = LOCORG NONE PUNC YY

CURRENT = LOCAL OFFSET PUNC YYYY

-DDNAME- -STATUS- -DATA SET NAME-

RECON1 COPY1 IMSTESTL.IMS.RECON1
RECON2 COPY2 IMSTESTL.IMS.RECON2
RECON3 SPARE IMSTESTL.IMS.RECON3

Figure 29. Sample Listing of a RECON at the Active Site - RECON Status

374 DBRC Guide & Reference

Sample RECON Listing Active Site
Log Records
1999.251 11:46:24.1 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
PRILOG
START = 1999.251 11:16:52.6 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 1999.251 11:35:06.5 -08:00 #DSN=4
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 2
EARLIEST CHECKPOINT = 1999.251 11:18:46.7 -08:00

DSN= COMPRESSED DATA SET UNIT=

START = 1999.251 11:16:52.6 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:17:52.9 -08:00 LAST DS LSN= 00000000000002DE
FILE SEQ=0000 #VOLUMES=0000

DSN=IMSVS.RLDSP.SYS3.D99251.T1217529.V01 UNIT=SYSDA
START = 1999.251 11:17:52.9 -08:00 FIRST DS LSN= 00000000000002DF
STOP = 1999.251 11:18:30.3 -08:00 LAST DS LSN= 0000000000000493
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:18:30.3 -08:00

CKPTCT=1 CHKPT ID = 1999.251 11:17:53.1 -08:00
LOCK SEQUENCE#= 000000000000

DSN=IMSVS.RLDSP.SYS3.D99251.T1218303.V00 UNIT=SYSDA
START = 1999.251 11:18:30.3 -08:00 FIRST DS LSN= 0000000000000494
STOP = 1999.251 11:18:52.8 -08:00 LAST DS LSN= 0000000000000596
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:18:52.8 -08:00

CKPTCT=1 CHKPT ID = 1999.251 11:18:46.7 -08:00
LOCK SEQUENCE#= 000000000000

DSN=IMSVS.RLDSP.SYS3.D99251.T1218528.V01 UNIT=SYSDA
START = 1999.251 11:18:52.8 -08:00 FIRST DS LSN= 0000000000000597
STOP = 1999.251 11:35:06.5 -08:00 LAST DS LSN= 000000000000078B
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:35:06.5 -08:00

CKPTCT=2 CHKPT ID = 1999.251 11:35:05.6 -08:00
LOCK SEQUENCE#= 000000000000

LOGALL
START = 1999.251 11:16:52.6 -08:00 *
DBDS ALLOC=1 -DBD- -DDN- -ALLOC-
DBVHDJ05 CJVHDG1E 1

Figure 30. Sample Listing of a RECON at the Active Site - Log Records (Part 1 of 8)

Appendix C. Sample Listings of RECONs 375

Sample RECON Listing Active Site
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0336
-------------------------------------------------------------------------------
PRISLD
START = 1999.251 11:16:52.6 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 1999.251 11:35:06.5 -08:00 #DSN=4
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 2

DSN= COMPRESSED DATA SET UNIT=

START = 1999.251 11:16:52.6 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:17:52.9 -08:00 LAST DS LSN= 00000000000002DE
FILE SEQ=0000 #VOLUMES=0000

DSN=IMSVS.SLDSP.SYS3.D99251.T1217529.V01 UNIT=SYSDA
START = 1999.251 11:17:52.9 -08:00 FIRST DS LSN= 00000000000002DF
STOP = 1999.251 11:18:30.3 -08:00 LAST DS LSN= 0000000000000493
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:18:30.3 -08:00

CKPTCT=1 CHKPT ID = 1999.251 11:17:53.1 -08:00
LOCK SEQUENCE#= 000000000000

DSN=IMSVS.SLDSP.SYS3.D99251.T1218303.V00 UNIT=SYSDA
START = 1999.251 11:18:30.3 -08:00 FIRST DS LSN= 0000000000000494
STOP = 1999.251 11:18:52.8 -08:00 LAST DS LSN= 0000000000000596
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:18:52.8 -08:00

CKPTCT=1 CHKPT ID = 1999.251 11:18:46.7 -08:00
LOCK SEQUENCE#= 000000000000

DSN=IMSVS.SLDSP.SYS3.D99251.T1218528.V01 UNIT=SYSDA
START = 1999.251 11:18:52.8 -08:00 FIRST DS LSN= 0000000000000597
STOP = 1999.251 11:35:06.5 -08:00 LAST DS LSN= 000000000000078B
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:35:06.5 -08:00

CKPTCT=2 CHKPT ID = 1999.251 11:35:05.6 -08:00
LOCK SEQUENCE#= 000000000000

Figure 30. Sample Listing of a RECON at the Active Site - Log Records (Part 2 of 8)

376 DBRC Guide & Reference

Sample RECON Listing Active Site
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0337
-------------------------------------------------------------------------------
PRILOG
START = 1999.251 11:35:37.8 -08:00 * SSID=BATCH1 VERSION=7.1
STOP = 1999.251 11:35:40.2 -08:00 #DSN=1
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 3

DSN=BATCH1.UPDATEF.LOG UNIT=SYSDA
START = 1999.251 11:35:37.8 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:35:40.2 -08:00 LAST DS LSN= 000000000000009C
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:35:40.2 -08:00

CKPTCT=0 CHKPT ID = 0000.000 00:00:00.0 +00:00
LOCK SEQUENCE#= 000000000000

LOGALL
START = 1999.251 11:35:37.8 -08:00 *
DBDS ALLOC=3 -DBD- -DDN- -ALLOC-
DHVNTZ02 HIDAM 1
DXVNTZ02 XDLBT04I 1
DIVNTZ02 DBHVSAM1 1
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0338
-------------------------------------------------------------------------------
SECLOG
START = 1999.251 11:35:37.8 -08:00 * SSID=BATCH1 VERSION=7.1
STOP = 1999.251 11:35:40.2 -08:00 #DSN=1
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 3

DSN=IMSTESTL.IMS01.OLDSP1 UNIT=SYSDA
START = 1999.251 11:35:37.8 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:35:40.2 -08:00 LAST DS LSN= 000000000000009C
FILE SEQ=0001 #VOLUMES=0001

VOLSER=USER03 STOPTIME = 1999.251 11:35:40.2 -08:00

CKPTCT=0 CHKPT ID = 0000.000 00:00:00.0 +00:00
LOCK SEQUENCE#= 000000000000

Figure 30. Sample Listing of a RECON at the Active Site - Log Records (Part 3 of 8)

Appendix C. Sample Listings of RECONs 377

Sample RECON Listing Active Site
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0339
-------------------------------------------------------------------------------
PRILOG
START = 1999.251 11:35:59.2 -08:00 * SSID=BATFPC VERSION=7.1
STOP = 1999.251 11:36:08.0 -08:00 #DSN=1
GSGNAME=**NULL**
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 0

DSN=IMSTESTM.BAT01.DBLOG1 UNIT=SYSDA
START = 1999.251 11:35:59.2 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:36:08.0 -08:00 LAST DS LSN= 00000000000000E2
FILE SEQ=0001 #VOLUMES=0001

VOLSER=222222 STOPTIME = 1999.251 11:36:08.0 -08:00

CKPTCT=0 CHKPT ID = 0000.000 00:00:00.0 +00:00
LOCK SEQUENCE#= 000000000000

LOGALL
START = 1999.251 11:35:59.2 -08:00 *
DBDS ALLOC=1 -DBD- -DDN- -ALLOC-
DBOVLFPC VLOSAM01 1
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0340
-------------------------------------------------------------------------------
PRILOG
START = 1999.251 11:36:24.5 -08:00 * SSID=BATFPC VERSION=7.1
STOP = 1999.251 11:36:25.8 -08:00 #DSN=1
GSGNAME=**NULL** BBO
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 0

DSN=IMSTESTM.BBOFPC.BB1 UNIT=SYSDA
START = 1999.251 11:36:24.5 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:36:25.8 -08:00 LAST DS LSN= 000000000000002E
FILE SEQ=0001 #VOLUMES=0001

VOLSER=333333 STOPTIME = 1999.251 11:36:25.8 -08:00

CKPTCT=0 CHKPT ID = 0000.000 00:00:00.0 +00:00
LOCK SEQUENCE#= 000000000000

LOGALL
START = 1999.251 11:36:24.5 -08:00 *
DBDS ALLOC=1 -DBD- -DDN- -ALLOC-
DBOVLFPC VLOSAM01 1

Figure 30. Sample Listing of a RECON at the Active Site - Log Records (Part 4 of 8)

378 DBRC Guide & Reference

Sample RECON Listing Active Site
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0341
-------------------------------------------------------------------------------
PRILOG
START = 1999.251 11:37:33.0 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 1999.251 11:40:49.9 -08:00 #DSN=1
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 4
EARLIEST CHECKPOINT = 1999.251 11:18:46.7 -08:00

DSN=IMSVS.RLDSP.SYS3.D99251.T1237330.V02 UNIT=SYSDA
START = 1999.251 11:37:33.0 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:40:49.9 -08:00 LAST DS LSN= 0000000000000220
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:40:49.9 -08:00

CKPTCT=1 CHKPT ID = 1999.251 11:37:41.0 -08:00
LOCK SEQUENCE#= 000000000000

LOGALL
START = 1999.251 11:37:33.0 -08:00 *
DBDS ALLOC=7 -DBD- -DDN- -ALLOC-
DEDBDD01 DD01AR0 1
DHVNTZ02 HIDAM 1
DXVNTZ02 XDLBT04I 1
DIVNTZ02 DBHVSAM1 1
DBOHIDK5 CKOHIG1O 1
DXVHIDK5 CKVHIIXK 1
DBVHDJ05 CJVHDG1E 1
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0342
-------------------------------------------------------------------------------
PRISLD
START = 1999.251 11:37:33.0 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 1999.251 11:40:49.9 -08:00 #DSN=1
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 4

DSN=IMSVS.SLDSP.SYS3.D99251.T1237330.V02 UNIT=SYSDA
START = 1999.251 11:37:33.0 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:40:49.9 -08:00 LAST DS LSN= 0000000000000220
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:40:49.9 -08:00

CKPTCT=1 CHKPT ID = 1999.251 11:37:41.0 -08:00
LOCK SEQUENCE#= 000000000000

Figure 30. Sample Listing of a RECON at the Active Site - Log Records (Part 5 of 8)

Appendix C. Sample Listings of RECONs 379

Sample RECON Listing Active Site
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0343
-------------------------------------------------------------------------------
PRILOG
START = 1999.251 11:40:50.0 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 0000.000 00:00:00.0 +00:00 #DSN=1
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000221 PRILOG TOKEN= 5
EARLIEST CHECKPOINT = 1999.251 11:40:54.1 -08:00

DSN=IMSVS.RLDSP.SYS3.D99251.T1140500.V01 UNIT=SYSDA
START = 1999.251 11:40:50.0 -08:00 FIRST DS LSN= 0000000000000221
STOP = 1999.251 11:43:11.5 -08:00 LAST DS LSN= 0000000000000399
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:43:11.5 -08:00

CKPTCT=2 CHKPT ID = 1999.251 11:40:54.1 -08:00
LOCK SEQUENCE#= 000000000000

LOGALL
START = 1999.251 11:40:50.0 -08:00 *
DBDS ALLOC=1 -DBD- -DDN- -ALLOC-
DEDBDD01 DD01AR0 1
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0344
-------------------------------------------------------------------------------
PRISLD
START = 1999.251 11:40:50.0 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 0000.000 00:00:00.0 +00:00 #DSN=1
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000221 PRILOG TOKEN= 5

DSN=IMSVS.SLDSP.SYS3.D99251.T1140500.V01 UNIT=SYSDA
START = 1999.251 11:40:50.0 -08:00 FIRST DS LSN= 0000000000000221
STOP = 1999.251 11:43:11.5 -08:00 LAST DS LSN= 0000000000000399
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:43:11.5 -08:00

CKPTCT=2 CHKPT ID = 1999.251 11:40:54.1 -08:00
LOCK SEQUENCE#= 000000000000

Figure 30. Sample Listing of a RECON at the Active Site - Log Records (Part 6 of 8)

380 DBRC Guide & Reference

Sample RECON Listing Active Site
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0345
-------------------------------------------------------------------------------
PRILOG
START = 1999.251 11:44:49.0 -08:00 * SSID=IMS2 VERSION=7.1
STOP = 1999.251 11:45:29.9 -08:00 #DSN=1
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 6
EARLIEST CHECKPOINT = 1999.251 11:44:57.8 -08:00

DSN=IMSVS.RLDSP.IMS2.D99251.T1144490.V00 UNIT=SYSDA
START = 1999.251 11:44:49.0 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:45:29.9 -08:00 LAST DS LSN= 00000000000001BB
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:45:29.9 -08:00

CKPTCT=2 CHKPT ID = 1999.251 11:45:28.2 -08:00
LOCK SEQUENCE#= 000000000000

LOGALL
START = 1999.251 11:44:49.0 -08:00 *
DBDS ALLOC=0
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0346
-------------------------------------------------------------------------------
PRISLD
START = 1999.251 11:44:49.0 -08:00 * SSID=IMS2 VERSION=7.1
STOP = 1999.251 11:45:29.9 -08:00 #DSN=1
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 6

DSN=IMSVS.SLDSP.IMS2.D99251.T1144490.V00 UNIT=SYSDA
START = 1999.251 11:44:49.0 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:45:29.9 -08:00 LAST DS LSN= 00000000000001BB
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:45:29.9 -08:00

CKPTCT=2 CHKPT ID = 1999.251 11:45:28.2 -08:00
LOCK SEQUENCE#= 000000000000
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0347
-------------------------------------------------------------------------------
PRIOLD
SSID=IMS2 # DD ENTRIES=1
EARLIEST CHECKPOINT = 1999.251 11:44:57.8 -08:00

DDNAME=DFSOLP00 DSN=IMSTESTL.IMS02.OLDSP0
START = 1999.251 11:44:49.0 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:45:29.9 -08:00 LAST DS LSN= 00000000000001BB
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=1999.251 11:44:49.0 -08:00 ARCHIVE JOB NAME=JT114530
VERSION=7.1

Figure 30. Sample Listing of a RECON at the Active Site - Log Records (Part 7 of 8)

Appendix C. Sample Listings of RECONs 381

Sample RECON Listing Active Site
1999.251 11:46:24.1 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
PRIOLD
SSID=SYS3 # DD ENTRIES=4
EARLIEST CHECKPOINT = 1999.251 11:40:54.1 -08:00

DDNAME=DFSOLP03 DSN=IMSTESTL.IMS01.OLDSP3
START = 1999.251 11:18:52.8 -08:00 FIRST DS LSN= 0000000000000597
STOP = 1999.251 11:35:05.7 -08:00 LAST DS LSN= 0000000000000735
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=1999.251 11:16:52.6 -08:00 ARCHIVE JOB NAME=JT114050
VERSION=7.1

DDNAME=DFSOLP01 DSN=IMSTESTL.IMS01.OLDSP1
START = 1999.251 11:37:33.0 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:40:49.9 -08:00 LAST DS LSN= 0000000000000220
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=1999.251 11:37:33.0 -08:00 ARCHIVE JOB NAME=JT114050
VERSION=7.1

DDNAME=DFSOLP02 DSN=IMSTESTL.IMS01.OLDSP2
START = 1999.251 11:40:50.0 -08:00 FIRST DS LSN= 0000000000000221
STOP = 1999.251 11:43:11.5 -08:00 LAST DS LSN= 0000000000000399
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=1999.251 11:40:50.0 -08:00 ARCHIVE JOB NAME=JT114312
VERSION=7.1

DDNAME=DFSOLP00 DSN=IMSTESTL.IMS01.OLDSP0
START = 1999.251 11:43:11.5 -08:00 FIRST DS LSN= 000000000000039A
STOP = 0000.000 00:00:00.0 +00:00 LAST DS LSN= 0000000000000000
LOCK SEQUENCE# = 000000000000
STATUS=ACTIVE FEOV=NO AVAIL
PRILOG TIME=1999.251 11:40:50.0 -08:00
VERSION=7.1
DSP0260I NO INTERIM RLDS/SLDS RECORDS FOUND IN RECON
DSP0260I NO INT-ONLINE LOG RECORDS FOUND IN RECON

Figure 30. Sample Listing of a RECON at the Active Site - Log Records (Part 8 of 8)

GSG Record
1999.251 11:46:24.1 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
GSG
GSGNAME=IMSGSG1 #SGS=2 -SGNAME- -ROLE-
STLSITE1 ACTIVE LOCAL
STLSITE2 TRACKING
CURRENT PRILOG TOKEN = 6 TAKEOVER TOKEN = 0
MINIMUM PRILOG TOKEN = 1 DSN SEQ NUMBER = 0
START TIME OF CURRENT LOG = 1999.251 11:44:49.0 -08:00
HIGHEST ACTIVE SITE TIME = 0000.000 00:00:00.0 +00:00
TRACKING SUBSYSTEM ID = **NULL**
TAKEOVER IN PROGRESS

Figure 31. Sample Listing of a RECON at the Active Site - GSG Record

382 DBRC Guide & Reference

Sample RECON Listing Active Site
SSYS Record
1999.251 11:46:24.1 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
SSYS
SSID=SYS3 LOG START=1999.251 11:40:50.0 -08:00
SSTYPE=ONLINE ABNORMAL TERM=OFF RECOVERY STARTED=NO BACKUP=NO
TRACKED=NO TRACKER TERM=OFF SHARING COVERED DBS=NO
IRLMID=**NULL** IRLM STATUS=NORMAL GSGNAME=IMSGSG1

AUTHORIZED DATA BASES/AREAS=1 VERSION=7.1

ENCODED
-DBD- -AREA- -LEVEL- -ACCESS INTENT- -STATE-
DEDBDD01 DD01AR0 1 UPDATE 6

Figure 32. Sample Listing of a RECON at the Active Site - SSYS Record

BACKOUT Record
1999.251 11:46:24.1 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
BACKOUT
SSID=SYS3 #UORS=2

RECOVERY TOKEN=E2E8E2F3404040400000000300000002
TIME=1999.251 11:38:22.5 -08:00 PSB=PLVAPZ12
INFLT BMP COLDEND
ASSOCIATED DATA BASES=3

BACKED DYN BKOUT

-DBD- -OUT - -FAILURE-
DHVNTZ02 NO NO
DXVNTZ02 NO NO
DIVNTZ02 NO NO

RECOVERY TOKEN=E2E8E2F3404040400000000400000000
TIME=1999.251 11:38:22.8 -08:00 PSB=PSBEJK05
INFLT BMP COLDEND
ASSOCIATED DATA BASES=2

BACKED DYN BKOUT

-DBD- -OUT - -FAILURE-
DBOHIDK5 NO NO
DXVHIDK5 NO NO

Figure 33. Sample Listing of a RECON at the Active Site - BACKOUT Record

Appendix C. Sample Listings of RECONs 383

Sample RECON Listing Active Site
CAGRP and CA Records
1999.251 11:46:24.1 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
CAGRP
GRPNAME=CAGRP1 GRPMAX=3 CA AVAIL=0 CA USED=1
NOREUSE CAJCL=CAJCL DEFLTJCL=**NULL**
#MEMBERS=4 -DBD- -DDN-
DEDBJN21 DB21AR1
DEDBJN21 DB21AR3
DEDBJN21 DB21AR6
DEDBJN21 DB21AR7
-------------------------------------------------------------------------------

CA
DSN=IMSVS.CAGRP1.CA.CA194501 FILE SEQ=1
CAGRP=CAGRP1 STOP = 1999.251 11:10:59.7 -08:00 *
UNIT=SYSDA VOLS DEF=1 VOLS USED=1
VOLSER=222222
RUN = 1999.251 11:45:45.0 -08:00
DBD=DEDBJN21 DDN=DB21AR1 PURGETIME = 1999.251 11:08:45.9 -08:00
CHANGES ACCUMULATED=YES COMPLETE CA=YES INDOUBT EEQES=NO
LSN = 000000000000 DSSN = 0000000001
LRID = 0000000000000424 USID = 0000000002
DBD=DEDBJN21 DDN=DB21AR3 PURGETIME = 1999.251 11:08:47.9 -08:00
CHANGES ACCUMULATED=YES COMPLETE CA=YES INDOUBT EEQES=NO
LSN = 000000000000 DSSN = 0000000001
LRID = 000000000000043A USID = 0000000002
DBD=DEDBJN21 DDN=DB21AR6 PURGETIME = 1999.251 11:02:53.0 -08:00
CHANGES ACCUMULATED=NO COMPLETE CA=YES INDOUBT EEQES=NO
LSN = 000000000000 DSSN = 0000000000
LRID = 0000000000000000 USID = 0000000000
DBD=DEDBJN21 DDN=DB21AR7 PURGETIME = 1999.251 11:02:53.0 -08:00
CHANGES ACCUMULATED=NO COMPLETE CA=YES INDOUBT EEQES=NO
LSN = 000000000000 DSSN = 0000000000
LRID = 0000000000000000 USID = 0000000000

Figure 34. Sample Listing of a RECON at the Active Site - CAGRP and CA Records

384 DBRC Guide & Reference

Sample RECON Listing Active Site
DBGRP, DBDSGRP, and RECOVGRP Records
1999.251 11:46:24.1 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
DBGRP
GRPNAME=DBGRP1 #MEMBERS=6 -DBD/AREA-
DIVNTZ02
DHVNTZ02
DXVNTZ02
DB21AR0
DB21AR1
DB21AR2

DBDSGRP
GRPNAME=FJKGRP #MEMBERS=5 -DBD- -DDN/AREA-
DIVNTZ02 DBHVSAM1
DIVNTZ02 DBHVSAM2
DHVNTZ02 HIDAM
DHVNTZ02 HIDAM2
DXVNTZ02 XDLBT04I

RECOVGRP
GRPNAME=RCVGRP1 #MEMBERS=5 -DBD- -AREA-
DIVNTZ02
DHVNTZ02
DXVNTZ02
DEDBJN21 DB21AR0
DEDBJN21 DB21AR1

Figure 35. Sample Listing of a RECON at the Active Site - DBGRP, DBDSGRP, and
RECOVGRP Records

Appendix C. Sample Listings of RECONs 385

Sample RECON Listing Active Site
DB (IMS) and Related Records
1999.251 11:46:24.1 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
DB
DBD=DBVHDJ05 IRLMID=*NULL DMB#=2 TYPE=IMS
SHARE LEVEL=3 GSGNAME=**NULL** USID=0000000006
AUTHORIZED USID=0000000006 RECEIVE USID=0000000006 HARD USID=0000000006
RECEIVE NEEDED USID=0000000000
DBRCVGRP=**NULL**
FLAGS: COUNTERS:
BACKOUT NEEDED =OFF RECOVERY NEEDED COUNT =0
READ ONLY =OFF IMAGE COPY NEEDED COUNT =0
PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =0
RECOVERABLE =YES HELD AUTHORIZATION STATE=0
EEQE COUNT =0
TRACKING SUSPENDED =NO RECEIVE REQUIRED COUNT =0
OFR REQUIRED =NO

DBDS
DSN=DBVHDJ05.CJXXD01E TYPE=IMS
DBD=DBVHDJ05 DDN=CJVHDG1E DSID=001 DBORG=HDAM DSORG=VSAM
CAGRP=CAGRP2 GENMAX=2 IC AVAIL=0 IC USED=2 DSSN=00000005
NOREUSE RECOVPD=0
DEFLTJCL=**NULL** ICJCL=ICJCL OICJCL=OICJCL RECOVJCL=RECOVJCL
RECVJCL=ICRCVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0

-------------------------------------------------------------------------------

ALLOC
ALLOC =1999.251 11:18:26.4 -08:00 * ALLOC LRID =0000000000000000
DSSN=0000000004 USID=0000000005 START = 1999.251 11:16:52.6 -08:00
DEALLOC =1999.251 11:18:52.6 -08:00 DEALLOC LRID =0000000000000000

ALLOC
ALLOC =1999.251 11:39:00.8 -08:00 * ALLOC LRID =0000000000000000
DSSN=0000000005 USID=0000000006 START = 1999.251 11:37:33.0 -08:00

IMAGE
RUN = 1999.251 11:18:13.1 -08:00 * RECORD COUNT =33
STOP = 0000.000 00:00:00.0 +00:00 BATCH USID=0000000004

Figure 36. Sample Listing of a RECON at the Active Site - DB (IMS) and Related Records
(Part 1 of 2)

386 DBRC Guide & Reference

Sample RECON Listing Active Site
IC1
DSN=IMSVS.DBVHDJ05.CJVHDG1E.IC.IC121810 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

IMAGE
RUN = 1999.251 11:19:26.0 -08:00 * RECORD COUNT =33
STOP = 1999.251 11:19:26.6 -08:00 CONCUR USID=0000000005

IC1
DSN=IMSVS.DBVHDJ05.CJVHDG1E.IC.IC121920 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

Figure 36. Sample Listing of a RECON at the Active Site - DB (IMS) and Related Records
(Part 2 of 2)

Appendix C. Sample Listings of RECONs 387

Sample RECON Listing Active Site
DB (HALDB and PART) and Related Records
00.168 18:15:28.7 LISTING OF RECON PAGE 0002
-------------------------------------------------------------------------------
DB
DBD=DBHDOK01 DMB#=1 CHANGE#=6 TYPE=HALDB
SHARE LEVEL=0 GSGNAME=**NULL**
PSNAME=**NULL**
FLAGS: COUNTERS:
RECOVERABLE =YES PARTITIONS =4
-------------------------------------------------------------------------------
00.168 18:15:28.7 LISTING OF RECON PAGE 0003
-------------------------------------------------------------------------------
DB
DBD=PDHDOKA MASTER DB=DBHDOK01 CHANGE#=6 TYPE=PART
USID=0000000004 AUTHORIZED USID=0000000004 HARD USID=0000000004
RECEIVE USID=0000000004 RECEIVE NEEDED USID=0000000000
DBRCVGRP=**NULL**

RANDOMIZER:
NAME=DFSHDC20 ANCHOR=3 HIGH BLOCK#=3 BYTES=25
FREE SPACE:
FREE BLOCK FREQ FACTOR=0 FREE SPACE PERCENTAGE=0

PARTITION HIGH KEY/STRING (CHAR): (LENGTH=5 )

K0200
PARTITION HIGH KEY/STRING (HEX):
D2F0F2F0F0404040404040404040404040404040404040404040404040404040

OSAM BLOCK SIZE:

A = 2048
B = 2048
C = 4096
D = 4096

FLAGS: COUNTERS:
BACKOUT NEEDED =OFF RECOVERY NEEDED COUNT =0
READ ONLY =OFF IMAGE COPY NEEDED COUNT =0
PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =0
HELD AUTHORIZATION STATE=0
EEQE COUNT =0
TRACKING SUSPENDED =NO RECEIVE REQUIRED COUNT =0
OFR REQUIRED =NO
PARTITION INIT NEEDED =NO
-------------------------------------------------------------------------------
00.168 18:15:28.7 LISTING OF RECON PAGE 0004
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.A00001 TYPE=PART
DBD=PDHDOKA DDN=PDHDOKAA DSID=001 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=3 IC AVAIL=0 IC USED=1 DSSN=00000003
NOREUSE RECOVPD=3
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

388 DBRC Guide & Reference

Sample RECON Listing Active Site
ALLOC
ALLOC =00.168 09:30:08.3 * ALLOC LRID =0000000000000000
DSSN=0000000003 USID=0000000004 START = 00.168 09:26:08.2

IMAGE
RUN = 00.168 09:28:53.4 * RECORD COUNT =3
STOP = 00.000 00:00:00.0 BATCH USID=0000000003

IC1
DSN=IMSVS.PDHDOKA.PDHDOKAA.IC.IC092846 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0005

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.B00001 TYPE=PART
DBD=PDHDOKA DDN=PDHDOKAB DSID=004 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=4 IC AVAIL=0 IC USED=1 DSSN=00000003
NOREUSE RECOVPD=4
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

ALLOC
ALLOC =00.168 09:30:08.4 * ALLOC LRID =0000000000000000
DSSN=0000000003 USID=0000000004 START = 00.168 09:26:08.2

IMAGE
RUN = 00.168 09:28:56.1 * RECORD COUNT =5
STOP = 00.000 00:00:00.0 BATCH USID=0000000003

IC1
DSN=IMSVS.PDHDOKA.PDHDOKAB.IC.IC092847 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0006

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.C00001 TYPE=PART
DBD=PDHDOKA DDN=PDHDOKAC DSID=005 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000001
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

Appendix C. Sample Listings of RECONs 389

Sample RECON Listing Active Site
IMAGE
RUN = 00.168 09:28:58.9 * RECORD COUNT =7
STOP = 00.000 00:00:00.0 BATCH USID=0000000003

IC1
DSN=IMSVS.PDHDOKA.PDHDOKAC.IC.IC092847 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0007

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.D00001 TYPE=PART
DBD=PDHDOKA DDN=PDHDOKAD DSID=006 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000001
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

IMAGE
RUN = 00.168 09:29:01.5 * RECORD COUNT =2
STOP = 00.000 00:00:00.0 BATCH USID=0000000003

IC1
DSN=IMSVS.PDHDOKA.PDHDOKAD.IC.IC092847 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0008

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.L00001 TYPE=PART
DBD=PDHDOKA DDN=PDHDOKAL DSID=003 DBORG=INDEX DSORG=VSAM
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

390 DBRC Guide & Reference

Sample RECON Listing Active Site
00.168 18:15:28.7 LISTING OF RECON PAGE 0009
-------------------------------------------------------------------------------
DB
DBD=PDHDOKB MASTER DB=DBHDOK01 CHANGE#=3 TYPE=PART
USID=0000000003 AUTHORIZED USID=0000000003 HARD USID=0000000003
RECEIVE USID=0000000003 RECEIVE NEEDED USID=0000000000
DBRCVGRP=**NULL**

RANDOMIZER:
NAME=DFSHDC20 ANCHOR=3 HIGH BLOCK#=3 BYTES=25
FREE SPACE:
FREE BLOCK FREQ FACTOR=0 FREE SPACE PERCENTAGE=0

PARTITION HIGH KEY/STRING (CHAR): (LENGTH=5 )

K0400
PARTITION HIGH KEY/STRING (HEX):
D2F0F4F0F0404040404040404040404040404040404040404040404040404040

OSAM BLOCK SIZE:

A = 4096
B = 4096
C = 4096
D = 4096

FLAGS: COUNTERS:
BACKOUT NEEDED =OFF RECOVERY NEEDED COUNT =0
READ ONLY =OFF IMAGE COPY NEEDED COUNT =0
PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =0
HELD AUTHORIZATION STATE=0
EEQE COUNT =0
TRACKING SUSPENDED =NO RECEIVE REQUIRED COUNT =0
OFR REQUIRED =NO
PARTITION INIT NEEDED =NO
-------------------------------------------------------------------------------
00.168 18:15:28.7 LISTING OF RECON PAGE 0010
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.A00002 TYPE=PART
DBD=PDHDOKB DDN=PDHDOKBA DSID=001 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000002
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

Appendix C. Sample Listings of RECONs 391

Sample RECON Listing Active Site
ALLOC
ALLOC =00.168 09:30:08.8 * ALLOC LRID =0000000000000000
DSSN=0000000002 USID=0000000003 START = 00.168 09:26:08.2

IMAGE
RUN = 00.168 09:29:04.1 * RECORD COUNT =2
STOP = 00.000 00:00:00.0 BATCH USID=0000000002

IC1
DSN=IMSVS.PDHDOKB.PDHDOKBA.IC.IC092848 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0011

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.B00002 TYPE=PART
DBD=PDHDOKB DDN=PDHDOKBB DSID=004 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000002
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

ALLOC
ALLOC =00.168 09:30:09.1 * ALLOC LRID =0000000000000000
DSSN=0000000002 USID=0000000003 START = 00.168 09:26:08.2

IMAGE
RUN = 00.168 09:29:06.7 * RECORD COUNT =2
STOP = 00.000 00:00:00.0 BATCH USID=0000000002

IC1
DSN=IMSVS.PDHDOKB.PDHDOKBB.IC.IC092848 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0012

-------------------------------------------------------------------------------

392 DBRC Guide & Reference

Sample RECON Listing Active Site
DBDS
DSN=IMSTESTS.DBHDOK01.C00002 TYPE=PART
DBD=PDHDOKB DDN=PDHDOKBC DSID=005 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000000
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

IMAGE
RUN = 00.168 09:29:09.5 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000002

IC1
DSN=IMSVS.PDHDOKB.PDHDOKBC.IC.IC092848 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0013

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.D00002 TYPE=PART
DBD=PDHDOKB DDN=PDHDOKBD DSID=006 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000000
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

IMAGE
RUN = 00.168 09:29:12.0 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000002

IC1
DSN=IMSVS.PDHDOKB.PDHDOKBD.IC.IC092849 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0014

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.L00002 TYPE=PART
DBD=PDHDOKB DDN=PDHDOKBL DSID=003 DBORG=INDEX DSORG=VSAM
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

Appendix C. Sample Listings of RECONs 393

Sample RECON Listing Active Site
00.168 18:15:28.7 LISTING OF RECON PAGE 0015
-------------------------------------------------------------------------------
DB
DBD=PDHDOKC MASTER DB=DBHDOK01 CHANGE#=4 TYPE=PART
USID=0000000003 AUTHORIZED USID=0000000003 HARD USID=0000000003
RECEIVE USID=0000000003 RECEIVE NEEDED USID=0000000000
DBRCVGRP=**NULL**

RANDOMIZER:
NAME=DFSHDC20 ANCHOR=3 HIGH BLOCK#=3 BYTES=25
FREE SPACE:
FREE BLOCK FREQ FACTOR=0 FREE SPACE PERCENTAGE=0

PARTITION HIGH KEY/STRING (CHAR): (LENGTH=5 )

K0600
PARTITION HIGH KEY/STRING (HEX):
D2F0F6F0F0404040404040404040404040404040404040404040404040404040

OSAM BLOCK SIZE:

A = 4096
B = 4096
C = 4096
D = 4096

FLAGS: COUNTERS:
BACKOUT NEEDED =OFF RECOVERY NEEDED COUNT =0
READ ONLY =OFF IMAGE COPY NEEDED COUNT =0
PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =0
HELD AUTHORIZATION STATE=0
EEQE COUNT =0
TRACKING SUSPENDED =NO RECEIVE REQUIRED COUNT =0
OFR REQUIRED =NO
PARTITION INIT NEEDED =NO
-------------------------------------------------------------------------------
00.168 18:15:28.7 LISTING OF RECON PAGE 0016
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.A00003 TYPE=PART
DBD=PDHDOKC DDN=PDHDOKCA DSID=001 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000002
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

394 DBRC Guide & Reference

Sample RECON Listing Active Site
ALLOC
ALLOC =00.168 09:30:09.6 * ALLOC LRID =0000000000000000
DSSN=0000000002 USID=0000000003 START = 00.168 09:26:08.2

IMAGE
RUN = 00.168 09:29:14.5 * RECORD COUNT =2
STOP = 00.000 00:00:00.0 BATCH USID=0000000002

IC1
DSN=IMSVS.PDHDOKC.PDHDOKCA.IC.IC092849 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0017

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.B00003 TYPE=PART
DBD=PDHDOKC DDN=PDHDOKCB DSID=004 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000002
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

ALLOC
ALLOC =00.168 09:30:09.7 * ALLOC LRID =0000000000000000
DSSN=0000000002 USID=0000000003 START = 00.168 09:26:08.2

IMAGE
RUN = 00.168 09:29:17.2 * RECORD COUNT =2
STOP = 00.000 00:00:00.0 BATCH USID=0000000002

IC1
DSN=IMSVS.PDHDOKC.PDHDOKCB.IC.IC092849 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0018

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.C00003 TYPE=PART
DBD=PDHDOKC DDN=PDHDOKCC DSID=005 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000000
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

Appendix C. Sample Listings of RECONs 395

Sample RECON Listing Active Site
IMAGE
RUN = 00.168 09:29:19.7 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000002

IC1
DSN=IMSVS.PDHDOKC.PDHDOKCC.IC.IC092849 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0019

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.D00003 TYPE=PART
DBD=PDHDOKC DDN=PDHDOKCD DSID=006 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000000
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

IMAGE
RUN = 00.168 09:29:22.3 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000002

IC1
DSN=IMSVS.PDHDOKC.PDHDOKCD.IC.IC092850 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0020

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.L00003 TYPE=PART
DBD=PDHDOKC DDN=PDHDOKCL DSID=003 DBORG=INDEX DSORG=VSAM
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0

396 DBRC Guide & Reference

Sample RECON Listing Active Site
-------------------------------------------------------------------------------
00.168 18:15:28.7 LISTING OF RECON PAGE 0021
-------------------------------------------------------------------------------
DB
DBD=PDHDOKD MASTER DB=DBHDOK01 CHANGE#=5 TYPE=PART
USID=0000000004 AUTHORIZED USID=0000000004 HARD USID=0000000004
RECEIVE USID=0000000004 RECEIVE NEEDED USID=0000000000
DBRCVGRP=**NULL**

RANDOMIZER:
NAME=DFSHDC20 ANCHOR=3 HIGH BLOCK#=3 BYTES=25
FREE SPACE:
FREE BLOCK FREQ FACTOR=0 FREE SPACE PERCENTAGE=0

PARTITION HIGH KEY/STRING (CHAR): (LENGTH=5 )

.....
PARTITION HIGH KEY/STRING (HEX):
FFFFFFFFFF404040404040404040404040404040404040404040404040404040

OSAM BLOCK SIZE:

A = 4096
B = 4096
C = 4096
D = 4096

FLAGS: COUNTERS:
BACKOUT NEEDED =OFF RECOVERY NEEDED COUNT =0
READ ONLY =OFF IMAGE COPY NEEDED COUNT =0
PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =0
HELD AUTHORIZATION STATE=0
EEQE COUNT =0
TRACKING SUSPENDED =NO RECEIVE REQUIRED COUNT =0
OFR REQUIRED =NO
PARTITION INIT NEEDED =NO
00.168 18:15:28.7 LISTING OF RECON PAGE 0022
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.A00004 TYPE=PART
DBD=PDHDOKD DDN=PDHDOKDA DSID=001 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000003
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

Appendix C. Sample Listings of RECONs 397

Sample RECON Listing Active Site
ALLOC
ALLOC =00.168 09:30:10.1 * ALLOC LRID =0000000000000000
DSSN=0000000003 USID=0000000004 START = 00.168 09:26:08.2

IMAGE
RUN = 00.168 09:29:24.8 * RECORD COUNT =3
STOP = 00.000 00:00:00.0 BATCH USID=0000000003

IC1
DSN=IMSVS.PDHDOKD.PDHDOKDA.IC.IC092850 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0023

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.B00004 TYPE=PART
DBD=PDHDOKD DDN=PDHDOKDB DSID=004 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000003
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

ALLOC
ALLOC =00.168 09:30:10.3 * ALLOC LRID =0000000000000000
DSSN=0000000003 USID=0000000004 START = 00.168 09:26:08.2

IMAGE
RUN = 00.168 09:29:27.8 * RECORD COUNT =8
STOP = 00.000 00:00:00.0 BATCH USID=0000000003

IC1
DSN=IMSVS.PDHDOKD.PDHDOKDB.IC.IC092850 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

398 DBRC Guide & Reference

Sample RECON Listing Active Site

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.C00004 TYPE=PART
DBD=PDHDOKD DDN=PDHDOKDC DSID=005 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000001
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------
RUN = 00.168 09:29:30.5 * RECORD COUNT =7
STOP = 00.000 00:00:00.0 BATCH USID=0000000003

IC1
DSN=IMSVS.PDHDOKD.PDHDOKDC.IC.IC092850 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.D00004 TYPE=PART
DBD=PDHDOKD DDN=PDHDOKDD DSID=006 DBORG=HDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000000
NOREUSE RECOVPD=2
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

IMAGE
RUN = 00.168 09:29:33.3 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000003

IC1
DSN=IMSVS.PDHDOKD.PDHDOKDD.IC.IC092851 FILE SEQ=0001
UNIT=3400 VOLS DEF=0001 VOLS USED=0001
VOLSER=222222

00.168 18:15:28.7 LISTING OF RECON PAGE 0026

-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHDOK01.L00004 TYPE=PART
DBD=PDHDOKD DDN=PDHDOKDL DSID=003 DBORG=INDEX DSORG=VSAM
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0

Appendix C. Sample Listings of RECONs 399

Sample RECON Listing Active Site
DB (FP) and Related Records
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0361
-------------------------------------------------------------------------------
DB
DBD=DEDBDD01 DMB#=8 TYPE=FP
SHARE LEVEL=1
FLAGS: COUNTERS:
RECOVERY NEEDED COUNT =0
IMAGE COPY NEEDED COUNT =0
PROHIBIT AUTHORIZATION=OFF AUTHORIZED AREAS =1
RECOVERABLE =YES EEQE COUNT =0
-------------------------------------------------------------------------------
1999.251 11:46:24.1 -08:00 LISTING OF RECON PAGE 0362
-------------------------------------------------------------------------------
DBDS
DBD=DEDBDD01 AREA=DD01AR0 TYPE=FP
SHARE LEVEL=1 DSID=001 DBORG=DEDB DSORG=VSAM
GSGNAME=IMSGSG1 USID=0000000003
AUTHORIZED USID=0000000003 RECEIVE USID=0000000003 HARD USID=0000000003
RECEIVE NEEDED USID=0000000000
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000002
NOREUSE RECOVPD=0 NOVSO PREOPEN NOPRELOAD
CFSTR1=**NULL** CFSTR2=**NULL** NOLKASID
DEFLTJCL=**NULL** ICJCL=ICJCL RECVJCL=ICRCVJCL RECOVJCL=RECOVJCL
DBRCVGRP=**NULL**

FLAGS: COUNTERS:
PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =1
HELD AUTHORIZATION STATE=6
IC NEEDED =OFF ADS AVAIL # =1
RECOV NEEDED =OFF REGISTERED ADS # =1
DATABASE LEVEL TRACK =YES EEQE COUNT =0
RECEIVE NEEDED =OFF
OFR REQUIRED =NO
TRACKING SUSPENDED =NO
HSSP CIC IN PROGRESS =NO

ADS LIST:
CREATE
-ADS DDN--ADS DSN- -STAT- -RUNNING-
DD01AR0 DD01AR0 AVAIL NO

ASSOCIATED SUBSYSTEM INFORMATION:

ENCODED
-SSID- -ACCESS INTENT- -STATE- -SS ROLE-
SYS3 UPDATE 6 ACTIVE
-------------------------------------------------------------------------------

ALLOC
ALLOC =1999.251 11:37:42.5 -08:00 * ALLOC LRID =0000000000000000
DSSN=0000000001 USID=0000000002 START = 1999.251 11:37:33.0 -08:00

ALLOC
ALLOC =1999.251 11:40:57.1 -08:00 * ALLOC LRID =0000000000000000
DSSN=0000000002 USID=0000000003 START = 1999.251 11:40:50.0 -08:00

Figure 37. Sample Listing of a RECON at the Active Site - DB (FP) and Related Records
(Part 1 of 2)

400 DBRC Guide & Reference

Sample RECON Listing Tracking Site
IMAGE
RUN = 1996.100 07:15:11.2 -08:00 *
STOP = 1996.100 07:16:12.3 -08:00 SMSCIC USID=0000000001

IC1
DSN=IMSVS.DEDBDD01.SMSCIC.DSN1 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=IMSCC1

Figure 37. Sample Listing of a RECON at the Active Site - DB (FP) and Related Records
(Part 2 of 2)

Sample Listing of a RECON at the Tracking Site

Beginning with Figure 38, the following figures comprise a listing of a RECON from
a tracking site in an RSR environment. “Fields Present in a Listing of a RECON by
Record Type” on page 416 describes the fields that can be present in a listing of the
RECON.

RECON Status Record

IMS/ESA VERSION 7 RELEASE 1 DATA BASE RECOVERY CONTROL
/* LIST IN LOCAL TIME */
LIST.RECON TIMEFMT(L,O,P,4)
1999.251 11:46:45.8 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
RECON
RECOVERY CONTROL DATA SET, IMS/ESA V7R1
DMB#=8 INIT TOKEN=99251F1858306F
NOFORCER LOG DSN CHECK=CHECK17 STARTNEW=NO
TAPE UNIT=3400 DASD UNIT=SYSDA TRACEOFF SSID=**NULL**
LIST DLOG=YES CA/IC/LOG DATA SETS CATALOGED=NO
LOG RETENTION PERIOD=00.000 00:15:00.0
SIZALERT DSNUM=15 VOLNUM=16 PERCENT= 95
LOGALERT DSNUM=3 VOLNUM=16

TIME STAMP INFORMATION:

TIMEZIN = %SYS -LABEL- -OFFSET-

PDT -07:00
PST -08:00

OUTPUT FORMAT: DEFAULT = LOCORG NONE PUNC YY

CURRENT = LOCAL OFFSET PUNC YYYY

-DDNAME- -STATUS- -DATA SET NAME-

RECON1 COPY1 IMSTESTL.IMS.RECON1
RECON2 COPY2 IMSTESTL.IMS.RECON2
RECON3 SPARE IMSTESTL.IMS.RECON3

Figure 38. Sample Listing of a RECON at the Tracking Site - RECON Status Record

Appendix C. Sample Listings of RECONs 401

Sample RECON Listing Tracking Site
Log Records
1999.251 11:46:45.8 -08:00 LISTING OF RECON PAGE 0305
-------------------------------------------------------------------------------
PRILOG
START = 1999.251 11:16:52.6 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 1999.251 11:35:06.3 -08:00 #DSN=4
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 2
EARLIEST CHECKPOINT = 1999.251 11:18:46.7 -08:00

DSN=IMSTESTL.RSR.RLDS1.N0000011
START = 1999.251 11:16:52.6 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:17:46.6 -08:00 LAST DS LSN= 0000000000000281
#DS CHECKPOINTS= 2 CHKPT ID = 1999.251 11:16:59.8 -08:00

DSN=IMSTESTL.RSR.RLDS1.N0000014
START = 1999.251 11:17:46.6 -08:00 FIRST DS LSN= 0000000000000282
STOP = 1999.251 11:18:46.9 -08:00 LAST DS LSN= 0000000000000528
#DS CHECKPOINTS= 2 CHKPT ID = 1999.251 11:17:53.1 -08:00

DSN=IMSTESTL.RSR.RLDS1.N0000017
START = 1999.251 11:18:46.9 -08:00 FIRST DS LSN= 0000000000000529
STOP = 1999.251 11:35:05.7 -08:00 LAST DS LSN= 000000000000072F
#DS CHECKPOINTS= 2 CHKPT ID = 0000.000 00:00:00.0 +00:00

DSN=IMSTESTL.RSR.RLDS1.N0000019
START = 1999.251 11:35:05.7 -08:00 FIRST DS LSN= 0000000000000730
STOP = 1999.251 11:35:06.3 -08:00 LAST DS LSN= 000000000000078B
#DS CHECKPOINTS= 0 CHKPT ID = 1999.251 11:35:05.6 -08:00

LOGALL
START = 1999.251 11:16:52.6 -08:00 *
DBDS ALLOC=0

Figure 39. Sample Listing of a RECON at the Tracking Site - Log Records (Part 1 of 6)

402 DBRC Guide & Reference

Sample RECON Listing Tracking Site
1999.251 11:46:45.8 -08:00 LISTING OF RECON PAGE 0306
-------------------------------------------------------------------------------
PRISLD
START = 1999.251 11:16:52.6 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 1999.251 11:35:06.3 -08:00 #DSN=4
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 2

DSN=IMSTESTL.RSR.ARCH1.N0000010
START = 1999.251 11:16:52.6 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:17:46.6 -08:00 LAST DS LSN= 0000000000000281
#DS CHECKPOINTS= 2 CHKPT ID = 1999.251 11:16:59.8 -08:00

DSN=IMSTESTL.RSR.ARCH1.N0000013
START = 1999.251 11:17:46.6 -08:00 FIRST DS LSN= 0000000000000282
STOP = 1999.251 11:18:46.9 -08:00 LAST DS LSN= 0000000000000528
#DS CHECKPOINTS= 2 CHKPT ID = 1999.251 11:17:53.1 -08:00

DSN=IMSTESTL.RSR.ARCH1.N0000016
START = 1999.251 11:18:46.9 -08:00 FIRST DS LSN= 0000000000000529
STOP = 1999.251 11:35:05.7 -08:00 LAST DS LSN= 000000000000072F
#DS CHECKPOINTS= 2 CHKPT ID = 0000.000 00:00:00.0 +00:00

DSN=IMSTESTL.RSR.ARCH1.N0000018
START = 1999.251 11:35:05.7 -08:00 FIRST DS LSN= 0000000000000730
STOP = 1999.251 11:35:06.3 -08:00 LAST DS LSN= 000000000000078B
#DS CHECKPOINTS= 0 CHKPT ID = 1999.251 11:35:05.6 -08:00
1999.251 11:46:45.8 -08:00 LISTING OF RECON PAGE 0307
-------------------------------------------------------------------------------
PRILOG
START = 1999.251 11:35:37.8 -08:00 * SSID=BATCH1 VERSION=7.1
STOP = 1999.251 11:35:40.2 -08:00 #DSN=1
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 3

DSN=IMSTESTL.RSR.ARCH1.N0000021
START = 1999.251 11:35:37.8 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:35:40.2 -08:00 LAST DS LSN= 000000000000009C
#DS CHECKPOINTS= 0 CHKPT ID = 0000.000 00:00:00.0 +00:00

LOGALL
START = 1999.251 11:35:37.8 -08:00 *
DBDS ALLOC=3 -DBD- -DDN- -ALLOC-
DHVNTZ02 HIDAM 1
DXVNTZ02 XDLBT04I 1
DIVNTZ02 DBHVSAM1 1

Figure 39. Sample Listing of a RECON at the Tracking Site - Log Records (Part 2 of 6)

Appendix C. Sample Listings of RECONs 403

Sample RECON Listing Tracking Site
1999.251 11:46:45.8 -08:00 LISTING OF RECON PAGE 0308
-------------------------------------------------------------------------------
PRILOG
START = 1999.251 11:37:33.0 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 1999.251 11:40:49.9 -08:00 #DSN=2
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 4
EARLIEST CHECKPOINT = 1999.251 11:37:41.0 -08:00

DSN=IMSTESTL.RSR.RLDS1.N0000024
START = 1999.251 11:37:33.0 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:38:22.8 -08:00 LAST DS LSN= 00000000000001FB
#DS CHECKPOINTS= 1 CHKPT ID = 1999.251 11:37:41.0 -08:00

DSN=IMSTESTL.RSR.RLDS1.N0000028
START = 1999.251 11:38:22.8 -08:00 FIRST DS LSN= 00000000000001FC
STOP = 1999.251 11:40:49.9 -08:00 LAST DS LSN= 0000000000000220
#DS CHECKPOINTS= 0 CHKPT ID = 0000.000 00:00:00.0 +00:00

LOGALL
START = 1999.251 11:37:33.0 -08:00 *
DBDS ALLOC=4 -DBD- -DDN- -ALLOC-
DEDBDD01 DD01AR0 1
DHVNTZ02 HIDAM 1
DXVNTZ02 XDLBT04I 1
DIVNTZ02 DBHVSAM1 1
1999.251 11:46:45.8 -08:00 LISTING OF RECON PAGE 0309
-------------------------------------------------------------------------------
PRISLD
START = 1999.251 11:37:33.0 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 1999.251 11:40:49.9 -08:00 #DSN=2
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 4

DSN=IMSTESTL.RSR.ARCH1.N0000023
START = 1999.251 11:37:33.0 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:38:22.8 -08:00 LAST DS LSN= 00000000000001FB
#DS CHECKPOINTS= 1 CHKPT ID = 1999.251 11:37:41.0 -08:00

DSN=IMSTESTL.RSR.ARCH1.N0000027
START = 1999.251 11:38:22.8 -08:00 FIRST DS LSN= 00000000000001FC
STOP = 1999.251 11:40:49.9 -08:00 LAST DS LSN= 0000000000000220
#DS CHECKPOINTS= 0 CHKPT ID = 0000.000 00:00:00.0 +00:00

Figure 39. Sample Listing of a RECON at the Tracking Site - Log Records (Part 3 of 6)

404 DBRC Guide & Reference

Sample RECON Listing Tracking Site
1999.251 11:46:45.8 -08:00 LISTING OF RECON PAGE 0310
-------------------------------------------------------------------------------
PRILOG
START = 1999.251 11:40:50.0 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 0000.000 00:00:00.0 +00:00 #DSN=2
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000221 PRILOG TOKEN= 5
EARLIEST CHECKPOINT = 1999.251 11:37:41.0 -08:00

DSN=IMSTESTL.RSR.RLDS1.N0000030
START = 1999.251 11:40:50.0 -08:00 FIRST DS LSN= 0000000000000221
STOP = 1999.251 11:40:54.9 -08:00 LAST DS LSN= 00000000000002CD
#DS CHECKPOINTS= 1 CHKPT ID = 1999.251 11:37:41.0 -08:00

DSN=IMSTESTL.RSR.SLDS1.N0000026
START = 0000.000 00:00:00.0 +00:00 FIRST DS LSN= 00000000000003E0
STOP = 0000.000 00:00:00.0 +00:00 LAST DS LSN= 0000000000000000
#DS CHECKPOINTS= 0 CHKPT ID = 0000.000 00:00:00.0 +00:00

LOGALL
START = 1999.251 11:40:50.0 -08:00 *
DBDS ALLOC=0
1999.251 11:46:45.8 -08:00 LISTING OF RECON PAGE 0311
-------------------------------------------------------------------------------
PRISLD
START = 1999.251 11:40:50.0 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 0000.000 00:00:00.0 +00:00 #DSN=2
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000221 PRILOG TOKEN= 5

DSN=IMSTESTL.RSR.ARCH1.N0000029
START = 1999.251 11:40:50.0 -08:00 FIRST DS LSN= 0000000000000221
STOP = 1999.251 11:40:54.9 -08:00 LAST DS LSN= 00000000000002CD
#DS CHECKPOINTS= 1 CHKPT ID = 1999.251 11:37:41.0 -08:00

Figure 39. Sample Listing of a RECON at the Tracking Site - Log Records (Part 4 of 6)

Appendix C. Sample Listings of RECONs 405

Sample RECON Listing Tracking Site
1999.251 11:46:45.8 -08:00 LISTING OF RECON PAGE 0312
-------------------------------------------------------------------------------
PRILOG
START = 1999.251 11:44:49.0 -08:00 * SSID=IMS2 VERSION=7.1
STOP = 1999.251 11:45:29.4 -08:00 #DSN=2
GSGNAME=IMSGSG1 TRACKING PREV-GAP
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 6
EARLIEST CHECKPOINT = 0000.000 00:00:00.0 +00:00

DSN=IMSTESTL.RSR.RLDS1.N0000035
START = 1999.251 11:44:49.0 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:45:28.3 -08:00 LAST DS LSN= 000000000000018C
#DS CHECKPOINTS= 2 CHKPT ID = 0000.000 00:00:00.0 +00:00

DSN=IMSTESTL.RSR.RLDS1.N0000037
START = 1999.251 11:45:28.3 -08:00 FIRST DS LSN= 000000000000018D
STOP = 1999.251 11:45:29.4 -08:00 LAST DS LSN= 00000000000001BB
#DS CHECKPOINTS= 0 CHKPT ID = 0000.000 00:00:00.0 +00:00

LOGALL
START = 1999.251 11:44:49.0 -08:00 *
DBDS ALLOC=0
1999.251 11:46:45.8 -08:00 LISTING OF RECON PAGE 0313
-------------------------------------------------------------------------------
PRISLD
START = 1999.251 11:44:49.0 -08:00 * SSID=IMS2 VERSION=7.1
STOP = 1999.251 11:45:29.4 -08:00 #DSN=2
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 6

DSN=IMSTESTL.RSR.ARCH1.N0000034
START = 1999.251 11:44:49.0 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:45:28.3 -08:00 LAST DS LSN= 000000000000018C
#DS CHECKPOINTS= 2 CHKPT ID = 0000.000 00:00:00.0 +00:00

DSN=IMSTESTL.RSR.ARCH1.N0000036
START = 1999.251 11:45:28.3 -08:00 FIRST DS LSN= 000000000000018D
STOP = 1999.251 11:45:29.4 -08:00 LAST DS LSN= 00000000000001BB
#DS CHECKPOINTS= 0 CHKPT ID = 0000.000 00:00:00.0 +00:00

Figure 39. Sample Listing of a RECON at the Tracking Site - Log Records (Part 5 of 6)

406 DBRC Guide & Reference

Sample RECON Listing Tracking Site
1999.251 11:46:45.8 -08:00 LISTING OF RECON PAGE 0314
-------------------------------------------------------------------------------
PRIOLD
SSID=SYS3 # DD ENTRIES=2
EARLIEST CHECKPOINT = 1999.251 11:05:30.9 -08:00

DDNAME=DFSOLP00 DSN=IMSTESTL.IMS01.OLDSP0
START = 1999.251 11:05:29.4 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:43:28.7 -08:00 LAST DS LSN= 000000000000045B
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=YES AVAIL
PRILOG TIME=1999.251 11:05:29.4 -08:00 ARCHIVE JOB NAME=JT114329
VERSION=7.1

DDNAME=DFSOLP01 DSN=IMSTESTL.IMS01.OLDSP1
START = 1999.251 11:43:28.7 -08:00 FIRST DS LSN= 000000000000045C
STOP = 0000.000 00:00:00.0 +00:00 LAST DS LSN= 0000000000000000
LOCK SEQUENCE# = 000000000000
STATUS=ACTIVE FEOV=NO AVAIL
PRILOG TIME=1999.251 11:05:29.4 -08:00
VERSION=7.1
DSP0260I NO INTERIM RLDS/SLDS RECORDS FOUND IN RECON
DSP0260I NO INT-ONLINE LOG RECORDS FOUND IN RECON
1999.251 11:46:45.8 -08:00 LISTING OF RECON PAGE 0315
-------------------------------------------------------------------------------
PRITSLDS
START = 1999.251 11:05:29.4 -08:00 * SSID=SYS3 VERSION=7.1
STOP = 0000.000 00:00:00.0 +00:00 #DSN=1
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 0

DSN=IMSVS.SLDSP.SYS3.D99251.T1205294.V00 UNIT=SYSDA
START = 1999.251 11:05:29.4 -08:00 FIRST DS LSN= 0000000000000001
STOP = 1999.251 11:43:28.7 -08:00 LAST DS LSN= 000000000000045B
FILE SEQ=0001 #VOLUMES=0001

VOLSER=000000 STOPTIME = 1999.251 11:43:28.7 -08:00

CKPTCT=1 CHKPT ID = 1999.251 11:05:30.9 -08:00
LOCK SEQUENCE#= 000000000000

Figure 39. Sample Listing of a RECON at the Tracking Site - Log Records (Part 6 of 6)

GSG Record
1999.251 11:46:45.8 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
GSG
GSGNAME=IMSGSG1 #SGS=2 -SGNAME- -ROLE-
STLSITE1 ACTIVE
STLSITE2 TRACKING LOCAL
CURRENT PRILOG TOKEN = 6 TAKEOVER TOKEN = 0
MINIMUM PRILOG TOKEN = 1 DSN SEQ NUMBER = 36
START TIME OF CURRENT LOG = 1999.251 11:44:49.0 -08:00
HIGHEST ACTIVE SITE TIME = 1999.251 11:45:29.4 -08:00
TRACKING SUBSYSTEM ID = SYS3
TAKEOVER IN PROGRESS

Figure 40. Sample Listing of a RECON at the Tracking Site - GSG Record

Appendix C. Sample Listings of RECONs 407

Sample RECON Listing Tracking Site
SSYS Record
1999.251 11:46:45.8 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
SSYS
SSID=SYS3 LOG START=1999.251 11:05:29.4 -08:00
SSTYPE=TRACKER ABNORMAL TERM=OFF RECOVERY STARTED=NO BACKUP=NO
TRACKED=NO TRACKER TERM=OFF SHARING COVERED DBS=NO
GSGNAME=IMSGSG1

AUTHORIZED DATA BASES/AREAS=4 VERSION=7.1

ENCODED
-DBD- -AREA- -LEVEL- -ACCESS INTENT- -STATE-
DEDBJN21 DB21AR0 1 EXCLUSIVE 7
DHVNTZ02 **NULL** 3 EXCLUSIVE 7
DXVNTZ02 **NULL** 3 EXCLUSIVE 7
DIVNTZ02 **NULL** 3 EXCLUSIVE 7

SSYS
SSID=SYS3 LOG START=1999.251 11:37:33.0 -08:00
SSTYPE=ONLINE ABNORMAL TERM=ON RECOVERY STARTED=NO BACKUP=NO
TRACKED=YES TRACKER TERM=OFF SHARING COVERED DBS=NO
IRLMID=**NULL** IRLM STATUS=NORMAL GSGNAME=IMSGSG1

AUTHORIZED DATA BASES/AREAS=4 VERSION=7.1

ENCODED
-DBD- -AREA- -LEVEL- -ACCESS INTENT- -STATE-
DEDBDD01 DD01AR0 1 UPDATE 6
DHVNTZ02 **NULL** 3 UPDATE 6
DXVNTZ02 **NULL** 3 UPDATE 6
DIVNTZ02 **NULL** 3 UPDATE 6

Figure 41. Sample Listing of a RECON at the Tracking Site - SSYS Record

BACKOUT Record
1999.251 11:46:45.8 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
BACKOUT
SSID=SYS3 #UORS=1

RECOVERY TOKEN=E2E8E2F3404040400000000300000002
TIME=1999.251 11:38:22.5 -08:00 PSB=PLVAPZ12
INFLT BMP
ASSOCIATED DATA BASES=3

BACKED DYN BKOUT

-DBD- -OUT - -FAILURE-
DHVNTZ02 NO NO
DXVNTZ02 NO NO
DIVNTZ02 NO NO

Figure 42. Sample Listing of a RECON at the Tracking Site - BACKOUT Record

408 DBRC Guide & Reference

Sample RECON Listing Tracking Site
CAGRP and CA Records
1999.274 09:27:48.3 -09:00 LISTING OF RECON
-------------------------------------------------------------------------------
CAGRP
GRPNAME=CAGRP1 GRPMAX=3 CA AVAIL=0 CA USED=1
NOREUSE CAJCL=CAJCL DEFLTJCL=**NULL**
#MEMBERS=4 -DBD- -DDN-
DEDBJN21 DB21AR1
DEDBJN21 DB21AR3
DEDBJN21 DB21AR6
DEDBJN21 DB21AR7

CA
DSN=IMSVS.CAGRP1.CA.CA182601 FILE SEQ=1
CAGRP=CAGRP1 STOP = 1999.274 08:40:44.3 -09:00 *
UNIT=SYSDA VOLS DEF=1 VOLS USED=1
VOLSER=222222
RUN = 1999.274 09:26:39.6 -09:00
DBD=DEDBJN21 DDN=DB21AR1 PURGETIME = 1999.274 08:31:07.0 -09:00
CHANGES ACCUMULATED=YES COMPLETE CA=YES INDOUBT EEQES=NO
LSN = 000000000000 DSSN = 0000000001
LRID = 0000000000000414 USID = 0000000002
DBD=DEDBJN21 DDN=DB21AR3 PURGETIME = 1999.274 08:31:07.0 -09:00
CHANGES ACCUMULATED=YES COMPLETE CA=YES INDOUBT EEQES=NO
LSN = 000000000000 DSSN = 0000000001
LRID = 0000000000000428 USID = 0000000002
DBD=DEDBJN21 DDN=DB21AR6 PURGETIME = 1999.274 08:31:07.0 -09:00
CHANGES ACCUMULATED=NO COMPLETE CA=YES INDOUBT EEQES=NO
LSN = 000000000000 DSSN = 0000000000
LRID = 0000000000000000 USID = 0000000000
DBD=DEDBJN21 DDN=DB21AR7 PURGETIME = 1999.274 08:31:07.0 -09:00
CHANGES ACCUMULATED=NO COMPLETE CA=YES INDOUBT EEQES=NO
LSN = 000000000000 DSSN = 0000000000
LRID = 0000000000000000 USID = 0000000000
-------------------------------------------------------------------------------
CAGRP
GRPNAME=CAGRP2 GRPMAX=5 CA AVAIL=0 CA USED=0
NOREUSE CAJCL=CAJCL DEFLTJCL=**NULL**
#MEMBERS=3 -DBD- -DDN-
DBVHDJ05 CJVHDG1E
DBOHIDK5 CKOHIG1O
DXVHIDK5 CKVHIIXK

Figure 43. Sample Listing of a RECON at the Tracking Site - CAGRP and CA Records

Appendix C. Sample Listings of RECONs 409

Sample RECON Listing Tracking Site
DBDSGRP Records
1999.274 09:27:48.3 -09:00 LISTING OF RECON
-------------------------------------------------------------------------------
DBDSGRP
GRPNAME=DBGRP1 #MEMBERS=6 -DBD- -DDN/AREA-
DIVNTZ02 **NULL**
DHVNTZ02 **NULL**
DXVNTZ02 **NULL**
DB21AR0 **NULL**
DB21AR1 **NULL**
DB21AR2 **NULL**

DBDSGRP
GRPNAME=FJKGRP #MEMBERS=5 -DBD- -DDN/AREA-
DIVNTZ02 DBHVSAM1
DIVNTZ02 DBHVSAM2
DHVNTZ02 HIDAM
DHVNTZ02 HIDAM2
DXVNTZ02 XDLBT04I

Figure 44. Sample Listing of a RECON at the Tracking Site - DBDSGRP Records

DB (IMS) and Related Records

1999.251 11:46:45.8 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
DB
DBD=DBVHDJ05 IRLMID=*NULL DMB#=1 TYPE=IMS
SHARE LEVEL=3 GSGNAME=**NULL** USID=0000000001
AUTHORIZED USID=0000000000 RECEIVE USID=0000000000 HARD USID=0000000000
RECEIVE NEEDED USID=0000000000
DBRCVGRP=**NULL**
FLAGS: COUNTERS:
BACKOUT NEEDED =OFF RECOVERY NEEDED COUNT =0
READ ONLY =OFF IMAGE COPY NEEDED COUNT =0
PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =0
RECOVERABLE =YES HELD AUTHORIZATION STATE=0
EEQE COUNT =0
TRACKING SUSPENDED =NO RECEIVE REQUIRED COUNT =0
OFR REQUIRED =NO

DBDS
DSN=DBVHDJ05.CJXXD01E TYPE=IMS
DBD=DBVHDJ05 DDN=CJVHDG1E DSID=001 DBORG=HDAM DSORG=VSAM
CAGRP=CAGRP2 GENMAX=2 IC AVAIL=0 IC USED=0 DSSN=00000000
NOREUSE RECOVPD=0
DEFLTJCL=**NULL** ICJCL=ICJCL OICJCL=OICJCL RECOVJCL=RECOVJCL
RECVJCL=ICRCVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
IC RECOMMENDED =ON
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0

Figure 45. Sample Listing of a RECON at the Tracking Site - DB (IMS) and Related Records

410 DBRC Guide & Reference

Sample RECON Listing Tracking Site
DB (FP) and Related Records
1999.251 11:46:45.8 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
DB
DBD=DEDBDD01 DMB#=7 TYPE=FP
SHARE LEVEL=1
FLAGS: COUNTERS:
RECOVERY NEEDED COUNT =0
IMAGE COPY NEEDED COUNT =0
PROHIBIT AUTHORIZATION=OFF AUTHORIZED AREAS =1
RECOVERABLE =YES EEQE COUNT =0

DBDS
DBD=DEDBDD01 AREA=DD01AR0 TYPE=FP
SHARE LEVEL=1 DSID=001 DBORG=DEDB DSORG=VSAM
GSGNAME=IMSGSG1 USID=0000000002
AUTHORIZED USID=0000000000 RECEIVE USID=0000000000 HARD USID=0000000000
RECEIVE NEEDED USID=0000000000
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=0 DSSN=00000001
NOREUSE RECOVPD=0 NOVSO PREOPEN NOPRELOAD
CFSTR1=**NULL** CFSTR2=**NULL** NOLKASID
DEFLTJCL=**NULL** ICJCL=ICJCL RECVJCL=ICRCVJCL RECOVJCL=RECOVJCL
DBRCVGRP=**NULL**
FLAGS: COUNTERS:
PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =1
HELD AUTHORIZATION STATE=6
IC NEEDED =OFF ADS AVAIL # =1
IC RECOMMENDED =ON
RECOV NEEDED =OFF REGISTERED ADS # =1
DATABASE LEVEL TRACK =YES EEQE COUNT =0
RECEIVE NEEDED =OFF
OFR REQUIRED =NO
TRACKING SUSPENDED =NO
HSSP CIC IN PROGRESS =NO

ADS LIST:
CREATE
-ADS DDN--ADS DSN- -STAT- -RUNNING-
DD01AR0 DD01AR0 AVAIL NO

ASSOCIATED SUBSYSTEM INFORMATION:

ENCODED
-SSID- -ACCESS INTENT- -STATE- -SS ROLE-
SYS3 UPDATE 6 ACTIVE
-------------------------------------------------------------------------------

ALLOC
ALLOC =1999.251 11:37:42.5 -08:00 * ALLOC LRID =00000000000000D8
DSSN=0000000001 USID=0000000002 START = 1999.251 11:37:33.0 -08:00

Figure 46. Sample Listing of a RECON at the Tracking Site - DB (FP) and Related Records

Appendix C. Sample Listings of RECONs 411

Sample RECON Listing Tracking Site
IMS DB Records
1999.251 11:46:45.8 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
DB
DBD=DHVNTZ02 IRLMID=*NULL DMB#=5 TYPE=IMS
SHARE LEVEL=3 GSGNAME=IMSGSG1 USID=0000000003
AUTHORIZED USID=0000000003 RECEIVE USID=0000000001 HARD USID=0000000003
RECEIVE NEEDED USID=0000000000
DBRCVGRP=**NULL**
FLAGS: COUNTERS:
BACKOUT NEEDED =ON RECOVERY NEEDED COUNT =0
READ ONLY =OFF IMAGE COPY NEEDED COUNT =0
PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =2
RECOVERABLE =YES HELD AUTHORIZATION STATE=6
DATABASE LEVEL TRACK =YES EEQE COUNT =0
TRACKING SUSPENDED =NO RECEIVE REQUIRED COUNT =0
OFR REQUIRED =NO

ASSOCIATED SUBSYSTEM INFORMATION:

ENCODED B/O NEEDED
-SSID- -ACCESS INTENT- -STATE- -COUNT- -SS ROLE-
SYS3 EXCLUSIVE 7 1 TRACKING
SYS3 UPDATE 6 0 ACTIVE

Figure 47. Sample Listing of a RECON at the Tracking Site - More IMS DB Records (Part 1
of 5)

412 DBRC Guide & Reference

Sample RECON Listing Tracking Site
1999.251 11:46:45.8 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
DBDS
DSN=DHVNTZ02.FKXXI01E TYPE=IMS
DBD=DHVNTZ02 DDN=HIDAM DSID=001 DBORG=HIDAM DSORG=VSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000002
NOREUSE RECOVPD=0
DEFLTJCL=**NULL** ICJCL=ICJCL OICJCL=OICJCL RECOVJCL=RECOVJCL
RECVJCL=ICRCVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

ALLOC
ALLOC =1999.251 11:35:38.9 -08:00 * ALLOC LRID =0000000000000009
DSSN=0000000001 USID=0000000002 START = 1999.251 11:35:37.8 -08:00

ALLOC
ALLOC =1999.251 11:38:22.2 -08:00 * ALLOC LRID =0000000000000130
DSSN=0000000002 USID=0000000003 START = 1999.251 11:37:33.0 -08:00

IMAGE
RUN = 1999.251 11:02:53.0 -08:00 * RECORD COUNT =0
STOP = 0000.000 00:00:00.0 +00:00 BATCH USID=0000000001

IC1
DSN=IMSTESTG.DHVNTZ02.HIDAM.BASE.IC FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=IMSRAW

RECOV
RUN = 1999.251 11:03:12.0 -08:00 * RUN USID = 0000000001

Figure 47. Sample Listing of a RECON at the Tracking Site - More IMS DB Records (Part 2
of 5)

Appendix C. Sample Listings of RECONs 413

Sample RECON Listing Tracking Site
1999.251 11:46:45.8 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
DBDS
DSN=DHVNTZ02.FKXXI02E TYPE=IMS
DBD=DHVNTZ02 DDN=HIDAM2 DSID=002 DBORG=HIDAM DSORG=VSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000000
NOREUSE RECOVPD=0
DEFLTJCL=**NULL** ICJCL=ICJCL OICJCL=OICJCL RECOVJCL=RECOVJCL
RECVJCL=ICRCVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

IMAGE
RUN = 1999.251 11:02:53.0 -08:00 * RECORD COUNT =0
STOP = 0000.000 00:00:00.0 +00:00 BATCH USID=0000000001

IC1
DSN=IMSTESTG.DHVNTZ02.HIDAM2.BASE.IC FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=IMSRAW

RECOV
RUN = 1999.251 11:03:12.6 -08:00 * RUN USID = 0000000001
1999.251 11:46:45.8 -08:00 LISTING OF RECON PAGE 0344
-------------------------------------------------------------------------------
DB
DBD=DIVNTZ02 IRLMID=*NULL DMB#=4 TYPE=IMS
SHARE LEVEL=3 GSGNAME=IMSGSG1 USID=0000000003
AUTHORIZED USID=0000000003 RECEIVE USID=0000000001 HARD USID=0000000003
RECEIVE NEEDED USID=0000000000
DBRCVGRP=**NULL**
FLAGS: COUNTERS:
BACKOUT NEEDED =ON RECOVERY NEEDED COUNT =0
READ ONLY =OFF IMAGE COPY NEEDED COUNT =0
PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =2
RECOVERABLE =YES HELD AUTHORIZATION STATE=6
DATABASE LEVEL TRACK =YES EEQE COUNT =0
TRACKING SUSPENDED =NO RECEIVE REQUIRED COUNT =0
OFR REQUIRED =NO

ASSOCIATED SUBSYSTEM INFORMATION:

ENCODED B/O NEEDED
-SSID- -ACCESS INTENT- -STATE- -COUNT- -SS ROLE-
SYS3 EXCLUSIVE 7 1 TRACKING
SYS3 UPDATE 6 0 ACTIVE

Figure 47. Sample Listing of a RECON at the Tracking Site - More IMS DB Records (Part 3
of 5)

414 DBRC Guide & Reference

Sample RECON Listing Tracking Site
1999.251 11:46:45.8 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
DBDS
DSN=DIVNTZ02.FJXXS01K TYPE=IMS
DBD=DIVNTZ02 DDN=DBHVSAM1 DSID=001 DBORG=HISAM DSORG=VSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000002
NOREUSE RECOVPD=0
DEFLTJCL=**NULL** ICJCL=ICJCL OICJCL=OICJCL RECOVJCL=RECOVJCL
RECVJCL=ICRCVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

ALLOC
ALLOC =1999.251 11:35:39.6 -08:00 * ALLOC LRID =000000000000006C
DSSN=0000000001 USID=0000000002 START = 1999.251 11:35:37.8 -08:00

ALLOC
ALLOC =1999.251 11:38:22.6 -08:00 * ALLOC LRID =000000000000019B
DSSN=0000000002 USID=0000000003 START = 1999.251 11:37:33.0 -08:00

IMAGE
RUN = 1999.251 11:02:53.0 -08:00 * RECORD COUNT =0
STOP = 0000.000 00:00:00.0 +00:00 BATCH USID=0000000001

IC1
DSN=IMSTESTG.DIVNTZ02.DBHVSAM1.BASE.IC FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=IMSRAW

RECOV
RUN = 1999.251 11:03:11.0 -08:00 * RUN USID = 0000000001

Figure 47. Sample Listing of a RECON at the Tracking Site - More IMS DB Records (Part 4
of 5)

Appendix C. Sample Listings of RECONs 415

Fields in a RECON Listing
1999.251 11:46:45.8 -08:00 LISTING OF RECON
-------------------------------------------------------------------------------
DBDS
DSN=DIVNTZ02.FJXXS01E TYPE=IMS
DBD=DIVNTZ02 DDN=DBHVSAM2 DSID=002 DBORG=HISAM DSORG=VSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000000
NOREUSE RECOVPD=0
DEFLTJCL=**NULL** ICJCL=ICJCL OICJCL=OICJCL RECOVJCL=RECOVJCL
RECVJCL=ICRCVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------

IMAGE
RUN = 1999.251 11:02:53.0 -08:00 * RECORD COUNT =0
STOP = 0000.000 00:00:00.0 +00:00 BATCH USID=0000000001

IC1
DSN=IMSTESTG.DIVNTZ02.DBHVSAM2.BASE.IC FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=IMSRAW

RECOV
RUN = 1999.251 11:03:11.6 -08:00 * RUN USID = 0000000001

Figure 47. Sample Listing of a RECON at the Tracking Site - More IMS DB Records (Part 5
of 5)

Fields Present in a Listing of a RECON by Record Type

The following sections describe the fields that can be present in a listing of the
RECON by record type:
v “Fields Present in a RECON Record” on page 417
v “Fields Present in a THT Record” on page 420
v “Fields Present in a Log Record” on page 421
v “Fields Present in a LOGALL Record” on page 423
v “Fields Present in an Online Log Record” on page 423
v “Fields Present in a GSG Record” on page 427
v “Fields Present in a SSYS Record” on page 428
v “Fields Present in a BACKOUT Record” on page 429
v “Fields Present in a CAGRP Record” on page 430
v “Fields Present in a CA Record” on page 431
v “Fields Present in a Data Group Record” on page 433
v “Fields Present in a DB (IMS) Record” on page 434
v “Fields Present in a DB (Fast Path) Record” on page 440
v “Fields Present in a DBDS (non-Fast Path) Record” on page 441
v “Fields Present in a DB (HALDB) Record” on page 436
v “Fields Present in a DB (PART) and Related Records” on page 437
v “Fields Present in a DBDS (Fast Path) Record” on page 443
v “Fields Present in an ALLOC Record” on page 447
v “Fields Present in an IMAGE Record” on page 448

416 DBRC Guide & Reference

Fields in a RECON Listing
v “Fields Present in a REORG Record” on page 450
v “Fields Present in a RECOV Record” on page 451
Examples of many of these fields appear in Figure 29 on page 374 and Figure 38
on page 401.

Definition:

A group of lines refers to the lines following the referring statement whose row
spans the width of the table. The group of lines ends at the next statement that
spans the width of the table, unless otherwise specified.

Fields Present in a RECON Record

A RECON record’s fields and their corresponding line numbers are described in
Table 20.
Table 20. Fields Present in the RECON Record
Record Line
Type Number Field Contents
RECON 1
2 RECOVERY CONTROL Identifies the version and release of
DATA SET, IMS/ESA VxRx the RECON.
COEXISTENCE ENABLED Specifies that pre-version 6 and
version 6 RECONs may coexist.
3 DMB#= nnn Represents the last value assigned
to a new database record.
INIT TOKEN= token The token assigned to this RECON
when it was initialized.
4 FORCER | NOFORCER Indicates whether databases must be
registered in RECON. FORCER
indicates that all databases must be
registered. NOFORCER indicates
that all databases do not need to be
registered.
LOG DSN CHECK= The type of log data set name
xxxxxx checking; xxxxxx is CHECK17,
CHECK44, or NOCHECK.
STARTNEW= YES | NO When I/O errors exist on one of the
RECON, YES indicates that new
jobs are to start. NO indicates that
no new jobs are to start.
5 TAPE UNIT= unittype The default unit type for log data
sets, NOREUSE image copy data
sets, and NOREUSE change
accumulation data sets that reside
on tape devices.
DASD UNIT= unittype The default unit type for log data
sets, NOREUSE image copy data
sets, and NOREUSE change
accumulation data sets that reside
on DASD devices.
TRACEON | TRACEOFF TRACEON indicates DBRC is to
produce external GTF trace entries.

Appendix C. Sample Listings of RECONs 417

Fields in a RECON Record
Table 20. Fields Present in the RECON Record (continued)
Record Line
Type Number Field Contents
SSID= xxxxxxxx The IMS subsystem default name.
6 LISTDLOG= YES | NO Indicates whether the names of log
data sets deleted from RECON are
to be listed.
CA | IC | LOG DATA SETS Indicates whether CA, IC, and log
CATALOGED= YES | NO data sets are to be treated as if they
are cataloged. To bypass volume
serial checking of utility DD
statements, specify YES and the
data set is cataloged. If you specify
NO (or the data set is not cataloged),
volume serial checking takes place.
7 LOG RETENTION PERIOD= Indicates the minimum amount of
yy.ddd hh:mm:ss.t time that DBRC is to keep log
records in RECON.
8 TRACE OPTIONS= This line is printed only if an IBM
options representative has instructed you to
gather documentation for problem
analysis. It indicates that an IBM
representative has provided
instructions to enable DBRC trace
records to be written to the DBRC
trace table for problem analysis. The
IBM representative will have
provided the options.
9 LOGALERT= xxxxxxxx The (optional) threshold that triggers
xxxxxxxx the DSP0287W message (warning
you when you just have time to shut
down an online IMS subsystem
before it ABENDs due to the
PRILOG record exceeding
RECORDSIZE). Field values can be
dsnum, volnum and percent.
10 SIZALERT= xxxxxxxx The (optional) thresholds that trigger
xxxxxxxx xx messages to warn you that a record
has grown unnaturally large. Field
values can be dsnum, volnum and
percent.
The following line is printed only if a failure occurred during a multiple update to the RECON:
11 UPDATE TYPE= nnnn The type of multiple update that was
in progress.
DBID= xxxxxxxx xxxxxxxx Data set name and data set ddname
of the DBDS involved in the multiple
update. Can be blank.
CAGRP= xxxxxxxx Name of the CA group involved in
the multiple update. Contains blanks
if no group was involved.
NEW DDN= xxxxxxxx New ddname, if any, that was
associated with the DBDS that was
involved in the multiple update.
Contains blanks if no new name or
DBDS was involved.

418 DBRC Guide & Reference

Fields in a RECON Record
Table 20. Fields Present in the RECON Record (continued)
Record Line
Type Number Field Contents
12 OLD RECORD KEY This field is printed only if the
multiple update involves a key
change.
13 KEY TYPE= *xxxxx A description of the record type. The
asterisk (*) is printed only if the
record is available for future use (it is
either new or scheduled for reuse).
Whenever an unrecognizable record
key type is found, BADTYP.KEY is
printed, together with the key in
hexadecimal characters.
DBD= xxxxxxxx, The database name and data set
DDN= xxxxxxxx ddname of a DBDS. If the record is
PRILOG, SECLOG, IPRI, or ISEC,
the fields are printed as **NULL**. If
the record is a CAGRP or DB record,
the DBD field is **NULL**, and the
DDN field contains the name of the
CA group or database.
TIME= timestamp The time stamp of the key of the
record.
14-15 NEW RECORD KEY This field is printed only if a new
record key is being added. Additional
fields in this part of the record are
printed as shown in line 8.
16-17 BASE RECORD KEY This field is printed only if a new
record key is being changed. The
remaining fields in this part of the
record are printed as shown in line 8.
18-19 SSID= ssidname Information about the multiple
IRLMID= irlmidname update.
SHARE LVL #= n
#DB= n
B/O#= n
20 FLAGS: A heading for the following lines.
21 RECOV= ON | OFF Information about the multiple
NORECOV= ON | OFF update.
ICON= ON | OFF
ICOFF= ON | OFF
22 NORMAL= ON | OFF Information about the multiple
ABNORMAL= ON | OFF update.
STARTRCV= ON | OFF
ENDRECOV= ON | OFF
23 READON= ON | OFF Information about the multiple
READOFF= ON | OFF update.
AUTH= ON | OFF NOAUTH=
ON | OFF
24 B/O DONE= ON | OFF Information about the multiple
PASS 1= ON | OFF update.
BACKOUT= ON | OFF
SHARELVL= ON | OFF

Appendix C. Sample Listings of RECONs 419

Fields in a RECON Record
Table 20. Fields Present in the RECON Record (continued)
Record Line
Type Number Field Contents
25 TIME STAMP Heading for section containing
INFORMATION: RECON time stamp information.
26 TIMEZIN= offset User-specified input time stamp
offset default. If no offset is specified,
this field displays %SYS meaning that
the offset of the MVS clock is to be
used.
-LABEL- -OFFSET- These column headings are printed if
a Time Zone Label Table has been
defined.
27-nnn label offset The list of defined time zone offset
labels with their corresponding offset
values.
28 OUTPUT FORMAT: Time stamp output format settings.
DEFAULT= Default time stamp output format
offset display form yearsize settings.
29 CURRENT= Current time stamp output format
offset display form yearsize settings.
30 -DDNAME- -STATUS- -DATA Column headings for the following
SET NAME- one to three lines.
31 RECON1 | RECON2 | The ddname, status, and data set
RECON3 name of the Copy1 RECON.
COPY1
dsname
32-33 RECON1 | RECON2 | These lines identify the ddname,
RECON3 | COPY2 | status, and data set name of the
DISCARDED | SPARE | RECON backup (Copy2), the
UNAVAILABLE RECON spare, and any RECONs
dsname or blank that are not usable (DISCARDED). A
RECON that could not be accessed
is shown as UNAVAILABLE
(unknown dsname and status).

Fields Present in a THT Record

A time history table record’s fields and their corresponding line numbers are
described in Table 21.
Table 21. Fields Present in the THT Record
Record Line
Type Number Field Contents
THT 1
2 -LOCAL START- Column headings for the Time History
-OFFSET- Table.
3-nnn yyyy.ddd hh:mm:ss.t The local start time of the period in
±hh:mm which the offset is in effect.

420 DBRC Guide & Reference

Fields in Log Records
Fields Present in a Log Record
The log records include the types listed under Record Type in the Table 22.

A log record’s fields and their corresponding line numbers are described in
Table 22.
Table 22. Fields Present in a Log Record
Record Line
Type Number Field Contents
PRILOG or 1
SECLOG or
PRISLD or
SECSLD or
IPRI or
ISEC or
IPRISL or
ISECSL or
PRITSLDS
or
SECTSLDS
or
IPRITSLD
or
ISECTSLD
2 START= timestamp* Time stamp of the start time (that is,
original open time) of the log data set.
An asterisk (*) indicates that this time
stamp is part of the record key.
SSID= ssidname The name of the IMS subsystem.
VERSION=version The version of the IMS subsystem
that created the log.
3 STOP= timestamp Time stamp of the stop time (that is,
close time) of the log data set. Zeros
indicate that the data set is still open.
#DSN= nn The number of data sets in the log
data set. A value of zero indicates
that no data set has been created.
4 GSGNAME= gsgname Identifies the name of the GSG to
which the subsystem producing this
log belongs.
The following 4 fields are printed if the condition in the contents column is true:
TRACKING This log data set was originally
created by an active IMS subsystem
of the nonlocal service group and
transported to the tracking site.
GAP There is a gap in the log data sets of
this record.
PREV-GAP There is a gap in a previous log
record of the same global service
group.
BBO Identifies the log record as it was
created by batch backout. If the
record was not created by batch
backout, this field is blank.

Appendix C. Sample Listings of RECONs 421

Fields in Log Records
Table 22. Fields Present in a Log Record (continued)
Record Line
Type Number Field Contents
5 FIRST RECORD ID= lsn The log record sequence number of
the first log record that was written
during initialization of the IMS
subsystem.
PRILOG TOKEN= n The numeric log token assigned
sequentially to PRILOG records for
the same GSG.
6 EARLIEST This line is printed only for online
CHECKPOINT= PRILOGs. It indicates the earliest
timestamp checkpoint required by IMS
emergency restart (/ERE or /ERE
BUILDQ).
7 DSN= log.dsname The data set name of the log data set
described in this record.
****COMPRESSED DATA SET ****
indicates that PRILOG compression
has removed unneeded DSN entries.
ERR This field is printed if a previous
command was used to indicate that
an error exists in the log data set.
UNIT= unittype Unit type to be used for substitution
during the GENJCL process.
8 START= timestamp Start time of the data set entry in the
log data set.
FIRST RECORD LSN= The log record sequence number of
lsn the first log record of the data set.
9 STOP= timestamp Stop time of the data set entry in the
log data set. Zeros indicate that the
data set is still open.
LAST RECORD LSN= The log record sequence number of
lsn the last log record of the data set.
10 FILE SEQ= nnnn The file sequence number of the log
data set. This field is not printed for
tracking logs.
#VOLUMES= nnn The number of volumes for each data
set entry. This field is not printed for
tracking logs.
#DS CHECKPOINTS= n Count of checkpoint records in the log
data set. This field is only printed for
tracking logs.
11 VOLSER= volser Volume serial number and stop time.
STOPTIME= timestamp This field is not printed for tracking
logs.
12 CKPTCT= n Checkpoint count and ID value.
CHKPT ID= timestamp
FEOV Indicates that the corresponding log
data set at the active site was closed
by a /DBR with the forced end of
volume option. This field is only
printed for tracking PRILOGs.

422 DBRC Guide & Reference

Fields in Log Records

Fields Present in a LOGALL Record

A log allocation record’s fields and their corresponding line numbers are described
in Table 23.
Table 23. Fields Present in the LOGALL Record
Record Line
Type Number Field Contents
LOGALL 1
2 START= timestamp* The start time of the log data set that
contains change records for DBDSs
included in this record. If the asterisk
(*) is present, it indicates that this
time stamp also occurs in the key of
the LOGALL record.
3 DBDS ALLOC= nnnn The number of allocated DBDSs for
this log data set.
-DBD- -DDN- -ALLOC- These headings are printed only if the
LOGALL record contained records of
each DBDS that was allocated
between the start and stop time
stamps of the log data set.
4-nnn dbdname ddname nnnn The database name, data set
ddname, and number of allocations of
the DBDS during the time span of the
allocated log.

Fields Present in an Online Log Record

An online log record’s fields and their corresponding line numbers are described in
Table 24.
Table 24. Fields Present in an Online Log Record
Record Line
Type Number Field Contents
PRILOG or 1
SECLOG or
PRISLD or
SECSLD or
IPRI or
ISEC or
IPRISL or
ISECSL or
PRITSLDS
or
SECTSLDS
or
IPRITSLD
or
ISECTSLD
2 START= timestamp* Time stamp of the start time (that is,
original open time) of the log data set.
An asterisk (*) indicates that this time
stamp is part of the record key.

Appendix C. Sample Listings of RECONs 423

Fields in an Online Log Record
Table 24. Fields Present in an Online Log Record (continued)
Record Line
Type Number Field Contents
SSID= ssidname The name of the IMS subsystem.
VERSION=version The version of the IMS subsystem
that created the log.
3 STOP= timestamp Time stamp of the stop time (that is,
close time) of the log data set. Zeros
indicate that the data set is still open.
#DSN= nn The number of data sets in the log
data set. A value of zero indicates
that no data set has been created.
4 GSGNAME= gsgname Identifies the name of the GSG to
which the subsystem producing this
log belongs.
The following 4 fields are printed if the condition in the contents column is true:
TRACKING This log data set was originally
created by an active IMS subsystem
of the nonlocal service group and
transported to the tracking site.
GAP There is a gap in the log data sets of
this record.
PREV-GAP There is a gap in a previous log
record of the same global service
group.
BBO Identifies the log record as it was
created by batch backout. If the
record was not created by batch
backout, this field is blank.
5 FIRST RECORD ID= lsn The log record sequence number of
the first log record that was written
during initialization of the IMS
subsystem.
PRILOG TOKEN= n The numeric log token assigned
sequentially to PRILOG records for
the same GSG.
6 EARLIEST This line is printed only for online
CHECKPOINT= PRILOGs. It indicates the earliest
timestamp checkpoint required by IMS
emergency restart (/ERE or /ERE
BUILDQ).
7 DSN= log.dsname The data set name of the log data set
described in this record.
****COMPRESSED DATA SET ****
indicates that PRILOG compression
has removed unneeded DSN entries.
ERR This field is printed if a previous
command was used to indicate that
an error exists in the log data set.
UNIT= unittype Unit type to be used for substitution
during the GENJCL process.

424 DBRC Guide & Reference

Fields in an Online Log Record
Table 24. Fields Present in an Online Log Record (continued)
Record Line
Type Number Field Contents
8 START= timestamp Start time of the data set entry in the
log data set.
FIRST RECORD LSN= The log record sequence number of
lsn the first log record of the data set.
9 STOP= timestamp Stop time of the data set entry in the
log data set. Zeros indicate that the
data set is still open.
LAST RECORD LSN= The log record sequence number of
lsn the last log record of the data set.
10 FILE SEQ= nnnn The file sequence number of the log
data set. This field is not printed for
tracking logs.
#VOLUMES= nnn The number of volumes for each data
set entry. This field is not printed for
tracking logs.
#DS CHECKPOINTS= n Count of checkpoint records in the log
data set. This field is only printed for
tracking logs.
11 VOLSER= volser Volume serial number and stop time.
STOPTIME= timestamp This field is not printed for tracking
logs.
12 CKPTCT= n Checkpoint count and ID value.
CHKPT ID= timestamp
blank line These blank lines are printed as
visual separators only when the log
data set has more than one data set
entry. The format of each data set
entry is a repetition of lines 7 through
12 above.
LOGALL 1
2 START= timestamp* The start time of the log data set that
contains change records for DBDSs
included in this record. If the asterisk
(*) is present, it indicates that this
time stamp also occurs in the key of
the LOGALL record.
3 DBDS ALLOC= nnnn The number of allocated DBDSs for
this log data set.
-DBD- -DDN- -ALLOC- These headings printed only if the
LOGALL record contained records of
each DBDS that was allocated
between the start and stop time
stamps of the log data set.
4-nnn dbdname ddname nnnn The database name, data set
ddname, and number of allocations of
the DBDS during the time span of the
allocated log.

Appendix C. Sample Listings of RECONs 425

Fields in an Online Log Record
Table 24. Fields Present in an Online Log Record (continued)
Record Line
Type Number Field Contents
PRIOLD or 1
SECOLD or
IPRIOL or
ISECOL
2 SSID= xxxxxxxx The name of the IMS subsystem.
# DD ENTRIES= n The number of ddnames in the
OLDS.
3 EARLIEST This line is printed only for PRIOLD
CHECKPOINT= records. It indicates the earliest
timestamp checkpoint required by IMS
emergency restart (/ERE or /ERE
BUILDQ).
4 DDNAME= ddname The ddname of the OLDS.
DSN=log-dsname The data set name of the OLDS.
5 START= timestamp Time stamp of the start time (that is,
original open time) of the log data set.
FIRST DS LSN= lsn The log record sequence number of
the first log record of the data set.
6 STOP= timestamp Time stamp of the stop time (that is,
close time) of the log data set. Zeros
indicate that the data set is not
closed.
LAST DS LSN= lsn The log record sequence number of
the last log record of the data set.
7 STATUS= ARC NEEDED| The status of the DD entry in the
ARC STARTED | OLDS record. This field applies to the
ARC SCHED | PRIOLDS record only.
ARC COMPLT | ACTIVE
ERROR= CLOSE | PREV Indicates a close error on an OLDS or
on a previous OLDS record. This field
applies to the PRIOLDS record only.
FEOV= YES | NO A specification of FEOV=YES forces
an end-of-output data set at the end
of archiving DFSOLP02. This is done
to conform to the recovery point
established by the /DBR command.
This field applies to the PRIOLDS
record only.
AVAIL | UNAVAIL Identifies whether the OLDS is
available for regular use. UNAVAIL
indicates that the data set has invalid
data or an I/O error. This field applies
to PRIOLDS or SECOLDS records
only.
8 PRILOG TIME= Time stamp of the time of the first
timestamp OLDS the subsystem used. This is
also the start time of the PRILOG and
PRISLD records corresponding to the
subsystem invocation.

426 DBRC Guide & Reference

Fields in an Online Log Record
Table 24. Fields Present in an Online Log Record (continued)
Record Line
Type Number Field Contents
ARCHIVE JOB NAME= Name of the archive job generated by
jobname the GENJCL ARCHIVE function.
blank line These blank lines are printed as
visual separators only when the
OLDS has more than one DD entry.
The format of each data set entry is a
repetition of lines 4 through 8 above.

Fields Present in a GSG Record

A global service group record’s fields and their corresponding line numbers are
described in Table 25.
Table 25. Fields Present in a GSG Record
Record Line
Type Number Field Contents
GSG 1
2 GSGNAME= gsgname Identifies the name of the GSG.
#SGS= The number of service groups in this
GSG.
-SGNAME- -ROLE- Headings for the following lines 3
through 10.
3-4 sgnamesgrole Service group name and service
group role (active or tracking).
LOCAL Identifies which service group is the
local one of the GSG.
5 CURRENT PRILOG The highest PRILOG token at the
TOKEN= token local site of this GSG.
TAKEOVER TOKEN= The current PRILOG token at the time
token an RSR takeover was initiated at the
local site.
6 MINIMUM PRILOG The minimum PRILOG that is
TOKEN= token maintained at the local site of the
GSG.
DSN SEQ NUMBER= The initial DSN sequence number
number value for the GSG group.
7 START TIME OF The start time of the PRILOG with the
CURRENT LOG= current log token.
timestamp
8 HIGHEST ACTIVE SITE The highest time received from the
TIME= timestamp active site. This field is only
meaningful to the tracking site.
9 TRACKING Subsystem identification of the
SUBSYSTEM ID= ssid tracking subsystem. This field is null
at the active site.
10 TAKEOVER IN This is printed when an RSR takeover
PROGRESS has been initiated at the local site.

Appendix C. Sample Listings of RECONs 427

Fields in a SSYS Record
Fields Present in a SSYS Record
A subsystem record’s fields and their corresponding line numbers are described in
Table 26.
Table 26. Fields Present in a SSYS Record
Record Line
Type Number Field Contents
SSYS 1
2 SSID= ssidname The name of the IMS subsystem.
LOG START= timestamp The earliest log data set start time
associated with this system or the log
data set start time created by batch
backout.
3 SSTYPE= Indication of whether this is an IMS
ONLINE | BATCH online, batch, or tracking subsystem.
| TRACKER
ABNORMAL TERM= The value of this flag field is normally
ON | OFF OFF. If it is ON, the system has been
abnormally ended and database
recovery is required.
RECOVERY STARTED= If the value of this field is YES, this
YES | NO subsystem has signed on for
recovery-started processing. Normally,
this value is NO.
BACKUP= YES | NO If the value of this field is YES, there
is an alternate subsystem.
4 TRACKED= YES | NO Indicates whether this is the record of
an active subsystem being tracked by
the tracking site.
TRACKER TERM= ON | Indicates whether the tracking
OFF subsystem has terminated. This field
only applies to the tracking subsystem
record.
SHARING COVERED Indicates that this active subsystem is
DBS= YES | NO sharing RSR-covered databases.
5 IRLMID= xxxxxx The IRLM with which this subsystem
is communicating.
IRLM STATUS= Indicates the status of the IRLM.
NORMAL | NORMAL indicates no failure. This
IRLM FAILURE | field does not apply to an RSR
COMM FAILURE | tracking subsystem.
SYS FAILURE
GSG NAME= gsgname Identifies the name of the global
service group to which the subsystem
belongs.
6 BACKUP IRLMID= Identifies the IRLM with which the
irlmname alternate subsystem is
communicating. Listed only if an
alternate subsystem exists.
BACKUP TOKEN= nnnn Identifies the backup token. Listed
only if an alternate subsystem exists.

428 DBRC Guide & Reference

Fields in a SSYS Record
Table 26. Fields Present in a SSYS Record (continued)
Record Line
Type Number Field Contents
7 AUTHORIZED Indicates that this subsystem is
DATABASES | currently authorized to n databases or
AREAS=nnn areas.
VERSION= n Identifies the IMS release level
through which the subsystem signed
on.
If the number of authorized databases or areas is not zero, the following lines (up to the
BACKOUT record line) list those that are currently authorized:
8-9 -DBD- -AREA- -LEVEL- Column headings for the following line
-ACCESSINTENT- or lines that describe the currently
ENCODED -STATE- authorized databases or areas.
10-nnn dbdname areaname This is the name of the database or
sharelvl access encoded area that is currently authorized by
state this subsystem, the share level, the
access intent by this subsystem, and
the encoded state.

Fields Present in a BACKOUT Record

A backout record’s fields and their corresponding line numbers are described in
Table 27.
Table 27. Fields Present in a BACKOUT Record
Record Line
Type Number Field Contents
BACKOUT 1
2 SSID= xxxxxxxx The name of the associated IMS
subsystem.
#UORS= nn The number of units of recovery
(UORs) in the BACKOUT record.
3 RECOVERY TOKEN= 32 Describes a specific UOR.
hexadecimal digits
4 TIME= timestamp The time stamp of the beginning of
the UOR (found in the X'5607' log
record).
PSB= psbname Name of the PSB associated with the
UOR.

Appendix C. Sample Listings of RECONs 429

Fields in a BACKOUT Record
Table 27. Fields Present in a BACKOUT Record (continued)
Record Line
Type Number Field Contents
5 CANDIDATE INFLT | UOR indicators, one or more of which
INDT BMP COLDEND might be listed. CANDIDATE: UOR
CMD BATCH identified by BBO utility prior to restart
(COLDSTART | ACTIVE control
statement). Reset (to null) when
promoted to backout-needed status
by IMS restart. INFLT, In-flight UOR
due to an IMS failure. INDT, In-doubt
UOR due to a CCTL or DBCTL
failure. BMP, UOR due to a BMP.
COLDEND, Cold start has ended.
UOR can only be resolved by BBO.
CMD, UOR entry has been modified
by commands (CHANGE, DELETE,
NOTIFY). BATCH, UOR due to a
dynamic backout failure of DL/I batch.
6 ASSOCIATED Number of databases associated with
DATABASES= nn the UOR.
7, 8 BACKED DYN BKOUT Heading for the following list of
-DBD- -OUT- -FAILURE associated databases.
9-nnn dbname YES | NO YES | Database name. The first YES or NO
NO indicates whether the UOR has been
backed out for the database. The
second YES or NO indicates whether
the UOR is the result of a dynamic
backout failure.

Fields Present in a CAGRP Record

A change accumulation group record’s fields and their corresponding line numbers
are described in Table 28.
Table 28. Fields Present in a CAGRP Record
Record Line
Type Number Field Contents
CAGRP 1
2 GRPNAME= cagrpnam The name of the CA group.
GRPMAX= nnnn The maximum number of change
accumulation run records that can be
associated with this group, whether
available or in use.
CA AVAIL= nnnn The number of available change
accumulation run records currently in
RECON for this group.
CA USED= nnnn The number of in-use change
accumulation run records currently in
RECON for this group.

430 DBRC Guide & Reference

Fields in a CAGRP Record
Table 28. Fields Present in a CAGRP Record (continued)
Record Line
Type Number Field Contents
3 REUSE | NOREUSE Indicates whether change
accumulation data sets can be reused
and whether empty ones can be
created for subsequent use (REUSE)
or not (NOREUSE).
CAJCL= cajclmem The name of the member of a
partitioned data set that contains
skeletal JCL for this CA group.
DEFLTJCL= member The name of the member of a
partitioned data set. This member
contains the skeletal JCL default
values for the user-defined keywords
to be used for this CA group.
4 #MEMBERS= nnnn This number of DBDSs and areas
that belong to this CA group.
-DBD- -DDN- These headings and the following
lines are printed only if some DBDSs
are members of this group.
5-nnn dbdname ddname The database name and data set
ddname of a DBDS that is a member
of this CA group.

Fields Present in a CA Record

A change accumulation record’s fields and their corresponding line numbers are
described in Table 29.
Table 29. Fields Present in a CA Record
Record Line
Type Number Field Contents
CA 1
2 *DSN= The asterisk is printed if the change
chge.accum.dsname accumulation data set identified in this
record is available for use. DSN= is
the change accumulation data set
name that has been or could be used
as the output data set during a run of
the Database Change Accumulation
utility.
FILE SEQ= nnnn The file sequence number of the first
volume of this data set.
3 CAGRP= cagrpname Name of the CA group to which the
change accumulation record belongs.
UNIT= unittype Unit type to be used for substitution
during the GENJCL process.

Appendix C. Sample Listings of RECONs 431

Fields in a CA Record
Table 29. Fields Present in a CA Record (continued)
Record Line
Type Number Field Contents
4 CREATE | STOP= CREATE is printed if the data set is
timestamp* available for future use. In this case,
the time stamp is the time that the
record was created or made available
for recycling. STOP is printed for
in-use records. In this case, the time
stamp is the stop time of the last log
volume that was processed by the
Database Change Accumulation
utility. If SUBSET is printed (see line
6), the time stamp is the start time of
the first unselected log. The asterisk
(*) indicates that this time stamp is in
the record key.
VOLS DEF= nnnn VOLS The number of volumes that have
USED= nnnn been specified for use by this change
accumulation data set and the
number of volumes that were used in
a Database Change Accumulation
utility run. For available change
accumulation data sets, if the data set
can be reused, this field contains the
same value as the VOLS DEF field.
Otherwise, it indicates the number of
volumes that were actually used.
5-nnn VOLSER= volser1, Volume serial numbers of the
volser2,... volumes on which the change
accumulation data set resides or is to
reside. Only as many lines as
necessary are used to list the volume.
The following lines are printed only if the change accumulation data set has been used
during a run of the Change Accumulation utility (the change accumulation data set is no
longer available):
6 RUN= timestamp This time stamp represents the time
of the run of the Change
Accumulation utility during which this
record was used.
ERR This indicates that you have marked
the change accumulation data set as
unusable because of a previous error.
SUBSET This indicates that a subset of logs
were processed when the CA was
created.
* The asterisk (*) indicates that COMP
or SUBSET were specified in the
CHANGE.CA or NOTIFY.CA commands.
These headings are printed only if purge times exist in the record. If purge times exist, there
is one line in the format labeled below (7-9) for each DBDS in the CA group.
7 DBD= dbdname The database name and data set
DDN= ddname ddname of the DBDS.

432 DBRC Guide & Reference

Fields in a CA Record
Table 29. Fields Present in a CA Record (continued)
Record Line
Type Number Field Contents
PURGETIME= timestamp Change records occurring before this
time stamp for the corresponding
DBDS have been ignored by the
Database Change Accumulation
utility.
8 CHANGES YES is printed if the Database
ACCUMULATED= YES | Change Accumulation utility run
NO accumulated any changes for the
corresponding DBDS. NO is printed if
no changes were found for DBDS.
COMPLETE CA= YES | YES is printed if the log subset for the
NO corresponding DBDS is complete. NO
is printed if the log subset for the
DBDS is incomplete.
INDOUBT EEQES= YES is printed to indicate that in
YES | NO doubt EEQEs were accumulated for
the corresponding DBDS. NO is
printed if no in doubt EEQEs were
accumulated.
9 LSN= lsn The lock sequence number of the last
change accumulated for the DBDS is
listed.
DSSN= dssn The data set sequence number of the
last change accumulated for the
DBDS is listed.
10 LRID= log_record_ID The last log record ID of the last
change accumulated for the DBDS is
listed in this field.
USID= update_set_ID The last update set ID of the last
change accumulated for the DBDS is
listed in this field.

Fields Present in a Data Group Record

A database data group record’s fields and their corresponding line numbers are
described in Table 30.
Table 30. Fields Present in the DBDSGRP Record
Record Line
Type Number Field Contents
DBDSGRP 1 Type of group: DBDS, DB, or
DBGRP or Recovery.
RECOVGRP
2 GRPNAME= grpname Name of the group.
#MEMBERS= nnn Number of members belonging to the
group.

Appendix C. Sample Listings of RECONs 433

Fields in a Data Group Record
Table 30. Fields Present in the DBDSGRP Record (continued)
Record Line
Type Number Field Contents
-DBD- -DDN/AREA- Any or all of these headings can be
-DBD/AREA- or -DBD- printed, depending on the group
-AREA- members that exist. For DBDS
groups, the heading is -DBD-
-DDN/AREA-. For DB groups, the
heading is-DBD/AREA-. For recovery
groups, the heading is -DBD- -AREA-.
3-nnn dbdname For DBDSGRP, dbdname = DB name,
ddname/areaname ddname/areaname = DBDS name or
area name. For DBGRP, dbdname =
DL/I DB name or DEDB area name.
ddname/areaname is blank. For
RECOVGRP, dbdname = DB name,
ddname/areaname = area name if DB
is a DEDB, or blank if DB is DL/I.

Fields Present in a DB (IMS) Record

An IMS database record’s fields and their corresponding line numbers are
described in Table 31.
Table 31. Fields Present in the DB (IMS) Record
Record Line
Type Number Field Contents
DB (IMS) 1
2 DBD= dbdname Name of the database.
IRLMID= xxxxx Identifies the IRLM when the share
level of this database is 2. This field
is printed only when SHARE
LEVEL=2.
DMB#= nnn The value assigned when this
database was registered.
TYPE= IMS Indicates that this is a DL/I database
(rather than a Fast Path DEDB).
3 SHARE LEVEL= n The level of data sharing for which
authorized subsystems can share this
database.
GSGNAME= gsgname Identifies the name of the GSG to
which this database belongs.
USID= n The highest update set identifier for
this database.
4 AUTHORIZED USID= n The identifier of the current update
set that is being applied to the
database.
RECEIVE USID= n The update set identifier of the last
image copy received for this
database. The update set ID only
applies to shadow databases at the
tracking site.

434 DBRC Guide & Reference

Fields in a DB (IMS) Record
Table 31. Fields Present in the DB (IMS) Record (continued)
Record Line
Type Number Field Contents
HARD USID= n The update set identifier of the latest
changes that were written to the
database.
5 RECEIVE NEEDED This only applies to shadow
USID= n databases at the tracking site. If n is
not zero, this indicates that image
copies with the identified USID are
required for the DBDSs marked
“receive needed”.
6 FLAGS: COUNTERS: This heading line is printed for lines 7
through 13, which describe the status
of this database.
7 BACKOUT NEEDED= This flag indicates whether this
ON | OFF database needs to be backed-out by
any subsystem.
RECOVERY NEEDED This counter is the number of DBDSs
COUNT= n that are associated with this database
that need to be recovered. The
printed output of the DBDS record
indicates which DBDSs need
recovery.
8 READ ONLY= ON | OFF Indicates whether this database can
be authorized for read processing
only, or authorized for read and
update processing.
IMAGE COPY NEEDED A count of how many DBDSs that are
COUNT= n associated with this database require
an image copy or forward recovery.
The printed output of the DBDS
records indicates which DBDSs
require an image copy.
9 PROHIBIT This flag indicates whether this
AUTHORIZATION= ON | database is available for authorization
OFF processing. If the database can be
authorized, the value is OFF.
AUTHORIZED The count of subsystems that have
SUBSYSTEMS= n current authorization to this database.
10 RECOVERABLE= YES | An indication of whether the database
NO is recoverable (YES) or
non-recoverable (NO).
HELD AUTHORIZATION This is the state derived by the
STATE= n database authorization call process in
IMS. It represents the composite use
of the database by all currently
authorized subsystems. If n= 0, no
subsystem is authorized to use this
database. If n> 0, see line the 17
encoded state field below for the
subsystem encoded state. If n> 128,
block-level data sharing is in effect.
Subtract 128 to determine the true
held authorization state.

Appendix C. Sample Listings of RECONs 435

Fields in a DB (IMS) Record
Table 31. Fields Present in the DB (IMS) Record (continued)
Record Line
Type Number Field Contents
11 DATABASE LEVEL Indicates the level of tracking for the
TRACK= YES | NO database. YES is printed for
database-readiness tracking. NO
indicates recovery-readiness tracking.
This is listed only if the database is
contained in a GSG.
EEQE COUNT= n Number of extended error queue
elements for this database.
12 TRACKING Indicates whether tracking has been
SUSPENDED= YES | NO suspended for this shadow database.
RECEIVE REQUIRED Indicates how many of the DBDSs
COUNT= n (for this shadow database) need
image copies to be received from the
active site.
13 OFR REQUIRED= YES | Indicates whether online forward
NO recovery is required for this shadow
database.
The following lines 14 through 17 are printed only when one or more subsystems are
currently authorized to this database:
14, 15, 16 ASSOCIATED Headings for lines 17-nnn. These
SUBSYSTEM headings are printed if subsystems
INFORMATION: -SSID- exist
-AC INTENT- ENCODED
-STATE- B/O NEEDED
-COUNT- -SS ROLE-
17-nnn ssidname The subsystem associated with this
authorization.
access intent The intended access for the
subsystem: READ, UPDATE,
EXCLUSIVE, or READ-GO.
encoded state= n An internal value derived by IMS to
indicate the subsystem’s intended use
of the database. The values of n are
as follows: 1 - Read only 2 - Read
share 3 - Multiple update 4 - Read
exclusive 5 - Batch update 6 - Single
update 7 - Exclusive
backout needed count Determines that the database needs
n backouts by this subsystem.
ACTIVE | TRACKING Role of authorized subsystem

Fields Present in a DB (HALDB) Record

A HALDB master record’s fields and their corresponding line numbers are described
in Table 32 on page 437.

436 DBRC Guide & Reference

Fields in a DB (IMS) Record
Table 32. Fields Present in the DB (HALDB) Record
Record Line Field Contents
Type Number
DB (HALDB 1
Master)
2 DBD=dbdname Name of the HALDB.
DMB#=nnn The value assigned when this
database was registered.
CHANGE#=nnn The change version number. This is
updated when the definition of the
HALDB is changed.
TYPE=HALDB Indicates that this is the HALDB
master.
3 SHARE LEVEL=n The level of data sharing for which
authorized subsystems can share any
partition of this HALDB.
GSGNAME=gsgname Identifies the name of the GSG to
which this database belongs.
4 PSNAME=psname The name of the partition selection
routine used by this HALDB, if any.
Otherwise **NULL** is printed.
5 FLAGS: COUNTERS: This heading line is printed for line 6,
which describe the status of this
HALDB.
6 RECOVERABLE=YES|NO The HALDB is recoverable or not.
PARTITIONS=n Number of partitions that exist for this
HALDB.

Fields Present in a DB (PART) and Related Records

A HALDB partition database record’s fields and their corresponding line numbers
are described in Table 33.
Table 33. Fields Present in the DB (PART) Record
Record Line Field Contents
Type Number
DB (HALDB 1
Partition)
2 DBD=dbdname Name of the HALDB partition.
MASTER DB=HALDB Name of the HALDB master.
master name
IRLMID=xxxxx Identifies the IRLM name. This
field is printed only when SHARE
LEVEL>=2.
CHANGE#=nnn The change version number is
updated when the definition of the
partition is changed.
TYPE=PART Indicates that a HALDB partition.
3 USID=n The highest update set identifier
for this partition.

Appendix C. Sample Listings of RECONs 437

DB (HALDB and PART) and Related Records
Table 33. Fields Present in the DB (PART) Record (continued)
Record Line Field Contents
Type Number
AUTHORIZED USID=n The identifier of the current update
set being applied to the partition.
HARD USID=n The update set identifier of the
latest changes written to the
partition.
4 RECEIVE USID=n The update set identifier of the last
image copy received for this
partition, which applies only to
shadow databases at the tracking
site.
RECEIVE NEEDED USID=n The update set identifier that
indicates that image copies with
the identified USID are required for
the DBDSs marked “receive
needed”, if n is not zero. It applies
only to shadow databases at the
tracking site.
5 DBRCVGRP=rcvgrpnm The name of the recovery group to
which this partition belongs, if any.
Otherwise **NULL** is printed.
6-7 RANDOMIZER: NAME= Name of the randomizing module
ANCHOR= HIGH BLOCK#= Number of root anchor Maximum
BYTES=nnnnnnnn relative block number value that
the user wishes to allow a
randomizing module to produce for
this DB. Maximum number of bytes
of a DB record that can be stored
into the root addressable area in a
series of inserts unbroken by a call
to another DB record.
8-9 FREE SPACE: FREE Specifies that every nth control
BLOCK FREQ interval or block in this data set
FACTOR=nnn FREE SPACE group is left as free space during
PERCENTAGE=nn DB load or reorganization.
Specifies the minimum percentage
of each control interval or block
that is to be left as free space.
10a PARTITION HIGH Printable and hexadecimal formats
KEY/STRING (CHAR): of the partition high key/selection
(LENGTH=NNN) string. The key/string is padded
with blanks, so the hexadecimal
format may contain extra x’40’
characters beyond the length of
the key/string (LENGTH= in line 10
lists the actual key/string length).
10b PARTITION HIGH Printable and hexadecimal formats
KEY/STRING (HEX): of the partition high key/selection
string. The key/string is padded
with blanks, so the hexadecimal
format may contain extra x’40’
characters beyond the length of
the key/string (LENGTH= in line 10
lists the actual key/string length).

438 DBRC Guide & Reference

DB (HALDB and PART) and Related Records
Table 33. Fields Present in the DB (PART) Record (continued)
Record Line Field Contents
Type Number
11 OSAM BLOCK SIZE: s = OSAM block size is listed for each
nnnnn data set group member defined. s
is the data set group identifier A
through J.
12 FLAGS: COUNTERS: This heading line is printed for
lines 7 through 14, which describe
the status of this partition.
13 BACKOUT This flag indicates whether this
NEEDED=ON|OFF partition needs backout by any
subsystem.
RECOVERY NEEDED This counter is the number of
COUNT=n DBDSs associated with this data
base that need to be recovered.
The printed output of the DBDS
record indicates which DBDSs
need recovery.
14 READ ONLY=ON|OFF Indicates whether this partition can
be authorized for read processing
only, or authorized for read and
update processing.
IMAGE COPY NEEDED Count of how many DBDSs
COUNT=n associated with this partition
require an image copy or forward
recovery. The printed output of the
DBDS records indicates which
DBDSs require an image copy.
15 PROHIBIT This flag indicates whether this
AUTHORIZATION=ON|OFF partition is available for
authorization processing. If the
partition can be authorized, the
value is OFF.
AUTHORIZED The count of subsystems that have
SUBSYSTEMS=n current authorization to this
partition.
16 HELD AUTHORIZATION The state derived by the database
STATE=n authorization call process in IMS,
representing the composite use of
the partition by all currently
authorized subsystems. If n = 0,
no subsystem is authorized to use
this partition. If n > 0, see the table
below for the subsystem encoded
state. If n > 128, online image
copy (OLIC) is in progress for a
data set of this partition.
17 DATABASE LEVEL Indicates the level of tracking for
TRACK=YES|NO the partition only for the HALDB is
covered by a GSG.. YES is printed
for readiness tracking. NO
indicates recovery readiness
tracking.

Appendix C. Sample Listings of RECONs 439

DB (HALDB and PART) and Related Records
Table 33. Fields Present in the DB (PART) Record (continued)
Record Line Field Contents
Type Number
EEQE COUNT=n Number of extended error queue
elements for this partition.
18 TRACKING Indicates whether tracking has
SUSPENDED=YES|NO been suspended for this shadow
database.
RECEIVE REQUIRED Indicates how many of the DBDSs
COUNT=n (for this shadow database) need
image copies from the active site
to be received.
19 OFR REQUIRED=YES|NO Indicates whether online forward
recovery is required for this
shadow database.
20 PARTITION INIT Indicates whether partition
NEEDED=YES|NO initialization is required for this
HALDB partition.
The following lines 15 through 17 are printed only when one or more subsystems are
currently authorized to this partition:
21,22,23 ASSOCIATED SUBSYSTEM
INFORMATION: -SSID-
-ACCESS INTENT-
ENCODED -STATE- B/O
NEEDED -COUNT- -SS
ROLE-
24-nnn ssidname The subsystem associated with
this authorization.
access intent The intended access for the
subsystem: READ, UPDATE,
EXCLUSIVE, or READ-GO.
encoded state=n An internal value derived by IMS to
indicate the subsystem’s intended
use of the partition. The values of
n are as follows:
1. Read only
2. Read share
3. Multiple update
4. Read exclusive
5. Batch update
6. Single update
7. Exclusive
backout needed count Determines that the partition needs
n backouts by this subsystem.
ACTIVE|TRACKING Role of authorized subsystem

Fields Present in a DB (Fast Path) Record

A Fast Path database record’s fields and their corresponding line numbers are
described in Table 34 on page 441.

440 DBRC Guide & Reference

Fields in DB (Fast Path) Record
Table 34. Fields Present in the DB (Fast Path) Record
Record Line
Type Number Field Contents
DB (Fast 1
Path)
2 DBD= dbdname Name of the database.
DMB#= nnn The value assigned when this
database was registered.
TYPE= FP Indicates that the database being
used is a Fast Path DEDB.
3 SHARE LEVEL= n The level of data sharing for which
authorized subsystems can share this
database.
4 FLAGS: COUNTERS: This heading line is printed for lines 4
through 6 describing status of this
database.
5 RECOVERY NEEDED This counter is the number of area
COUNT= n data sets, associated with this
database, that need to be recovered.
The printed output of the area data
set record indicates which area data
sets need recovery.
6 IMAGE COPY NEEDED Count of how many area data sets,
COUNT= n associated with this database, require
an image copy or forward recovery.
The printed output of the area data
set records indicates which area data
sets require an image copy.
7 PROHIBIT This flag indicates whether this
AUTHORIZATION= ON | database is available for authorization
OFF processing. If the database can be
authorized, the value is OFF.
AUTHORIZED AREAS= The count of areas that are currently
n authorized.
8 EEQE COUNT= n Number of extended error queue
elements for this DEDB.

Fields Present in a DBDS (non-Fast Path) Record

A non-Fast Path database data set record’s fields and their corresponding line
numbers are described in Table 35.
Table 35. Fields Present in the DBDS (non-Fast Path) Record
Record Line
Type Number Field Contents
DBDS 1
(non-Fast
Path)
2 DSN= dsname Data set name of the DBDS.
TYPE= IMS Indicates that this is a DBDS rather
than a FP DEDB area.

Appendix C. Sample Listings of RECONs 441

Fields in a DBDS (non-Fast Path) Record
Table 35. Fields Present in the DBDS (non-Fast Path) Record (continued)
Record Line
Type Number Field Contents
TYPE= PART Indicates that this is a DBDS of a
HALDB partition.
3 DBD= dbdname The database name and data set
DDN= ddname ddname of the DBDS.
DSID= nn The data set ID number that appears
as part of the information in the
DBDLIB data set about the DBDS.
DBORG= dbaseorg The database and data set
DSORG= dsetorg organization, as defined for the DBDS
in the DBDLIB data set.
4 CAGRP= cagrpnam The name of the CA group to which
this DBDS belongs, if any. Otherwise,
**NULL** is printed.
GENMAX= nnnn The maximum number of image copy
data sets to be maintained for this
DBDS.
IC AVAIL= nnnn The number of available and in-use
IC USED= nnnn image copy data sets for the DBDS.
DSSN= nnnn The data set synchronization number
that is being used concurrently by
sharing IMS subsystems. A DSSN is
used to reflect the relative order in
which changes are made to a DBDS.
5 REUSE | NOREUSE REUSE is printed if you have
specified in RECON that image copy
data sets are to be reused for this
DBDS.
RECOVPD= nnn This is the recovery period of the
image copies.
The following fields in lines 6 through 11, identify the JCLPDS data set member names that
are to be used in order to generate IMS utility JCL for this DBDS:
6 DEFLTJCL= member The name of the PDS member
containing the skeletal JCL default
values for the user-defined keywords
that are to be used for this DBDS.
ICJCL= member The name of the skeletal JCL PDS
member that is to be used in order to
generate JCL for the Database Image
Copy utility for this DBDS.
OICJCL= member The name of the skeletal JCL PDS
member that is to be used in order to
generate a job for the Online
Database Image Copy utility for this
DBDS.
RECOVJCL= member The name of the skeletal JCL PDS
member that is to be used in order to
generate JCL for the Database
Recovery utility for this DBDS.

442 DBRC Guide & Reference

Fields in a DBDS (non-Fast Path) Record
Table 35. Fields Present in the DBDS (non-Fast Path) Record (continued)
Record Line
Type Number Field Contents
7 RECVJCL= member The name of the skeletal JCL PDS
member for which the Database
Recovery utility is to receive an image
copy for this DBDS at an RSR
tracking site.
8 FLAGS: COUNTERS: Heading for the following lines 9
through 11, which describe the status
of this DBDS.
9 IC NEEDED= ON | OFF Indicates whether an image copy
needs to be taken for the DBDS.
10 IC RECOMMENDED= Indicates that DBRC recommends an
ON image copy of the DBDS should be
taken before using the database.
11 RECOV NEEDED= ON | Indicates whether the DBDS needs to
OFF be recovered.
12 RECEIVE NEEDED = Indicates whether an image copy of
ON | OFF this DBDS needs to be received at
the tracking site. This indicator is only
applicable in an RSR environment at
the RSR tracking site.
EEQE COUNT= n The number of extended error queue
elements for this DBDS.
The following, lines 13 through 15, are printed only if one or more extended error queue
elements exist.
13, 14 ERROR QUEUE Heading for the following list of
ELEMENTS: extended error queue elements (lines
-EQERBA-EEQE 14-nnn).
TYPE-SSID-
15-nnn eeqe rba The relative byte address (RBA) of
the EEQE.
eeqe type The type of extended error queue
element.
ssid The ID of the subsystem that created
the EEQE (in doubt EEQEs only).

Fields Present in a DBDS (Fast Path) Record

A Fast Path database data set record’s fields and their corresponding line numbers
are described in Table 36.
Table 36. Fields Present in the DBDS (Fast Path) Record
Record Line
Type Number Field Contents
DBDS (Fast 1
Path)
2 DBD= dbdname The database name and area name
AREA= areaname of the Fast Path DEDB.

Appendix C. Sample Listings of RECONs 443

Fields in a DBDS (Fast Path) Record
Table 36. Fields Present in the DBDS (Fast Path) Record (continued)
Record Line
Type Number Field Contents
IRLMID= irlmname Identifies the IRLM when the share
level of this DEDB is 2. This field is
printed only when SHARE LEVEL=2.
TYPE= FP Identifies this database as a Fast
Path DEDB.
3 SHARE LEVEL= n The level of data sharing for which
authorized subsystems can share this
area.
DSID= nn The data set ID number that appears
as part of the information in the
DBDLIB data set about the area data
set.
DBORG= dbaseorg The database and data set
DSORG= dsetorg organization, as defined for the area
data set in the DBDLIB data set.
4 GSGNAME= gsgname Identifies the name of the GSG to
which this area belongs.
USID= n The highest update set identifier for
this area.
5 AUTHORIZED USID= n The identifier of the current update
set that is being applied to the area.
RECEIVE USID= n The update set identifier of the last
image copy that was received for this
area. The update set ID only applies
to shadow areas at the tracking site.
HARD USID= n The update set identifier of the latest
changes that were written to the area.
6 RECEIVE NEEDED This only applies to shadow areas at
USID= n the tracking site. If n is not zero, this
indicates that an image copy with the
identified USID needs to be received
for this area.
7 CAGRP= cagrpnam The name of the CA group to which
this area belongs, if any. Otherwise,
**NULL** is printed.
GENMAX= nnnn The maximum number of image copy
data sets to be maintained for this
area.
IC AVAIL= nnnn The number of available image copy
IC USED= nnnn data sets, and the number of in-use
image copy data sets for the area.
DSSN= nnnn This is the data set synchronization
number that is being used
concurrently by sharing IMS
subsystems. A DSSN is used to
reflect the relative order in which
changes are made to an area data
set.

444 DBRC Guide & Reference

Fields in a DBDS (Fast Path) Record
Table 36. Fields Present in the DBDS (Fast Path) Record (continued)
Record Line
Type Number Field Contents
8 REUSE | NOREUSE REUSE is printed if you have
specified in RECON that image copy
data sets are to be reused for this
area data set.
RECOVPD= nnn This is the recovery period of the
image copies.
VSO | NOVSO Indicates whether the area resides in
virtual storage.
PREOPEN | Indicates whether the area is opened
NOPREOPEN at control region initialization or when
the area is started.
PRELOAD | Indicates whether the VSO area is
NOPRELOAD loaded into the data space the next
time it is opened.
9 CFSTR1= cfstr_name The name of the first coupling facility
structure for the area.
CFSTR2= cfstr_name The name of the second coupling
facility structure for the area.
LKASID | NOLKASID Indicates whether local data caching
for the specified area is used for
buffer lookaside on read requests.
10 DEFLTJCL= member The name of the member of the
partitioned data set that contains the
skeletal JCL default values that are to
be used for the DEDB area.
ICJCL= member The name of the skeletal JCL PDS
member that is to be used in order to
generate the JCL for the Database
Image Copy utility for this area data
set.
RECVJCL= member The name of the skeletal JCL PDS
member for which the Database
Recovery utility is to receive an image
copy for this area data set at an RSR
tracking site.
RECOVJCL= member The name of the skeletal JCL PDS
member that is to be used in order to
generate the JCL for the Database
Recovery utility for this area data set.
11 FLAGS: COUNTERS: This heading line is printed for lines
11 through 19 describing the status of
this area.
12 PROHIBIT The value of this flag is OFF if the
AUTHORIZATION= ON | area is available for authorization
OFF processing.
AUTHORIZED The count of subsystems that have
SUBSYSTEMS= n current authorization to this area.

Appendix C. Sample Listings of RECONs 445

Fields in a DBDS (Fast Path) Record
Table 36. Fields Present in the DBDS (Fast Path) Record (continued)
Record Line
Type Number Field Contents
13 HELD AUTHORIZATION This is the state derived by the
STATE= n database authorization call process in
IMS. It represents the composite use
of the database by all currently
authorized subsystems. If n= 0, no
subsystem is authorized to use this
database. If n> 0, see the table below
for the subsystem encoded state. If
n> 128, block-level data sharing is in
effect. Subtract 128 to determine the
true held authorization state.
14 IC NEEDED= ON | OFF Indicates whether an image copy
needs to be taken for the DEDB area.
ADS AVAIL #= n Indicates the number of available
ADS in this area record.
15 IC RECOMMENDED= Indicates that DBRC recommends an
ON image copy of the area should be
taken before it is used.
16 RECOV NEEDED= ON | Indicates whether the areas
OFF associated with the DEDB should be
recovered.
REGISTERED ADS #= n Indicates how many area data sets
for this area are registered in
RECON.
17 DATABASE LEVEL Indicates the level of tracking for the
TRACK = YES | NO area. YES is printed for
database-readiness tracking. NO
indicates recovery-readiness tracking.
This is listed only if the area is
contained in a GSG.
EEQE COUNT= n The number of extended error queue
elements for this DEDB area.
18 RECEIVE NEEDED = Indicates whether an image copy of
ON | OFF this area needs to be received at the
tracking site. This indicator is only
applicable in an RSR environment at
the RSR tracking site.
19 OFR REQUIRED= YES | Indicates whether online forward
NO recovery is required for this shadow
area.
20 TRACKING Indicates whether tracking has been
SUSPENDED= YES | NO suspended for this shadow area.
21 HSSP CIC IN Indicates whether an HSSP
PROGRESS= YES | NO concurrent image copy is in progress.
The following lines, 22 through 24, are printed only if one or more error queue elements
exist.
22 ERROR QUEUE Heading for the following list of error
23 ELEMENTS: queue elements.
-EQERBA-EEQE
TYPE-SSID-

446 DBRC Guide & Reference

Fields in a DBDS (Fast Path) Record
Table 36. Fields Present in the DBDS (Fast Path) Record (continued)
Record Line
Type Number Field Contents
24-nnn eeqe rba The type of extended error queue
element.
eeqe type The type of extended error queue
element.
ssid The ID of the subsystem that created
the EEQE (in doubt EEQEs only).
If the number of registered area data sets is not zero, the following lines 25 through 27 list
those area data sets that are currently registered in this area record:
25 ADS LIST: -ADS DDN- These lines, 25 through 27, represent
26 -ADS DSN- -STAT- the column headings for the following
27 CREATE -RUNNING- line 28.
The following line (28) is repeated for each area data set that is registered for this area.
28-nn adsddn adsdsn AVAIL indicates that the area data set
AVAIL | UNAVAIL is available. UNAVAIL indicates that
YES | NO the area data set is unavailable. YES
indicates that the area data set is
being used. NO indicates that the
area data set is not being used.
The following lines nn+1 through nn+3,are printed only when one or more subsystems are
currently authorized to this area:
nn+1 nn+2 ASSOCIATED Lines nn+1 through nn+3 represent
nn+3 SUBSYSTEM the column headings for the following
INFORMATION -SSID- lines nn+3-mm.
-ACCESS INTENT-
ENCODED -STATE- -SS
ROLE-
The following line nn+3-mm, is repeated for each subsystem that has authorization for this
database.
nn+3-mm ssidname The subsystem associated with this
authorization.
access intent The intended access for the
subsystem: READ, UPDATE,
EXCLUSIVE, or READ-GO.
encoded state= n An internal value derived by IMS to
indicate the subsystem’s intended use
of the database. The values of n are
as follows: 1 - Read only 2 - Read
share 3 - Multiple update 4 - Read
exclusive 5 - Batch update 6 - Single
update 7 - Exclusive
ACTIVE | TRACKING Role of the authorized subsystem.

Fields Present in an ALLOC Record

An allocation record’s fields and their corresponding line numbers are described in
Table 37 on page 448.

Appendix C. Sample Listings of RECONs 447

Fields in an ALLOC Record
Table 37. Fields Present in the ALLOC Record
Record Line
Type Number Field Contents
ALLOC 1
2 ALLOC= timestamp* The time stamp for a time that the
DBDS was allocated during the run of
an IMS system. An asterisk (*)
indicates that it is part of the record
key.
ALLOC LRID= n The log record sequence number of
the begin update log record. The
value for n is 0 for ALLOC records
that are created at the active site.
3 DSSN= nnnn This is the data set synchronization
number that is being concurrently
used by sharing IMS subsystems. A
DSSN is used to reflect the relative
order in which changes are made to a
DBDS or area.
USID= n The update set identifier. An update
set is a collection of updates that are
made to the database or area while it
is continuously updated by one or
more IMS subsystems.
START= timestamp The start time of the log data set that
was logging change records when
this DBDS was allocated.
4 DEALLOC= timestamp The time stamp of a specific
deallocation. This field is printed only
if a specific deallocation time is in the
record. If the DBDS was allowed to
remain allocated to the closing of the
log data set, this line is not printed.
DEALLOC LRID= n The log record sequence number of
the end-update log record. This field
is only printed if a specific
deallocation time exists.
5 TRACKING This will only be printed for shadow
SUSPENDED AT databases that are being tracked at
RECORD: suspend lrid the tracking site. The suspend lrid
TRACKING indicates the current tracking log
SUSPENDED NO position.
RECORDS APPLIED

Fields Present in an IMAGE Record

An image record’s fields and their corresponding line numbers are described in
Table 38.
Table 38. Fields Present in the IMAGE Record
Record Line
Type Number Field Contents
IMAGE 1

448 DBRC Guide & Reference

Fields in an IMAGE Record
Table 38. Fields Present in the IMAGE Record (continued)
Record Line
Type Number Field Contents
2 * The asterisk (*) is printed to the left of
the record type only if the image copy
data sets that are defined in this
record are available for the first time
for future use (they have never been
used before).
CREATE | RUN= CREATE is printed if the image copy
timestamp* data set has never been used.
Otherwise, RUN is printed. RUN is
the time stamp of the start of
processing of the database image
copy utilities that used this image
copy data set. The asterisk (*)
indicates that the time stamp is part
of the key of this record.
RECORD COUNT= The number of records contained in
nnnnnnnn the image copy data set. This field is
printed only for in-use image copy
data sets; it does not apply to
nonstandard or system managed
storage image copy data sets.
USER IC This is printed for any nonstandard
image copy.
USID= n This is only listed here for a
nonstandard image copy.
3 USERDATA= cccccccc... This line is printed in this format for a
nonstandard image copy data set.
The characters following USERDATA=
comprise the character string you
kept in the record to describe the
nonstandard image copy data set.
STOP= This field contains either zeros or the
timestamp stop time of an Online Database
Image Copy utility run. This field
applies to standard image copy data
sets, but is not printed for available
image copy data sets.
ONLINE | BATCH | This field indicates the type of image
CONCUR | SMSCIC | copy. ONLINE indicates that this
SMSNOCIC image copy was produced by an
online database image copy utility.
BATCH indicates a batch image copy
from the Database Image Copy utility.
CONCUR indicates that a concurrent
image copy was run. SMSCIC
indicates that a system managed
storage image copy was run with
shared access. SMSNOCIC indicates
that an SMS image copy was run with
exclusive access.

This field applies to standard image

copy data sets, but is not printed for
available image copy data sets.

Appendix C. Sample Listings of RECONs 449

Fields in an IMAGE Record
Table 38. Fields Present in the IMAGE Record (continued)
Record Line
Type Number Field Contents
USID= n This is only listed here for a standard
image copy. This is the value of the
update set identifier of the database
or area when the image copy was
taken.
4 IN PROGRESS This line is listed when an HSSP
concurrent image copy is currently in
progress.
5 IC1 | IC2 IC1 and accompanying lines are
always printed, followed by IC2 and
accompanying lines, if a duplicate
image copy data set exists.
6 DSN= ic-dsname ic-dsname is the data set name of
this image copy data set (IC1 or IC2).
FILE SEQ= nnnn The file sequence number of the
image copy data set on the first
volume on which it resides. This field
is listed for non-HSSP image copies
only.
7 UNIT= unittype Unit type to be used for substitution
during the GENJCL process. This field
is listed for non-HSSP image copies
only.
ERR | EMP ERR is printed if you have indicated
that the image copy data set is not to
be used as input to future utility runs.
EMP is printed only for duplicate
image copy data sets that have not
been used, even though their
corresponding image copy data set
has been used.
VOLS DEF= nnnn The number of volumes that have
VOLS USED= nnnn been specified for use by this image
copy data set and the number of
volumes that have been used to
create the data set. The VOLS USED
value might be less than the specified
VOLS DEF. For available image copy
data sets, the VOLS USED value is 0.

This field is listed for non-HSSP

image copies only.
8-nn VOLSER= volser,... A list of the volume serial numbers of
volumes that contain the image copy
data set. this field is listed for
non-HSSP image copies only.

Fields Present in a REORG Record

A reorganization record’s fields and their corresponding line numbers are described
in Table 39 on page 451.

450 DBRC Guide & Reference

Fields in a REORG Record
Table 39. Fields Present in the REORG Record
Record Line
Type Number Field Contents
REORG 1
2 RUN= timestamp* The time stamp you have supplied for
the time at which a reorganization
occurred for this DBDS. An asterisk
(*) indicates that the time stamp is
part of the key of this record.
USID= n This is the value of the update set
identifier of the database or area
when the reorganization of this DBDS
occurred.

Fields Present in a RECOV Record

A recovery record’s fields and their corresponding line numbers are described in
Table 40.
Table 40. Fields Present in the RECOV Record
Record Line
Type Number Field Contents
RECOV 1
2 RUN= timestamp* The time stamp of a Database
Recovery utility run for this DBDS.
The asterisk (*) indicates that the time
stamp is part of the key of this record.
RUN USID= n Listed only if a time stamp recovery is
being described. This identifies the
update set identifier of the DBDS
when the Database Recovery utility
was run.
3 RECOV TO= timestamp This field indicates that a time stamp
recovery is being described. The time
stamp recovery restored the DBDS to
the state it was in at the time
represented by the time stamp.
RECOV TO USID= n Listed only if a time stamp recovery is
being described. This identifies the
update set identifier of the DBDS at
the time to which the DBDS was
restored.

Appendix C. Sample Listings of RECONs 451

Fields in a RECOV Record

452 DBRC Guide & Reference

Appendix D. Considering IMS DBRC RECON Data Set
Placement
This appendix consists of recommendations for the placement of the IMS DBRC
RECON data sets. Shared DASD considerations and the use of GRS (Global
Resource Serialization) are also discussed.

The RECON data sets consist of three VSAM KSDSs. These data sets can be
considered to be among the most important IMS system data sets in an installation,
since they are required to control the recovery of registered data base data sets,
and also required to control logging and system restart operations for IMS DC and
DBCTL environments. Also, since multiple IMS subsystems can share the same set
of RECONs, the loss of the RECON data sets could impact multiple IMS
subsystems.

The RECON data sets are managed with a ″pair and a spare″ concept. There are
two active KSDSs and a spare KSDS that is used when one of the active RECON
data sets is lost (DBRC automatically copies the remaining good copy to the spare
in order to maintain dual processing). In this situation the loss of one of the
RECONs in a RECON set of data sets is not a major problem. However, the
concurrent loss of both active RECON KSDSs in a RECON set of data sets
negatively impacts IMS system availability.

To avoid losing both active RECONs at the same time, it is generally recommended
that any common points of failure for a set of RECONs be eliminated. In particular,
for a given set of RECONs:
1. Place each of the RECON data sets on a separate device and string. In
addition, make sure that a control unit, channel, or director failure does not
cause the only path to multiple RECON data sets to be lost.
2. Catalog each of the RECON data sets in unique (separate) catalogs and make
sure that the catalogs are on separate devices (preferably, the same device as
the RECON data set). This ensures that a catalog failure does not cause
multiple RECONs in the RECON set of data sets to be lost.

The RECON data sets can be shared across multiple IMS systems on multiple
processors or MVS images. When an IMS subsystem accesses the RECONs,
DBRC issues reserves against the RECONs to maintain integrity. While all three
RECON data sets are not always reserved, the data sets that are reserved are
reserved in DD name (RECON1, RECON2, RECON3) sequence.

These reserves can be either hardware reserves or can be converted to software

reserves (SYSTEMS ENQs) by GRS. If hardware reserves are used, then one must
allocate the RECON data sets, in a shared DASD environment, carefully to avoid
shared DASD deadlocks or intolerable contention with other data sets that might be
on the same volumes as the RECONs. Note that hardware reserves lock out
access to the entire volume from other CPUs or MVS images.

Shared DASD hardware reserve deadlocks can be avoided by ensuring that:

1. The catalog (BCS) used for a RECON data set is on the same volume as the
RECON data set.
2. There are no catalogs (BCS) on a RECON volume that point to VSAM data sets
on another RECON volume.

3. If multiple sets of RECONs (RECON set A and RECON set B) exist and you
wish to share DASD volumes for the multiple sets (use 3 volumes rather than n
* 3 volumes), all of the RECON1 data sets from the multiple RECON sets are
on one volume, all of the RECON2 data sets are on the second volume, and all
of the RECON3 data sets are on the third volume.

Implementing the above recommendations should greatly reduce all known shared
DASD hardware reserve deadlock exposures involving the RECON data sets.

GRS can be used to convert reserve requests from hardware reserves to

SYSTEMS ENQ requests and to then propagate the SYSTEMS ENQ request to all
CPUs or MVS images in the sharing Sysplex. When this facility is used, the entire
volume is not locked out from access by other CPUs or MVS images; only the
logical resource (the particular RECON data set in the case of DBRC) is serialized.

So, in a GRS environment, the reserve requests issued by DBRC do not prevent
access from other CPUs or MVS images to other data sets that might reside on the
RECON volumes. In addition, by using the GRS conversion of RECON reserves,
you eliminate any potential DBRC reserve deadlock situations, even when the
previous recommendations are not followed.

The use of GRS is not without overhead. It takes longer for a ″software″ (GRS
converted) reserve to be processed than it takes for a hardware reserve to be
processed. The amount of elapsed time increase varies by the number of CPUs or
MVS images in the Sysplex and installation specified tuning parameters. Using an
example in MVS/ESA Planning: Global Resource Serialization for MVS/SP Version
3 the average amount of increase for a 4-processor Sysplex would vary from 7 to
12 milliseconds. Most invocations of DBRC only reserve the active pair of RECONs
(two reserves) so this time must be doubled (occasionally tripled when the spare is
also reserved). Therefore, the use of GRS to convert the DBRC RECON reserves
would typically add less than 25 milliseconds (about one random I/O) to the
duration of an IMS DBRC operation.

Since this increase is probably much less than 10 percent when compared to the
duration of an IMS DBRC operation, the potential negative performance impact of
GRS usage should not be a serious consideration for most IMS DBRC users,
especially when the positive performance impacts (entire volume no longer held)
considered. However, environments could exist where there is an extremely high
degree of contention among multiple IMS subsystems for the RECON data sets. In
these environments, the negative performance impact of GRS usage could be
noticeable.

The GRS manual (referenced earlier) should be consulted for additional information
regarding the implementation, usage, and tuning considerations for GRS.

454 DBRC Guide & Reference

Bibliography
This bibliography includes all the publications cited SC26-9434 OTMA Open Transaction Manager
in this book, including the publications in the IMS Access
library. SC26-9435 OG Operations Guide
v CICS/ESA-CICS IMS Database Control Guide GC26-9437 RPG Release Planning Guide
SC26-9438 SOP Sample Operating
v CICS/ESA-CICS Supplied Transactions
Procedures
v MVS/DFP V3R3 System Program Reference SC26-9440 URDBTM Utilities Reference: Database
Manual and Transaction Manager
v MVS/ESA System Programming Library: SC26-9441 URS Utilities Reference: System
Application Development Guide
v OS/390 MVS Planning: Global Resource Supplementary Publications
Serialization GC26-9431 LPS Licensed Program
v OS/390 MVS Programming: Authorized Specifications
Assembler Services Reference SC26-9439 SOC Summary of Operator
Commands

IMS Version 7 Library

Online Softcopy Publications
LK3T-3526 CDROM IMS Version 7 Softcopy Library
SC26-9419 ADB Administration Guide: SK2T-0730 CDROM IBM Online Library: Transaction
Database Manager Processing and Data
SC26-9420 AS Administration Guide: System SK2T-6700 CDROM OS/390 Collection
SC26-9421 ATM Administration Guide:
Transaction Manager
SC26-9422 APDB Application Programming:
Database Manager
SC26-9423 APDG Application Programming:
Design Guide
SC26-9424 APCICS Application Programming:
EXEC DLI Commands for
CICS and IMS
SC26-9425 APTM Application Programming:
Transaction Manager
SC26-9427 CG Customization Guide
SC26-9426 CQS Common Queue Server and
Base Primitive Environment
Guide and Reference
SC26-9436 CR Command Reference
SC26-9428 DBRC DBRC Guide and Reference
LY37-3738 DGR Diagnosis Guide and
Reference
LY37-3739 FAST Failure Analysis Structure
Tables (FAST) for Dump
Analysis
SC27-0832 IJUG IMS Java User’s Guide
GC26-9429 IIV Installation Volume 1:
Installation and Verification
GC26-9430 ISDT Installation Volume 2:
System Definition and
Tailoring
SC26-9432 MIG Master Index and Glossary
GC26-9433 MC1 Messages and Codes
GC26-1120 MC2 Messages and Codes,
Volume 2

456 DBRC Guide & Reference
Index
Special Characters %ICVOLS4 keyword 354
%LOGDSN keyword 324
%ALLDSSN keyword 328
%LOGETIM keyword 324
%ALLSEL keyword 328
%LOGFRID keyword 324
%ALLTIME keyword 328
%LOGFSEQ keyword 324
%ALLUSID keyword 328
%LOGLRID keyword 325
%CADSN keyword 327
%LOGMERG keyword 324
%CAFSEQ keyword 327
%LOGONL keyword 324
%CALGTM keyword 327
%LOGRMT keyword 324
%CAODSN keyword 318
%LOGSEL keyword 324
%CASEL keyword 327
%LOGSTIM keyword 324
%CATIME keyword 327
%LOGUNIT keyword 324
%CAUNIT keyword 327
%LOGVOLS keyword 324
%CAVCNT keyword 327
%OLDCTIM keyword 321
%CAVOLS keyword 327
%OLDFRID keyword 321
%COPIES keyword 354
%OLDLRID keyword 321
%DALTIME keyword 328
%OLDOTIM keyword 321
%DBADSAV keyword 329
%OLDSDDN keyword 320
%DBADSN keyword 329
%OLDSDSN keyword 320
%DBDDN keyword 328, 329
%OLDSSEL keyword 321
%DBDSN keyword 329
%OLDSTYP keyword 321
%DBDSNRV keyword 329
%PLGTIME keyword 328
%DBDSSEL keyword 329
%SELECT keyword 321
%DBNAME keyword 328, 329
description 314
%DBTYPE keyword 329
specifying the record types 315
%DBUSID keyword 329
specifying the syntax 320, 329
%DDNAME keyword 315
%SET MEMBER keyword 313, 318
%DELETE keyword 313, 317
%SET TIMEFMT keyword 313, 318
%ENDDEL keyword 313, 317
%SLDETIM keyword 322
%ENDSEL keyword 313, 314
%SLDFRID keyword 322
%IC2DSN keyword 326
%SLDFSEQ keyword 322
%IC2FSEQ keyword 326
%SLDLRID keyword 322
%IC2SEL keyword 326
%SLDRMT keyword 322
%IC2UNIT keyword 326
%SLDSDDN keyword 322
%IC2VCNT keyword 326
%SLDSSEL keyword 322
%IC2VOLS keyword 326
%SLDSTIM keyword 322
%ICCAT keyword 326
%SLDUNIT keyword 322
%ICDSN keyword 325
%SLDVOLS keyword 322
%ICDSN2 keyword 354
%SSID keyword 312
%ICDSN3 keyword 354
%TIME keyword 312
%ICDSN4 keyword 354
/DBDUMP command 27
%ICFSEQ keyword 325
/GENJCL command, generating JCL 9
%ICSEL keyword 325
/NRESTART command
%ICSTOP keyword 325
INIT.DB 225
%ICTIME keyword 325
restart after IMS failure 42
%ICTYPE keyword 325
/REPRO command
%ICUNIT keyword 325
restoring RECONs 68
%ICUNIT2 keyword 354
using for backup 64
%ICUNIT3 keyword 354
/RMGENJCL command
%ICUNIT4 keyword 354
generating JCL 9
%ICUSID keyword 326
/RMxxxxxx command
%ICVCNT keyword 326
syntax diagram 110
%ICVCNT2 keyword 354
/START command
%ICVCNT3 keyword 354
use of 20, 212
%ICVCNT4 keyword 354
%ICVOLS keyword 326
%ICVOLS2 keyword 354
%ICVOLS3 keyword 354

A analyzing requirements for data sharing, assigning a
sharing level with DBRC 20
ABNORMAL parameter commands
ARCHIVE, GENJCL
CHANGE.SUBSYS 168
archiving OLDS 13
NOTIFY.SUBSYS 299
ARCHIVED parameter
access method services (AMS) 64, 68
CHANGE.PRILOG (for OLDS) command 137
ACTIVE parameter
archiving
CHANGE.DB command 125
online log data sets, DBRC 13
ADD parameter
ARCHJCL skeletal JCL execution member 340
CHANGE.CAGRP command 118
AREA parameter
ADDDB parameter
commands
CHANGE.DBDSGRP command 133
CHANGE.ADS 113
ADDEQE parameter
CHANGE.DBDS 127
CHANGE.DBDS command 127
CHANGE.IC 135
adding information to the RECON
CHANGE.UIC 170
allocation or deallocation 263
DELETE.ADS 171
backout records 264
DELETE.ALLOC 172
Database Change Accumulation utility 265
DELETE.DBDS 175
database data set or area recovery 283
DELETE.IC 177
database reorganization 285
DELETE.RECOV 181
image copy 268
DELETE.UIC 184
nonstandard image copy data sets 299
GENJCL.IC 197
primary online log data set 271
GENJCL.OIC 204
primary recovery log data set 274
GENJCL.RECEIVE 208
primary system log data set 279
GENJCL.RECOV 212
secondary online log data set 288
INIT.ADS 221
secondary recovery log data set 291
INIT.DBDS 227
secondary system log data set 294
INIT.IC 234
subsystem 298
LIST.DBDS 249
tracking subsystem log data set 279
LIST.HISTORY 253
ADDMEM parameter
NOTIFY.ALLOC 263
CHANGE.DBDSGRP command 133
NOTIFY.IC 269
ADDN parameter commands
NOTIFY.RECOV 283
CHANGE.ADS 113
NOTIFY.UIC 300
DELETE.ADS 171
defining a data set 221
INIT.ADS 221
deleting information from RECON 171
NOTIFY.RECOV 283
AREANEW parameter
ADDNNEW parameter
CHANGE.DBDS command 128
CHANGE.ADS command 113
ARNEEDED parameter
ADSN parameter commands
CHANGE.PRILOG (for OLDS) command 137
CHANGE.ADS 113
ARSCHED parameter
INIT.ADS 221
CHANGE.PRILOG (for OLDS) command 137
ALL parameter
ARSTART parameter
commands
CHANGE.PRILOG (for OLDS) command 137
CHANGE.DB 121
assigning a sharing level with DBRC 20
CHANGE.SUBSYS 168
authorization, changing database 86
GENJCL.ARCHIVE 185
authorization commands
LIST.BKOUT 245
CHANGE.DB 121, 122
LIST.CAGRP 246
CHANGE.DBDS 126, 128
LIST.DB 247
AVAIL parameter commands
LIST.DBDSGRP 250
CHANGE.ADS 113
LIST.SUBSYS 260
CHANGE.PRILOG (for OLDS) 137
description 121
CHANGE.SECLOG (for OLDS) 156, 157
allocation
INIT.ADS 221
changes to processing 19
database record 63
DBRC RECONs 45
log record 63
B
ALLTIME parameter BACKIRLM parameter commands
NOTIFY.ALLOC command 263 CHANGE.SUBSYS 168
AMS 64, 68 NOTIFY.SUBSYS 298
backout, BACKOUT record for recovery 58

458 DBRC Guide & Reference

backout, with data sharing change accumulation
batch 40 data set
dynamic 40 defining 222
BACKOUT parameter naming convention 22
CHANGE.DB command 122 selecting 326
backup group
creating a copy of RECON 111 changing information in the RECON 118
database 25 defining 37, 223
command for 26 defining for future use 37
description 25 deleting information from RECON 174
RECON 64 listing 245
BACKUP.RECON command 64 reusing 37
description 111 using 18
example 111 record
parameters group 58
BOTH 111 run 58
RECON1 111 stops processing logs, when 86
RECON2 111 change accumulation says nothing to process,
batch backout utility 40, 43 when 86
adding backout records to RECON 264 change accumulation stops processing logs, when 86
changing backout records in RECON 114 CHANGE.ADS command 113
deleting from RECON 172 CHANGE.BKOUT command 114
limitations 41 CHANGE.CA command 116
SSID naming convention 85 CHANGE.CAGRP command 118
batch environment CHANGE.DB command 121
command CHANGE.DBDS command 126
LIST.SUBSYS 260 CHANGE.DBDSGRP 18
NOTIFY.SUBSYS 299 CHANGE.DBDSGRP command 132
NOTIFY.SUBSYS command 298 CHANGE.IC command 134
BKO (backout) parameter commands CHANGE.PRILOG 14
CHANGE.BKOUT 115 CHANGE.PRILOG command
NOTIFY.BKOUT 265 changing RECON log control records 13
BOTH parameter for OLDS 137
BACKUP.RECON command 111 for RLDS 139
for SLDS 143
for TSLDS 143
C CHANGE.RECON command 14, 148
CADSN parameter commands allocating space for RECONs 50
CHANGE.CA 116 recovering RECONs 68
INIT.CA 222 reorganizing RECON 66
NOTIFY.CA 266 CHANGE.RECON command (for THT or
CAJCL parameter REPTHT) 156
commands CHANGE.SECLOG command 14
CHANGE.CAGRP 118 changing RECON log control records 13
INIT.CAGRP 224 for OLDS 156
skeletal JCL execution member 346 for RLDS 158
calls from IMS to DBRC, elements of DBRC 6 for SLDS 162
catalog management of data sets in RECON 89 for TSLDS 162
CATDS parameter commands CHANGE.SG command 167
CHANGE.RECON 148 CHANGE.SUBSYS command 168
INIT.RECON 239 CHANGE.UIC command 170
category of records changes in allocation and deallocation 19
listing records 255 changing information
CATIME parameter area data set 113
GENJCL.CA command 191 backout records 114
CFSTR1 parameter CHANGE.DBDS command 127, CA group record 118
230 database 121
CFSTR2 parameter CHANGE.DBDS command 128, database change accumulation utility 116
230 DBDS 126
DBDSGRP 132
IC data set 134

Index 459
changing information (continued) command 110 (continued)
nonstandard image copy data set 170 GENMAX 17
primary online log data set 137 INIT.ADS 12
primary RLDS 139 INIT.CAGRP 17
primary SLDS 143 INIT.DB 12
primary TSLDS 143 INIT.DBDS 12, 17
RECON header record 148 INIT.RECON 46
RECON header record (for THT or REPTHT) 156 INIT.RECON, establishing RECONs for log
secondary online log data set 156 control 11
secondary RLDS 158 INIT.RECON, recovering RECONs 68
secondary SLDS and TSLDS 162 NOTIFY.UIC 17
secondary subsystem entry 168 valid DBRC log related commands 14
service group 167 command syntax 110
CHECK17 parameter commands comment 100
CHANGE.RECON 150 continuation characters 100
INIT.RECON 240 DBRC 99
CHECK44 parameter commands definition 100
CHANGE.RECON 150 description for DBRC utility 99
INIT.RECON 240 notational conventions 107
CHKINT parameter GENJCL.OIC command 204 parameters 100
CHKPTCT parameter commands separators 100
CHANGE.PRILOG (for RLDS) 140 COMP parameter commands
CHANGE.PRILOG (for SLDS) 144 CHANGE.CA 117
CHANGE.SECLOG (for RLDS) 159 NOTIFY.CA 267
CHANGE.SECLOG (for SLDS) 163 complex expressions 317
NOTIFY.PRILOG (for RLDS) 276 compression
NOTIFY.PRILOG (for SLDS and TSLDS) 280 PRILOG 65, 82
NOTIFY.SECLOG (for RLDS) 292 concurrent image copy (CIC)
NOTIFY.SECLOG (for SLDS) 296 CIC parameter 197
CIC (concurrent image copy) 197 database backup copies 28
CIC parameter registered database with DBRC 17
commands considerations
GENJCL.IC 197 when using DBRC 12
NOTIFY.IC 269 contention, avoiding RECON 46
for online image copy 28 control group, skeletal JCL 313
CIC parameter, commands control keywords, skeletal JCL 313, 329
GENJCL.IC 197 CONTROLINTERVALSIZE keyword 50
NOTIFY.IC 269 COPIES parameter commands
cold start GENJCL.IC 197
commands GENJCL.OIC 204
CHANGE.BKOUT 114 coupling facility structures (CFSTR1 | 2) 230
DELETE.BKOUT 172 CURRENT parameter commands
LIST.BKOUT 245 NOTIFY.RECOV 283
multiple in a test environment 90 NOTIFY.REORG 286
command 110 NOTIFY.UIC 300
/DBDUMP database backup copies 27 CYLINDERS keyword 50
/ERESTART
restart after DBRC failure 42
restart after IMS failure 42 D
/GENJCL 9 damaged RECON 67
/NRESTART, restart after IMS failure 42 DASDUNIT parameter commands
/REPRO 64, 68 CHANGE.RECON 149
/RMGENJCL 9 INIT.RECON 240
/START 20, 212 data set allocation, DBRC RECON
BACKUP.RECON 64 creating a RECON 50
CHANGE.PRILOG 13 shared among multiple processors 47
CHANGE.RECON 50 data set reorganization, RECON, to increase max.
CHANGE.RECON, recovering RECONs 68 RECORDSIZE 87
CHANGE.SECLOG 13 data sets, RECON 45
DELETE.LOG 66 data sharing 20
GENJCL.ARCHIVE 13, 14 assigning a sharing level with DBRC 20

460 DBRC Guide & Reference

data sharing 20 (continued) Database Change Accumulation utility (DFSUCUM0)
batch backout 40 (continued)
dynamic backout 40 commands (continued)
forward recovery 41 DELETE.DBDSGRP 175
information in RECON 20 DELETE.GSG 176
levels of 20 DELETE.IC 177
block level 20 DELETE.LOG (for OLDS) 177
database level 20 DELETE.LOG (for RLDS) 178
merging logs 37 DELETE.LOG (for SLDS) 178
planning recovery procedures 39 DELETE.RECOV 181
record 64 DELETE.REORG 182
database DELETE.SG 182
adding information to RECON 285 DELETE.SUBSYS 183
allocation record 63 DELETE.UIC 184
authorization, changing 86 GENJCL.ARCHIVE 185
backup 25, 33 GENJCL.CA 189
commands for 26 GENJCL.CLOSE 193
changing information 121 GENJCL.IC 195
data set, changing information 126 GENJCL.OIC 202
data set groups, changing information 132 GENJCL.RECEIVE 207
defining 225 GENJCL.RECOV 211
deleting information from RECON 174 GENJCL.USER 216
listing 247 INIT.ADS 221
making HISAM copies 31 INIT.CA 222
making image copies 26 INIT.CAGRP 223
open exit 19 INIT.DB 225
record 59 INIT.DBDS 227
database allocation record 63 INIT.DBDSGRP 231
Database Change Accumulation utility 33 INIT.GSG 233
Database Change Accumulation utility (DFSUCUM0) INIT.IC 233
CA group INIT.RECON 239
defining 37 INIT.SG 243
defining for future use 37 LIST.BKOUT 245
reusing 37 LIST.CAGRP 245
commands LIST.DB 247
BACKUP.RECON 111 LIST.DBDS 248
CHANGE.ADS 113 LIST.DBDSGRP 250
CHANGE.BKOUT 114 LIST.GSG 251
CHANGE.CA 116 LIST.HISTORY 252
CHANGE.CAGRP 118 LIST.LOG (for a category of records) 255
CHANGE.DBDSGRP 132 LIST.LOG (for a PRILOG family) 254
CHANGE.IC 134 LIST.RECON 258
CHANGE.PRILOG (for OLDS) 137 NOTIFY.ALLOC 263
CHANGE.PRILOG (for RLDS) 139 NOTIFY.BKOUT 264
CHANGE.PRILOG (for SLDS) 143 NOTIFY.CA 265
CHANGE.PRILOG (for TSLDS) 143 NOTIFY.IC 268
CHANGE.RECON 148 NOTIFY.PRILOG (for OLDS) 271
CHANGE.RECON (for THT or REPTHT) 156 NOTIFY.PRILOG (for RLDS) 274
CHANGE.SECLOG (for OLDS) 156 NOTIFY.PRILOG (for SLDS and TSLDS) 279
CHANGE.SECLOG (for RLDS) 158 NOTIFY.RECOV 283
CHANGE.SECLOG (for SLDS and TSLDS) 162 NOTIFY.REORG 285
CHANGE.SG 167 NOTIFY.SECLOG (for OLDS) 288
CHANGE.SUBSYS 168 NOTIFY.SECLOG (for RLDS) 291
CHANGE.UIC 170 NOTIFY.SECLOG (for SLDS) 294
DELETE.ADS 171 NOTIFY.UIC 299
DELETE.ALLOC 171 RESET.GSG 303
DELETE.BKOUT 172 description 33
DELETE.CA 173 execution recorded by DBRC 17
DELETE.CAGRP 174 input 36
DELETE.DB 174 subset of log volumes 36
DELETE.DBDS 175 valid log subset with DBRC 37

Index 461
database change accumulation utility JCL DBD parameter commands (continued)
adding information to RECON 265 INIT.DBDS 227
changing information about a run 116 INIT.IC 234
deleting information from RECON 173 LIST.DB 247
generating a job 189 LIST.DBDS 248
skeletal JCL 346 LIST.HISTORY 252
database data set record 59 NOTIFY.ALLOC 263
Database Image Copy 2 utility (DFSUDMT0) 17, 27 NOTIFY.BKOUT 265
Database Image Copy utility (DFSUDMP0) 27 NOTIFY.IC 268
adding information to RECON 268 NOTIFY.RECOV 283
creating data sets for future use 29 NOTIFY.REORG 286
description 26 NOTIFY.UIC 300
execution recorded by DBRC 17 DBDS (database data set)
generating a job 195 commands 212
maximum number of generations 30 GENJCL.RECOV 212
nonstandard image copy data sets 32 LIST.DB 248
recovery period 30 NOTIFY.RECOV 284
reusing image copy data sets 30 defining 227
skeletal JCL 351 listing 248
database recovery control qualifier 316
changing information 134 RECON, deleting information from 175, 177
data set, creating a backup copy 111 selecting DBDS records 327, 328
Database Recovery Control utility (DSPURX00) DBDS (database data set) group
generating a job 211, 216 defining 231
GENJCL.RECOV command 211 deleting information from RECON 175
overview 75 LIST command 250
database recovery records 57 record 59
database recovery with data sharing using 18
batch 40 DBDS, INIT command
data sharing 42 defining databases 12
dynamic 40 DBDS, INIT.DBDS command
forward 41 specifying image copy requirements 17
managing system logs 37 DBRC (Database Recovery Control) 75
DB, INIT command active and spare RECON 54
defining databases 12 assigning a sharing level 20
DB header record authorization, changing database 86
HALDB 60 calls from IMS 6
DB partition catalog management of data sets 89
HALDB 61 change accumulation says nothing to process,
DBD parameter commands when 86
CHANGE.ADS 113 change accumulation stops processing logs,
CHANGE.BKOUT 115 when 86
CHANGE.DB 121 closing an open online PRILOG 83
CHANGE.DBDS 127 commands 99
CHANGE.IC 135 INIT.CA 37
CHANGE.UIC 170 INIT.CAGRP 37
DELETE.ADS 171 components 6
DELETE.ALLOC 172 controlling database recovery 14, 15, 23
DELETE.DB 174 data sets
DELETE.DBDS 175 defining recovery requirements 14
DELETE.IC 177 partitioned 7
DELETE.RECOV 181 RECON 6, 45, 65
DELETE.REORG 182 SSYS record 64
DELETE.UIC 184 database backup 25
GENJCL.IC 197 Concurrent Image Copy 28
GENJCL.OIC 203 controlling the number of image copies
GENJCL.RECEIVE 208 managed 29
GENJCL.RECOV 212 creating image copy data sets for future use 29
GENJCL.USER 217 Database Image Copy (DFSUDMP0) 27
INIT.ADS 221 Database Image Copy 2 (DFSUDMT0) 27
INIT.DB 225 guidelines 32

462 DBRC Guide & Reference

DBRC (Database Recovery Control) 75 (continued) DBTRACK parameter
HISAM copies 31 CHANGE.DB command 123
methods 25 CHANGE.DBDS command 131
Online Database Image Copy (DFSUICP0) 28 DDN parameter commands
recovering a database 38 CHANGE.DBDS 127
recovery period of image copy data sets and CHANGE.IC 135
GENMAX 30 CHANGE.UIC 170
reusing image copy data sets 30 DELETE.ALLOC 172
DBRC components 6 DELETE.DBDS 175
DBRC log control 13 DELETE.IC 177
DBRC online command syntax 110 DELETE.RECOV 181
DBRC parameter DELETE.REORG 182
IMSCTRL macro 10 DELETE.UIC 184
DBRC procedure 11 GENJCL.IC 197
description 13 GENJCL.OIC 204
generating JCL 8 GENJCL.RECEIVE 208
GENMAX, resetting 80 GENJCL.RECOV 212
IMS procedures and 11 GENJCL.USER 218
initial RECON access 54 INIT.DBDS 227
initialization 10 INIT.IC 234
initializing the RECON 11 LIST.DBDS 249
log control 13 LIST.HISTORY 253
log data sets 50 NOTIFY.ALLOC 263
log records, deleting 84 NOTIFY.IC 269
maintaining RECON records 65 NOTIFY.RECOV 283
notifying that log data sets have moved 87 NOTIFY.REORG 286
overview 5 NOTIFY.UIC 300
parameters DDNNEW parameter
IMS.PROCLIB execution parameter 11 CHANGE.DBDS command 128
partitioned data set members 7 deadlock, avoiding RECON 47
RECON deallocation, changes to processing 19
creating a RECON 50 DEALTIME parameter command NOTIFY.ALLOC 263
shared among multiple processors 47 DEDB Fast Path record 61
RECON, defining recovery requirements 14 default members 310
RECON, registering databases in 12 DEFAULTS parameter commands
recording change accumulations 17 GENJCL.ARCHIVE 186
recording image copies 17 GENJCL.CA 189
Recovery Control utility 7 GENJCL.CLOSE 193
recovery-related information 7 GENJCL.IC 198
recording 8 GENJCL.OIC 204
recovery utilities 7 GENJCL.RECEIVE 208
share control 20 GENJCL.RECOV 212
SLDS stop time, locating the last in RECON 79 GENJCL.USER 218
specifying when it is to be used 10 DEFINE CLUSTER keywords 50
subsystem (SSYS) records 84 DEFLTJCL parameter
system, considerations for a 25 CHANGE.CAGRP 119
tailoring JCL 14 CHANGE.DBDS 128
time stamp 101 INIT.CAGRP 224
tips 79 INIT.DBDS 228
using DBRC with batch jobs 10 DELEQE parameter CHANGE.DBDS command 127
variables 50 DELETE.ADS command 171
what is it 5 DELETE.ALLOC command 171
when should you use it 10 DELETE.BKOUT command 172
DBRC (Database Recovery Control) commands DELETE.CA command 173
Database Recovery Control utility (DSPURX00) 7 DELETE.CAGRP command 174
RECON Upgrade utility (DSPURU00) 7 DELETE.DB command 174
DBRC online DELETE.DBDS 18
/RMGENJCL command syntax 110 DELETE.DBDS command 175
/RMINIT command 110 DELETE.DBDSGRP 18
/RMNOTIFY 110 DELETE.DBDSGRP command 175
delete group 313

Index 463
DELETE.GSG command 176 DSN commands
DELETE.IC command 177 CHANGE.DBDS 129
DELETE.LOG 14 CHANGE.PRILOG (for OLDS) 138
DELETE.LOG (for OLDS) command 177 CHANGE.PRILOG (for RLDS) 140
DELETE.LOG (for RLDS) command 178 CHANGE.PRILOG (for SLDS) 144
DELETE.LOG (for SLDS) command 178 CHANGE.SECLOG (for OLDS) 157
delete log records, how to 84 CHANGE.SECLOG (for SLDS) 163
DELETE parameter commands INIT.DBDS 227
CHANGE.BKOUT 114 NOTIFY.PRILOG (for OLDS) 271
CHANGE.CAGRP 118 NOTIFY.PRILOG (for RLDS) 275
DELETE.RECOV command 181 NOTIFY.PRILOG (for SLDS) 280
DELETE.REORG command 182 NOTIFY.PRILOG (for TSLDS) 280
DELETE.SG command 182 NOTIFY.SECLOG (for OLDS) 288
DELETE.SUBSYS command 183 NOTIFY.SECLOG (for RLDS) 291
DELETE.UIC command 184 NOTIFY.SECLOG (for SLDS) 295
deleting a SSYS record 85 DSPDBHRC 60
deleting information partition DB record
all change accumulation group records 174 HALDB 61
all database data set records 175 DSPDSHRC
all database records 174 partition DBDS records
allocation record of database data set 171 HALDB 61
area data set 171 DSPPTNRC
backout record 172 HALDB partition record
change accumulation run record 173 HALDB 61
database data set group records 175 DSPURU00 (RECON Upgrade utility) 71
global service group records 176 DSPURX00 (Database Recovery Control utility) 75
image copy data set records 177 DSSN parameter NOTIFY.ALLOC command 264
log records 84 DSSTART parameter commands
nonstandard image copy data sets 184 CHANGE.PRILOG (for RLDS) 140
online log data set records 177 CHANGE.PRILOG (for SLDS) 145
recovery log data set records 178 CHANGE.SECLOG (for RLDS) 159
recovery run record 181 CHANGE.SECLOG (for SLDS) 164
reorganization records 182 DUAL parameter CHANGE.RECON command 149
service group records 182 dump format 28
subsystem records 183 dynamic allocation 49
system log data set records 178 of RECON 49
deleting unnecessary RECON records 66 dynamic backout with data sharing 40
DELMEM parameter, CHANGE.DBDSGRP
command 133
DFSUARC0 (Log Archive utility) E
description 13 ENDRECOV parameter commands
DFSUCUM0 (Database Change Accumulation CHANGE.SUBSYS 169
utility) 333 NOTIFY.SUBSYS 299
CA group enqueue problems, causes of RECON 91
defining 37 error, RECON I/O 67
defining for future use 37 execution members 8
reusing 37 exit
description 33 database open 19
execution recorded by DBRC 17 RECON I/O 8
input 36
subset of log volumes 36
DFSUDMP0 (Database Image Copy utility) 335 F
DFSUICP0 (Online Database Image Copy utility) 335 failure and restart with data sharing 39
creating data sets for future use 29 Fast Path
description 26 registering databases and DEDB areas 20
execution recorded by DBRC 17 Fast Path DEDB record 61
DFSULTR0 (Log Recovery utility) FILESEQ parameter commands
generating a job 193 CHANGE.CA 116
DFSURUL0 (HISAM Reorganization Unload utility) CHANGE.IC 135
for backup 31 CHANGE.PRILOG (for RLDS) 141
discarded RECON, replacing 69 CHANGE.PRILOG (for SLDS) 145

464 DBRC Guide & Reference

FILESEQ parameter commands (continued) GENJCL.RECOV command 211
CHANGE.SECLOG (for RLDS) 160 GENJCL.USER 18
CHANGE.SECLOG (for SLDS) 164 GENJCL.USER command 216
INIT.CA 222 GENMAX parameter
INIT.IC 234 image copy data sets for future use 29
NOTIFY.CA 266 of the INIT.DBDS command 228
NOTIFY.IC 269 resetting 80
NOTIFY.PRILOG (for RLDS) 276 specifying image copy requirements 17
NOTIFY.PRILOG (for SLDS and TSLDS) 281 global service group
NOTIFY.REORG 286 deleting information 176
NOTIFY.SECLOG (for RLDS) 292 listing 251
NOTIFY.SECLOG (for SLDS or TSLDS) 296 record 62
FILESEQ2 parameter commands resetting 303
CHANGE.IC 135 GROUP parameter commands 197
INIT.IC 234 GENJCL.IC 197
NOTIFY.IC 269 GENJCL.OIC 203
NOTIFY.REORG 286 GENJCL.RECEIVE 208
FORCER parameter commands GENJCL.RECOV 212
CHANGE.RECON 149 GENJCL.USER 217
INIT.RECON 240 LIST.DBDS 248
forward recovery with data sharing 41 LIST.HISTORY 252
FPAREA parameter, GENJCL.RECOV command 212 GRPMAX parameter commands
FREESPACE keyword 50 CHANGE.CAGRP 119
FROMTIME parameter commands INIT.CAGRP 223
LIST.HISTORY 253 GRPMEM parameter INIT.CAGRP command 223
LIST.LOG 257 GRPNAME parameter commands
functions of DBRC CHANGE.CA 116
data sharing 13 CHANGE.CAGRP 118
database recovery 13 CHANGE.DBDSGRP 133
logs 13 DELETE.CA 173
DELETE.CAGRP 174
DELETE.DBDSGRP 176
G GENJCL.CA 189
GAP parameter, CHANGE.PRILOG (for RLDS) 141, INIT.CA 222
142 INIT.CAGRP 224
Generalized Trace Facility (GTF) USR records 153 INIT.DBDSGRP 232
generating a job LIST.CAGRP 246
Change Accumulation utility 189 LIST.DBDSGRP 250
Database Image Copy utility 195 NOTIFY.CA 266
Database Recovery utility 211, 216 GSG parameter commands
Log Archive utility 185 CHANGE.PRILOG (for RLDS) 141
Log Recovery utility 193 CHANGE.PRILOG (for SLDS) 145
Online Database Image Copy utility 202 CHANGE.SECLOG (for RLDS) 160
generating JCL 309 CHANGE.SECLOG (for SLDS) 164
generating user output 309 GSGNAME parameter commands
GENJCL CHANGE.DB 122
log control requirements in RECON 14 CHANGE.DBDS command 129
GENJCL.ARCHIVE 14 GTF (Generalized Trace Facility) USR records 153
GENJCL.ARCHIVE command
syntax 185
GENJCL.CA command 189 H
GENJCL.CLOSE 14 HALDB
GENJCL.CLOSE command 193 master (DSPDBHRC)
GENJCL commands, description 309 DB header record 60
GENJCL.IC 18, 26 partition 61
GENJCL.IC command 195 partition DB record (DSPDBHRC) 61
GENJCL.OIC 18, 26 partition DBDS records (DSPDSHRC) 61
GENJCL.OIC command 202 partition record (DSPPTNRC)
GENJCL.RECEIVE 18 PHDAM 61
GENJCL.RECEIVE command 207 types of DBDSs 61
GENJCL.RECOV 18 header record, RECON 56

Index 465
hints and tips IMS.ADFSISRC 9
using DBRC 79 IMS.PROCLIB 9
adjusting GENMAX when it is reached or is too IMS recovery utilities 15
high 80 IMSCTRL macro
locating the last SLDS Stop Time in RECON 79 archiving OLDS 13
PRILOG compression not working 82 parameters 10
PRILOG record sizes 82 INACTIVE parameter DELETE.LOG (for RLDS and
HISAM Reorganization Unload utility (DFSURUL0) SLDS) command 179
for backup 31 Index/ILDS Rebuild Utility (DFSPREC0) 15
HISTORY command 252 INDEXED keyword 50
HSSP data set 17 INIT.ADS command 12
database registered with DBRC 17 description 221
INIT.CA command 222
INIT.CAGRP command 223
I INIT.DB command
ICDSN parameter commands description 225
CHANGE.IC 135 INIT.DBDS command
creating for future use 29 description 227
defining 233 REUSE keyword 17
duplicate, naming convention 22 INIT.DBDSGRP command 18, 231
INIT.IC 234 INIT.GSG command 233
maximum number of generations 30 INIT.IC command 233
naming convention 21 INIT.RECON command 14
nonstandard 32 description 239
NOTIFY.IC 269 initializing the RECON 46
NOTIFY.REORG 287 recovering RECONs 68
RECON INIT.SG command 243
adding information 283 initialize
changing information 134 area data set 221
record 62 change accumulation data set 222
recovery period 30 change accumulation group 223
reusing 30 database 225
selecting 325 database data set 227
ICDSN2 parameter commands database data set groups 231
CHANGE.IC 135 global service group 233
DELETE.IC 177 image copy data sets 233
INIT.IC 234 RECON header records 239
NOTIFY.IC 269 service group 243
NOTIFY.REORG 287 initializing DBRC
ICJCL parameter DBRC procedure 11
commands IMSCTRL Macro 10
CHANGE.DBDS 129 initializing RECON 11
GENJCL.CA 189 input/output error processing 67
GENJCL.CLOSE 193 INTERIM parameter commands
GENJCL.IC 198 DELETE.LOG (for OLDS) 178
GENJCL.OIC 204 DELETE.LOG (for RLDS and SLDS) 180
GENJCL.RECEIVE 209 NOTIFY.PRILOG (for OLDS) 272
GENJCL.RECOV 213 NOTIFY.PRILOG (for RLDS) 276
GENJCL.USER 218 NOTIFY.PRILOG (for SLDS and TSLDS) 281
INIT.DBDS 228 NOTIFY.SECLOG (for OLDS) 289
skeletal JCL execution member 351 NOTIFY.SECLOG (for RLDS) 293
ICOFF parameter CHANGE.DBDS command 129 NOTIFY.SECLOG (for SLDS or TSLDS) 297
ICON parameter CHANGE.DBDS command 129 INVALID parameter commands
ICRCVJCL parameter skeletal JCL execution CHANGE.CA 116
member 356 CHANGE.IC 135
ILDS (Indirect List Data Set) 18 INVALID2 parameter
Index/ILDS Rebuild Utility (DFSPREC0) 15 CHANGE.IC command 136
image copy 2 JCL 351 description 136
image copy data set IRLM (Internal Resource Lock Manager)
recovery period 30 with batch backout 40
Image Copy Group record 62

466 DBRC Guide & Reference

IRLMID parameter commands keyword (continued)
CHANGE.SUBSYS 168 NAME 50
NOTIFY.SUBSYS 299 NOERASE 50
NOREUSE 50
RECORDSIZE 51
J SHAREOPTIONS 51
JCL (job control language) SPANNED 51
generated by DBRC 8 SPEED 51
generating 309 substitution 311
skeletal execution members explained 8 UNIQUE 51
tailoring for utilities 14 UNORDERED 51
JCL allocation 49 VOLUMES 51
JCLOUT parameter keywords, symbolic 309
command GENJCL.ARCHIVE 186
skeletal JCL 310
JCLPDS parameter L
commands 186 level of sharing definitions 20
GENJCL.ARCHIVE 186 LIST.BKOUT command 245
GENJCL.CA 190 LIST.CAGRP command 245
GENJCL.CLOSE 193 LIST.DB command 247
GENJCL.IC 198 LIST.DBDS 18
GENJCL.OIC 204 LIST.DBDS command 248
GENJCL.RECEIVE 209 LIST.DBDSGRP 18
GENJCL.RECOV 213 LIST.DBDSGRP command 250
GENJCL.USER 218 LIST.GSG command 251
skeletal JCL 310 LIST.HISTORY 18
JOB parameter commands LIST.HISTORY command 252
GENJCL.ARCHIVE 186 LIST.LOG 14
GENJCL.CA 190 LIST.LOG (for a category of records) command 255
GENJCL.CLOSE 193 LIST.LOG (for a PRILOG family) command 254
GENJCL.IC 198 LIST parameter commands
GENJCL.OIC 205 GENJCL.ARCHIVE 186
GENJCL.RECEIVE 209 GENJCL.CA 190
GENJCL.RECOV 213 GENJCL.CLOSE 194
GENJCL.USER 218 GENJCL.IC 199
JOBJCL GENJCL.OIC 205
skeletal JCL execution member 9, 340 GENJCL.RECEIVE 209
GENJCL.RECOV 213
GENJCL.USER 218
K LIST.RECON command
KEYS keyword 50 description 258
keyword fields displayed by command 417
%IC 354 sample listing 367
%ICDSN2 354 LIST.SUBSYS command 260
%ICDSN3 354 listing
%ICDSN4 354 backout records 245
%ICUNIT2 354 category of records 255
%ICUNIT3 354 change accumulation group 245
%ICUNIT4 354 database 247
%ICVCNT2 354 database data set 248
%ICVCNT3 354 database groups 250
%ICVCNT4 354 database histories 252
%ICVOLS2 354 global service group 251
%ICVOLS3 354 PRILOG family 254
%ICVOLS4 354 RECON 258, 367
CONTROLINTERVALSIZE 50 subsystem 260
CYLINDERS 50 LKASID parameter
DEFINE CLUSTER 50 CHANGE.DBDS command 130
FREESPACE 50 INIT.DBDS command 230
INDEXED 50 Local Shared Resources (LSR) option 50
KEYS 50 log allocation record 63

Index 467
Log Archive utility (DFSUARC0) naming conventions (continued)
description 13 SSIDs in RECON SSYS records, for 84
log control SSIDs processed by batch backout, for 85
valid commands 14 NEWTIME parameter commands
log data sets, records 56, 57 CHANGE.PRILOG (for RLDS) 141
log records, deleting 84 CHANGE.PRILOG (for SLDS) 145
Log Recovery utility (DFSULTR0) CHANGE.SECLOG (for RLDS) 160
generating a job 193 CHANGE.SECLOG (for SLDS) 164
log volumes, specifying NEWVOL parameter commands
a subset 36 CHANGE.PRILOG (for RLDS) 141
all 36 CHANGE.PRILOG (for SLDS) 145
LOGCLJCL skeletal JCL execution member 349 CHANGE.SECLOG (for RLDS) 160
logging CHANGE.SECLOG (for SLDS) 164
accumulating logs using DFSUCUM0 33 NOAUTH parameter commands
condensing logs using DFSUCUM0 33 CHANGE.DB 122
LOGRET parameter CHANGE.DBDS 128
INIT.RECON 241 NOBACK parameter CHANGE.DB command 122
LOGRET parameter of CHANGE.RECON 151 NOBACKUP parameter CHANGE.SUBSYS
LSR (Local Shared Resources option) 50 command 168
NOCATDS parameter commands
CHANGE.RECON 148
M INIT.RECON 239
macro NOCFSTR2 parameter CHANGE.DBDS command 128
DEQ 48 NOCHECK parameter
DFP Record Management Services 48 CHANGE.RECON 150
GRS 47 INIT.RECON 240
IMSCTRL 13 NODEFLT parameter commands
OBTAIN 48 CHANGE.CAGRP 119
RESERVE 47 GENJCL.CA 190
maximum number of generations, image copy data sets, GENJCL.IC 199
GENMAX parameter 129, 228 GENJCL.OIC 205
MAXOLDS parameter GENJCL.ARCHIVE GENJCL.RECOV 214
command 186 GENJCL.USER 219
MEMBER parameter commands NOERASE keyword 50
GENJCL.ARCHIVE 187 NOFORCER parameter commands
GENJCL.CA 190 CHANGE.RECON 149
GENJCL.CLOSE 194 INIT.RECON 240
GENJCL.IC 199 NOJOB parameter commands
GENJCL.OIC 205 GENJCL.ARCHIVE 186
GENJCL.RECEIVE 209 GENJCL.CA 190
GENJCL.RECOV 213 GENJCL.CLOSE 193
GENJCL.USER 217 GENJCL.IC 198
INIT.DBDSGRP 232 GENJCL.OIC 205
members 310 GENJCL.RECEIVE 209
merging logs 37 GENJCL.RECOV 213
MULTIJOB parameter commands GENJCL.USER 218
GENJCL.IC 199 NOLIST parameter commands
GENJCL.OIC 205 GENJCL.ARCHIVE 186
GENJCL.RECOV 213 GENJCL.CA 190
GENJCL.USER 219 GENJCL.CLOSE 194
multiple GENJCL.IC 199
cold starts in a test environment 90 GENJCL.OIC 205
GENJCL.RECEIVE 209
GENJCL.RECOV 213
N GENJCL.USER 218
NAME keyword 50 NOLKASID parameter
naming conventions CHANGE.DBDS command 130, 230
change accumulation data sets 22 NONEW parameter commands 242
DBRC data sets 21 CHANGE.RECON 152
duplicate image copy data sets 22 INIT.RECON 242
image copy data sets 21 NONRECOV parameter command, CHANGE.DB 123

468 DBRC Guide & Reference

nonstandard image copy data sets
description 32
O
OICJCL parameter
RECON
commands 130
adding information 299
CHANGE.DBDS 130
changing information 170
INIT.DBDS 229
deleting information 184
skeletal JCL execution member 354
NOPREL parameter CHANGE.DBDS command 130
OLDS (online log data set)
NOPREO parameter CHANGE.DBDS command 131
archiving DBRC 13
NORECOV parameter CHANGE.DBDS command 131
changing information 137, 156
NOREUSE keyword 50
commands
NOREUSE parameter
CHANGE.PRILOG 137
CA data set 38
CHANGE.SECLOG 157
CHANGE.DBDS 130
DELETE.LOG (for OLDS) 178
command
GENJCL.ARCHIVE 185
CHANGE.CAGRP 119
GENJCL.CLOSE 194
image copy data sets for future use 29
NOTIFY.PRILOG (for OLDS) 271
INIT.CAGRP 224
NOTIFY.SECLOG (for OLDS) 288
INIT.DBDS 228
RECON
NORMAL parameter commands
adding information 271, 288
CHANGE.PRILOG (for OLDS) 138
deleting information 177
CHANGE.PRILOG (for RLDS) 140
records 57
CHANGE.PRILOG (for SLDS) 145
selecting in JCL 320
CHANGE.SECLOG (for OLDS) 157
OLDVOL parameter commands
CHANGE.SECLOG (for RLDS) 160
CHANGE.PRILOG (for RLDS) 141
CHANGE.SECLOG (for SLDS) 164
CHANGE.PRILOG (for SLDS) 146
CHANGE.SUBSYS 168
CHANGE.SECLOG (for RLDS) 160
NOTIFY.SUBSYS 299
CHANGE.SECLOG (for SLDS) 165
normal restart 42
ONEJOB parameter commands
notational conventions, commands 107
GENJCL.IC 199
NOTCOVER parameter
GENJCL.OIC 205
CHANGE.DB command 122
GENJCL.RECOV 213
CHANGE.DBDS command 129
GENJCL.USER 219
nothing to process, when change accumulation
online
says 86
/RMDELETE command 110
NOTIFY.ALLOC command 263
Online Database Image Copy utility (DFSUICP0) 28
NOTIFY.BKOUT command 264
creating data sets for future use 29
NOTIFY.CA command 265
description 26
NOTIFY.PRILOG 14
execution recorded by DBRC 17
NOTIFY.PRILOG (for OLDS) command 271
generating a job 202
NOTIFY.PRILOG (for RLDS) command 274
Online Database Image Copy utility JCL 354
NOTIFY.PRILOG (for SLDS and TSLDS)
ONLINE parameter commands
command 279
LIST.SUBSYS 260
NOTIFY.RECOV command 283
NOTIFY.IC 269
NOTIFY.REORG command 285
NOTIFY.SUBSYS 299
NOTIFY.SECLOG 14
Online Recovery Service (ORS) 7, 15
NOTIFY.SECLOG (for OLDS) command 288
database recovery process 38
NOTIFY.SECLOG (for RLDS) command 291
image copy output 28
NOTIFY.SECLOG (for SLDS) command 294
time stamp recovery 232
NOTIFY.SUBSYS command 298
NOTIFY.UIC command
description 299
notifying DBRC that log data sets have moved 87 P
NOVSO parameter 132 parameter
CHANGE.DBDS 132, 230 CIC 28
NXTOLDS parameter commands DBRC for online IMS 10
NOTIFY.PRILOG (for OLDS) 273 GENMAX 29
NOTIFY.SECLOG (for OLDS) 290 NOREUSE 29, 38
record type 315
RECOVPD 17
REUSE 29
selection criteria 316

Index 469
parameter (continued) RECON (continued)
STARTNEW 68 extending 50
partition DB record (DSPDBHRC) header records 56
HALDB HSSP image copy data set 17
TYPE=PART 61 initial access 54
partition DBDS records (DSPDSHRC) initialization 46
HALDB keywords 50
types of DBDSs 61 maintaining 64
partition record (DSPPTNRC) maintaining records 65
HALDB overview 45
PHDAM 61 RECON Upgrade utility 71
PDS members 8 recovering 68
PRELOAD parameter CHANGE.DBDS command 130 recovery record types 57
PREOPEN parameter CHANGE.DBDS command 131 registering databases 12
PRILOG reorganizing 66
closing an open online 83 reorganizing to increase maximum
compression 82 RECORDSIZE 87
compression, automatic 65 sample listing 367
PRILOG family security considerations 54
listing records 254 serialization 47
procedures, installation 10 shared among multiple processors 47
PSB parameter commands 115 spare 54
CHANGE.BKOUT 115 VSAM CREATE mode 49
GENJCL.OIC 204 RECON command INIT
GENJCL.USER 219 establishing RECONs for log control 11
NOTIFY.BKOUT 265 RECON I/O exit routine 8
PURGLIST parameter NOTIFY.CA command 266 RECON initialization token (RIT) 19
RECON record types 55
RECON Upgrade utility (DSPURU00) 71
R JCL example 74
RCVTIME parameter return codes and messages 73
GENJCL.RECOV 214 usage procedure 71
NOTIFY.RECOV 283, 284 RECON1 parameter, BACKUP.RECON command 111
RCVTRACK parameter RECONs, both are unusable 68
CHANGE.DB command 123 record log information 13
CHANGE.DBDS command 131 record type parameter 315
reading syntax diagrams 107 recording recovery related information 8
READOFF parameter CHANGE.DB command 124 records
READON parameter CHANGE.DB command 124 BACKOUT 58
RECDCT parameter commands change accumulation group 58
CHANGE.IC 136 change accumulation run 58
NOTIFY.IC 270 data sharing 64
NOTIFY.REORG 287 database 59
RECON database allocation 63
active 54 database data set 59
allocation 45 database data set group 59
availability 46 database recovery 57
backup 64 DBDS group 59
changing log control records 13 DEDB 61
concurrent image copy data set 17 deleting unnecessary 65
contention problems 46 global service group 62
creating 50 image copy 62
data sharing record types 64 in RECON 55
data sharing records 20 log allocation 63
Database Image Copy 2 data set 17 log data set 56
defining 46 maintaining RECON 65
defining requirements in 14 RECON header 56
description 45, 64 recovery 64
DSECTS 367 reorganization 63
dynamic allocation 49 subsystem 64
enqueue problems, causes of 91 RECORDSIZE keyword 51

470 DBRC Guide & Reference

RECOVABL parameter commands RECTIME parameter commands (continued)
CHANGE.DB 123 CHANGE.IC 135
INIT.DB 225 CHANGE.UIC 170
recoverable databases DELETE.ALLOC 172
CHANGE.DB command 26 DELETE.CA 173
Image Copy utilities 26 DELETE.IC 177
INIT.DB command 26 DELETE.RECOV 181
recovering a database 38 DELETE.REORG 182
archiving log records 43 DELETE.UIC 184
batch support 40 RECVJCL parameter CHANGE.DBDS command 131
DBRC role 39 registering databases in RECON 12
dynamic backout 40 Remote Site Recovery (RSR), DBRC support 22
process 38 Removing an SSYS from DB Authorization 86
recovery facilities 40 reorganization of RECON
setting up recovery mechanisms 39 adding information 285
without DBRC 42 deleting information 182
recovery process to increase maximum RECORDSIZE 87
CHANGE.DBDS 131 reorganization record 63
concepts 5 reorganizing RECON, CHANGE.RECON 66
database data set or area, adding information to REPLACE parameter CHANGE.RECON
RECON 283 command 149
DBRC 13 REPRO function of VSAM AMS, offline
description 69 reorganization 67
IMS process 5 REPTHT parameter, CHANGE.RECON command 156
in data sharing RESERVE command, during backup 64
planning procedures 39 RESET.GSG command 303
without DBRC 42 resetting the GENMAX parameter 80
log data set restart in data sharing
deleting information 178 after DBRC failure 42
log data set, adding information to RECON 274, after IMS failure 42
291 emergency, after DBRC failure 42
overview 5 emergency, after IMS failure 42
period, of image copy data sets 30 normal 42
RECON 68 RESTORE parameter GENJCL.RECOV command 214
record 64 REUSE parameter, image copy data sets for future
recovery control use 29
data set REUSE parameter commands
commands to generate JCL and user-defined CHANGE.CAGRP 119
output 309 CHANGE.DBDS 130
header record 56 INIT.CAGRP 224
listing 258 INIT.DBDS 17, 228
recovery control data set 45 reusing image copy data sets 30
I/O error processing 67 RIT (RECON initialization token) 19
records 55 RLDS (recovery log data set) 139
replacing discarded RECON 69 accumulating changes using DFSUCUM0 33
Recovery Control utility (DSPURX00) commands 140
description 8 CHANGE.PRILOG (for RLDS) 140
recovery functions for DBDSs 13 CHANGE.SECLOG (for RLDS) 159
recovery records, database 57 NOTIFY.PRILOG (for RLDS) 277
recovery utilities 7 NOTIFY.SECLOG (for RLDS) 293
RECOVJCL parameter deleting information from RECON 178
commands records 56
CHANGE.DBDS 131 selecting 323
INIT.DBDS 229 ROLB call 40
skeletal JCL execution member 358 RSR 22
RECOVPD parameter 17 RUNTIMES parameter commands
RECOVPD parameter commands CHANGE.PRILOG (for RLDS) 142
CHANGE.DBDS 131 CHANGE.PRILOG (for SLDS) 146
INIT.DBDS 229 CHANGE.SECLOG (for RLDS) 161
RECTIME parameter commands CHANGE.SECLOG (for SLDS) 165
CHANGE.CA 116 NOTIFY.CA 266

Index 471
RUNTIMES parameter commands (continued) SLDS (system log data set) (continued)
NOTIFY.IC 269 NOTIFY.SECLOG (for SLDS) 295
NOTIFY.PRILOG (for OLDS) 271 records 56
NOTIFY.PRILOG (for RLDS) 275 selecting 321
NOTIFY.PRILOG (for SLDS) 280 SLDS stop time, locating the last in RECON 79
NOTIFY.PRILOG (for TSLDS) 280 SMS concurrent image copy, SMSCIC parameter 197
NOTIFY.REORG 286 SMSCIC (SMS concurrent image copy) 197
NOTIFY.SECLOG (for OLDS) 288 SMSCIC parameter command,
NOTIFY.SECLOG (for RLDS) 291 GENJCL.IC 197
NOTIFY.SECLOG (for SLDS) 295 space requirements, RECONs 45
NOTIFY.UIC 300 SPANNED keyword 51
spare RECON, I/O error processing 67
specifying log retention intervals,
S CHANGE.RECON 151
sample listing of RECON SPEED keyword 51
Active Site 373 SSID parameter commands
tracking site 401 CHANGE.BKOUT 114
select group, skeletal JCL 313 CHANGE.DB 125
selection criteria parameter 316 CHANGE.PRILOG (for OLDS) 138
serialization CHANGE.PRILOG (for SLDS) 146
of RECON 47 CHANGE.RECON 152
strategies 48 CHANGE.SECLOG (for OLDS) 157
service group CHANGE.SECLOG (for SLDS) 165
changing information 167 CHANGE.SUBSYS 168
deleting information 182 DELETE.BKOUT 172
service utilities DELETE.LOG (for OLDS) 178
control statement parameters 315 DELETE.SUBSYS 183
share control 13 GENJCL.ARCHIVE 187
share level, in DBRC 20 GENJCL.CLOSE 194
SHARELVL parameter GENJCL.USER 219
CHANGE.DB 124 INIT.RECON 242
INIT.DB 226 LIST.BKOUT 245
specification descriptions 20 LIST.LOG (for a category of records) 258
SHAREOPTIONS keyword 51 LIST.LOG (for a PRILOG family) 255
sharing level, assigning one with DBRC 20 LIST.RECON 259
simple keywords 311 LIST.SUBSYS 260, 261
control keywords 311 NOTIFY.BKOUT 264
%DELETE 313, 317 NOTIFY.PRILOG (for OLDS) 273
%ENDDEL 313, 317 NOTIFY.PRILOG (for RLDS) 277
%ENDSEL 313, 314 NOTIFY.PRILOG (for SLDS and TSLDS) 282
%SELECT 313, 320 NOTIFY.SECLOG (for OLDS) 290
%SET MEMBER 313, 318 NOTIFY.SECLOG (for RLDS) 293
%SET TIMEFMT 313, 318 NOTIFY.SECLOG (for SLDS) 297
size calculation for SSYS record 85 NOTIFY.SUBSYS 298
skeletal JCL 356 standard form of time stamps, parameters of DBRC
coding default members 329 commands 101
coding execution members 311, 329 START command
data set 310 use of 20, 212
default members explained 310 STARTIME parameter commands
execution members explained 310 CHANGE.PRILOG (for RLDS) 140
generating JCL and user-defined output 309 CHANGE.PRILOG (for SLDS) 144
IBM-supplied 310, 340 CHANGE.SECLOG (for RLDS) 159
writing your own 310, 331 CHANGE.SECLOG (for SLDS) 163
SLDS (system log data set) DELETE.LOG (for RLDS and SLDS) 179
accumulating changes using DFSUCUM0 33 NOTIFY.ALLOC 263
adding information to RECON 279, 294 NOTIFY.PRILOG (for OLDS) 272
CHANGE.PRILOG (for SLDS) 144 NOTIFY.PRILOG (for RLDS) 275
CHANGE.SECLOG (for SLDS) 163 NOTIFY.PRILOG (for SLDS and TSLDS) 280
changing information 143, 162 NOTIFY.SECLOG (for OLDS) 289
deleting information from RECON 178 NOTIFY.SECLOG (for RLDS) 292
NOTIFY.PRILOG (for SLDS) 279 NOTIFY.SECLOG (for SLDS) 296

472 DBRC Guide & Reference

STARTNEW parameter symbolic keywords (continued)
commands 152 JCL execution member (continued)
CHANGE.RECON 152 %ICUSID 326
INIT.RECON 242 %ICVCNT 326
usage 68 %ICVOLS 326
STARTRCV parameter commands %LOGDSN 324
CHANGE.SUBSYS 169 %LOGETIM 324
NOTIFY.SUBSYS 299 %LOGFRID 324
STATUS parameter LIST.RECON command 259 %LOGFSEQ 324
STOPTIME parameter commands %LOGLRID 325
CHANGE.IC 136 %LOGMERG 324
NOTIFY.CA 266 %LOGONL 324
NOTIFY.IC 270 %LOGRMT 324
SUBSET parameter commands %LOGSEL 324
CHANGE.CA 117 %LOGSTIM 324
NOTIFY.CA 267 %LOGUNIT 324
subsystem %LOGVOLS 324
changing information 168 %OLDCTIM 321
listing 260 %OLDFRID 321
RECON 183 %OLDLRID 321
adding information 298 %OLDOTIM 321
deleting information 183 %OLDSDDN 320
subsystem (SSYS) record %OLDSDSN 320
deleting a 85 %OLDSSEL 321
initializing during IMS restart 64 %OLDSTYP 321
size calculation 85 %PLGTIME 328
working with 84 %SLDETIM 322
symbolic keywords %SLDFRID 322
description 310, 313, 329 %SLDFSEQ 322
JCL execution member %SLDLRID 322
%ALLSEL 328 %SLDRMT 322
%ALLTIME 328 %SLDSDDN 322
%ALLUSID 328 %SLDSSEL 322
%CADSN 327 %SLDSTIM 322
%CAFSEQ 327 %SLDUNIT 322
%CALGTM 327 %SLDVOLS 322
%CAODSN 318 %SSID 312
%CASEL 327 %TIME 312
%CATIME 327 simple keywords 311, 328
%CAUNIT 327 recognized by DBRC 331
%CAVCNT 327 user-defined 312
%CAVOLS 327 symbolic keywords, JCL execution member
%DALTIME 328 substitution 309
%DBADDN 329 syntax, DBRC command 99
%DBADSAV 329 syntax diagrams
%DBDDN 328, 329 reading 107
%DBDSDEL 329 arrow symbols 107
%DBDSN 329 conventions 108
%DBDSNRV 329 default keywords 109
%DBNAME 328, 329 IMS-specific syntax information 109
%DBTYPE 329 multiple or optional items 108
%DBUSID 329 optional items 108
%DDNAME 315 repeatable items 109
%ICCAT 326 required items 108
%ICDSN 325 syntax notation, commands 107
%ICFSEQ 325 system log management, with data sharing 37
%ICSEL 325 system logs, with data sharing 37
%ICSTOP 325
%ICTIME 325
%ICTYPE 325
%ICUNIT 325

Index 473
T UNAUTH parameter
CHANGE.DB command 125
TAPEUNIT parameter commands
restrictions 121
CHANGE.RECON 153
using 121
INIT.RECON 242
UNAVAIL parameter commands
tasks of DBRC 6
CHANGE.ADS 113
THT parameter, CHANGE.RECON command 156
CHANGE.PRILOG (for OLDS) 137
time qualifier 316
CHANGE.SECLOG (for OLDS) 157
time stamp 101
INIT.ADS 221
conversions and examples 105
UNIQUE keyword 51
DBRC commands affected by format 106
UNIT parameter commands
specifying zero values 105
CHANGE.CA 117
standard default settings for values 106
CHANGE.IC 136
standard format 101
CHANGE.PRILOG (for RLDS) 142
time history table (THT) 107
CHANGE.PRILOG (for SLDS) 146
TIMEFMT parameter 102
CHANGE.SECLOG (for RLDS) 161
two-digit year input 105
CHANGE.SECLOG (for SLDS) 166
TIMEFMT parameter sublist
GENJCL.CA 190
CHANGE.RECON 154
GENJCL.IC 199
default settings 105
GENJCL.OIC 205
order of precedence of the subparameters 104
INIT.CA 222
TIMEZIN parameter CHANGE.RECON command 154
INIT.IC 234
TIMEZONE parameter, CHANGE.RECON
NOTIFY.CA 267
command 153
NOTIFY.IC 270
TOTIME parameter commands
NOTIFY.PRILOG 282
DELETE.LOG (for RLDS and SLDS) 179
NOTIFY.PRILOG (for RLDS) 278
GENJCL.ARCHIVE 186
NOTIFY.REORG 287
LIST.HISTORY 253
NOTIFY.SECLOG (for RLDS) 294
LIST.LOG 257
NOTIFY.SECLOG (for SLDS) 297
TRACEOFF parameter CHANGE.RECON
UNIT2 parameter commands
command 153
CHANGE.IC 136
TRACEON parameter CHANGE.RECON
GENJCL.OIC 206
command 153
INIT.IC 234
TRACK parameter NOTIFY.RECOV command 284
NOTIFY.IC 270
TRACKING parameter
NOTIFY.REORG 287
CHANGE.DB command 125
UNORDERED keyword 51
CHANGE.SUBSYS command 169
UOR (unit of recovery) parameter commands
TSLDS (tracking subsystem log data set)
CHANGE.BKOUT 114
adding information to RECON 279
NOTIFY.BKOUT 265
CHANGE.PRILOG (for TSLDS) 144
UORTIME parameter CHANGE.BKOUT command 114
CHANGE.SECLOG (for TSLDS) 163
USEDBDS parameter GENJCL.RECOV command 214
changing information 143
USEIC parameter GENJCL.RECOV command 214
NOTIFY.PRILOG (for TSLDS) 279
USERKEYS parameter commands
TYPEFP parameter commands
GENJCL.ARCHIVE 187
CHANGE.DB 125
GENJCL.CA 190
INIT.DB 226
GENJCL.CLOSE 194
LIST.DB 247
GENJCL.IC 199
TYPEIMS parameter commands
GENJCL.OIC 206
CHANGE.DB 125
GENJCL.RECEIVE 209
INIT.DB 226
GENJCL.RECOV 215
LIST.DB 247
GENJCL.USER 219
using DB Groups 19
using DBRC, considerations for 12
U USR records, GTF (Generalized Trace Facility) 153
UCF (Utility Control Facility) with data sharing 42 utilities
UDATA parameter commands DBRC (DFSURDB0) 42
CHANGE.UIC 170 Recovery Control (DSPURX00) 8
NOTIFY.UIC 300 VSAM AMS 67, 68
UIC, NOTIFY.UIC command Utility Control Facility (UCF) 42
updating RECON 17 utility control statement
INIT.CA 37

474 DBRC Guide & Reference

utility control statement (continued)
INIT.CAGRP 37

V
valid log subset, in data sharing to compress the
size 37
VALID parameter commands
CHANGE.CA 116
CHANGE.IC 135
VALID2 parameter CHANGE.IC command 136
VOLLIST parameter commands
CHANGE.CA 117
CHANGE.IC 136
CHANGE.PRILOG (for RLDS) 142
CHANGE.PRILOG (for SLDS) 146
CHANGE.SECLOG (for RLDS) 161
CHANGE.SECLOG (for SLDS) 166
GENJCL.CA 191
GENJCL.IC 200
GENJCL.OIC 206
INIT.CA 222
INIT.IC 234
NOTIFY.CA 266
NOTIFY.IC 270
NOTIFY.REORG 287
VOLLIST2 parameter commands
CHANGE.IC 136
GENJCL.IC 200
GENJCL.OIC 206
INIT.IC 235
NOTIFY.IC 270
NOTIFY.REORG 287
VOLNUM parameter GENJCL.CA command 191
VOLSER parameter commands
NOTIFY.PRILOG (for RLDS) 278
NOTIFY.PRILOG (for SLDS and TSLDS) 282
NOTIFY.SECLOG (for RLDS) 294
NOTIFY.SECLOG (for SLDS) 297
VOLUMES keyword 51
VSAM (Virtual Storage Access Method) create
mode 49
VSAM AMS (access method services)
offline reorganization 67
restoring RECONs 68
VSO parameter
CHANGE.DBDS 132, 230

Index 475
476 DBRC Guide & Reference
Readers’ Comments — We’d Like to Hear from You
IMS Version 7
DBRC Guide and Reference

Publication No. SC26-9428-01

Overall, how satisfied are you with the information in this book?

Very Satisfied Satisfied Neutral Dissatisfied Very Dissatisfied

Overall satisfaction h h h h h

How satisfied are you that the information in this book is:

Very Satisfied Satisfied Neutral Dissatisfied Very Dissatisfied

Accurate h h h h h
Complete h h h h h
Easy to find h h h h h
Easy to understand h h h h h
Well organized h h h h h
Applicable to your tasks h h h h h

Please tell us how we can improve this book:

Thank you for your responses. May we contact you? h Yes h No

When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any
way it believes appropriate without incurring any obligation to you.

Name Address

Company or Organization

Phone No.
___________________________________________________________________________________________________
Readers’ Comments — We’d Like to Hear from You Cut or Fold
SC26-9428-01 Along Line

_ _ _ _ _ _ _Fold
_ _ _and
_ _ _Tape
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Please
_ _ _ _ _do
_ _not
_ _ staple
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Fold
_ _ _and
_ _ Tape
______

NO POSTAGE
NECESSARY
IF MAILED IN THE
UNITED STATES

BUSINESS REPLY MAIL

FIRST-CLASS MAIL PERMIT NO. 40 ARMONK, NEW YORK

POSTAGE WILL BE PAID BY ADDRESSEE

International Business Machines Corporation

Department BWE/H3
P.O. Box 49023
San Jose, CA
95161-9945

_________________________________________________________________________________________
Fold and Tape Please do not staple Fold and Tape

Cut or Fold
SC26-9428-01 Along Line

Program Number: 5655-B01

Printed in the United States of America

on recycled paper containing 10%
recovered post-consumer fiber.

SC26-9428-01
Spine information:

IMS Version 7 DBRC Guide & Reference

IBM Maximo For Nuclear Power: Maximo User's Guide Addendum
No ratings yet
IBM Maximo For Nuclear Power: Maximo User's Guide Addendum
48 pages
Case 1 - 9 Engineering Management by Roberto Medina
86% (7)
Case 1 - 9 Engineering Management by Roberto Medina
3 pages
DB2 V8 Command Reference
No ratings yet
DB2 V8 Command Reference
515 pages
DD OS 5.2 Command Reference Guide
No ratings yet
DD OS 5.2 Command Reference Guide
330 pages
AdministrationGuide Ioa514ag
No ratings yet
AdministrationGuide Ioa514ag
1,018 pages
DS8 STS 20feb2012 PDF
No ratings yet
DS8 STS 20feb2012 PDF
525 pages
Tad 4 Z
No ratings yet
Tad 4 Z
212 pages
InstallationGuide SQL 621I
No ratings yet
InstallationGuide SQL 621I
182 pages
IBM I DB2 Web Query For I Version 2.1 Implementation Guide
No ratings yet
IBM I DB2 Web Query For I Version 2.1 Implementation Guide
880 pages
Getting Started With DOS 4.00
No ratings yet
Getting Started With DOS 4.00
172 pages
VFSM Ag 7 8
No ratings yet
VFSM Ag 7 8
541 pages
DST Iseries Guide PDF
No ratings yet
DST Iseries Guide PDF
21 pages
MVS System Commands
No ratings yet
MVS System Commands
858 pages
Ophelia and The Marvelous Boy by Karen Foxlee - Chapter Sampler
50% (4)
Ophelia and The Marvelous Boy by Karen Foxlee - Chapter Sampler
39 pages
BMC Atrium Integration Engine 7.6.04 Users Guide
No ratings yet
BMC Atrium Integration Engine 7.6.04 Users Guide
262 pages
MENSAJES
No ratings yet
MENSAJES
816 pages
CDC Admin Guide
100% (2)
CDC Admin Guide
734 pages
General 80300 TRM
No ratings yet
General 80300 TRM
312 pages
IBM Infoprint 1532, 1552, 1572 (4536, 4537, 4538) Parts List, Service Manual
No ratings yet
IBM Infoprint 1532, 1552, 1572 (4536, 4537, 4538) Parts List, Service Manual
396 pages
Connect Direct
No ratings yet
Connect Direct
128 pages
Form and Application Object Guide 7 6
No ratings yet
Form and Application Object Guide 7 6
660 pages
HP MSL2024 Tape Library - Operator Control Panel (OCP)
No ratings yet
HP MSL2024 Tape Library - Operator Control Panel (OCP)
18 pages
BMC LOADPLUS Utility - Introduction
No ratings yet
BMC LOADPLUS Utility - Introduction
15 pages
Deep Security 96 SP1 Install Guide Basic en
No ratings yet
Deep Security 96 SP1 Install Guide Basic en
88 pages
SSF01G04
No ratings yet
SSF01G04
70 pages
Os390 V210 MVS System Commands PDF
No ratings yet
Os390 V210 MVS System Commands PDF
720 pages
Oracle Rman Backup
No ratings yet
Oracle Rman Backup
5 pages
TSM DB2 Backup Management
No ratings yet
TSM DB2 Backup Management
360 pages
Control-M Workload Automation User Guide
No ratings yet
Control-M Workload Automation User Guide
395 pages
Strobe User Guide
100% (1)
Strobe User Guide
354 pages
Xyratex StorView Storage Management Software RAID Module User Guide
0% (1)
Xyratex StorView Storage Management Software RAID Module User Guide
262 pages
DB2 9 Fundamentals Exam 730 Prep, Part 1
No ratings yet
DB2 9 Fundamentals Exam 730 Prep, Part 1
60 pages
TPC Hints and Tips 4.2.2
No ratings yet
TPC Hints and Tips 4.2.2
182 pages
MySQL To DB2 Conversion Guide (sg247093) PDF
No ratings yet
MySQL To DB2 Conversion Guide (sg247093) PDF
476 pages
DFSMSHSM Primer
No ratings yet
DFSMSHSM Primer
396 pages
Informix Administrator Guide
No ratings yet
Informix Administrator Guide
138 pages
Student 80500 U
No ratings yet
Student 80500 U
2,602 pages
Ascential DataStage 7.5.x Server Job Developers Guide
67% (3)
Ascential DataStage 7.5.x Server Job Developers Guide
776 pages
Solaris To Linux Migration
No ratings yet
Solaris To Linux Migration
450 pages
Changeman UserGuide
50% (2)
Changeman UserGuide
324 pages
EN - Security Center Administrator Guide 5.9
100% (1)
EN - Security Center Administrator Guide 5.9
1,260 pages
MISys - Guide - Level 1 C
No ratings yet
MISys - Guide - Level 1 C
25 pages
CyberSense Cyber Recovery Post Attack Workflow
No ratings yet
CyberSense Cyber Recovery Post Attack Workflow
22 pages
PoT IM 06 1 027 14-Workbook
No ratings yet
PoT IM 06 1 027 14-Workbook
217 pages
SMcli and Script Commands Quick Reference For SANtricity Ver 9.25 ES1790-0-E1
No ratings yet
SMcli and Script Commands Quick Reference For SANtricity Ver 9.25 ES1790-0-E1
62 pages
Advantage CA-Easytrieve Plus Report Generator: User Guide
No ratings yet
Advantage CA-Easytrieve Plus Report Generator: User Guide
169 pages
Ibm Brms
No ratings yet
Ibm Brms
454 pages
User'S Guide: Ibm Infosphere Business Glossary
No ratings yet
User'S Guide: Ibm Infosphere Business Glossary
36 pages
Application Development For CICS
No ratings yet
Application Development For CICS
384 pages
DFSDBRG 4
No ratings yet
DFSDBRG 4
611 pages
Redbookdb 2
No ratings yet
Redbookdb 2
190 pages
Frxugb 14
No ratings yet
Frxugb 14
426 pages
SG 247606
No ratings yet
SG 247606
350 pages
Microsoft SQL Server 2005: A Beginner''s Guide
From Everand
Microsoft SQL Server 2005: A Beginner''s Guide
Dusan Petkovic
No ratings yet
Backup - Recovery Aix5
No ratings yet
Backup - Recovery Aix5
310 pages
3D Printer Projects for Makerspaces
From Everand
3D Printer Projects for Makerspaces
Lydia Sloan Cline
4/5 (1)
DFSMSdss Storage Administration Manual
No ratings yet
DFSMSdss Storage Administration Manual
360 pages
100606
No ratings yet
100606
232 pages
Development Research in Practice: The DIME Analytics Data Handbook
From Everand
Development Research in Practice: The DIME Analytics Data Handbook
Kristoffer Bjärkefur
No ratings yet
Data Ontap DSM 3.2 For Windows Mpio
No ratings yet
Data Ontap DSM 3.2 For Windows Mpio
86 pages
Presentations with LaTeX: Which package, which command, which syntax?
From Everand
Presentations with LaTeX: Which package, which command, which syntax?
Herbert Voß
No ratings yet
1995.12 - ADSM For AIX Advanced Topics - sg244601-00
No ratings yet
1995.12 - ADSM For AIX Advanced Topics - sg244601-00
210 pages
Kapferer Lbrand-Identity-Prism
100% (1)
Kapferer Lbrand-Identity-Prism
26 pages
Evolium Operation and Maintenance Center: The Right Answer To GSM Operators Challenges
100% (1)
Evolium Operation and Maintenance Center: The Right Answer To GSM Operators Challenges
4 pages
The Solution For Big Data Hadoop
No ratings yet
The Solution For Big Data Hadoop
27 pages
6 NSEP-TEST-6 Fluidsoundwave PC
No ratings yet
6 NSEP-TEST-6 Fluidsoundwave PC
11 pages
5 REVIEW TEST - Lâm Tư NG Duy
No ratings yet
5 REVIEW TEST - Lâm Tư NG Duy
53 pages
Magdalene College - Academic Visitors Policy
No ratings yet
Magdalene College - Academic Visitors Policy
2 pages
Hawaiian Healing Center
No ratings yet
Hawaiian Healing Center
132 pages
Manual of TMX 155 Honda
No ratings yet
Manual of TMX 155 Honda
14 pages
Fail Syazwan
No ratings yet
Fail Syazwan
9 pages
Generation - Incorporating Electromagnetic Transient Studies Into The Generator Interconnection Process at ATC - 110420 PDF
No ratings yet
Generation - Incorporating Electromagnetic Transient Studies Into The Generator Interconnection Process at ATC - 110420 PDF
32 pages
Toolkit Profed1
No ratings yet
Toolkit Profed1
100 pages
Human Capital Theory
No ratings yet
Human Capital Theory
4 pages
Segmundalisms
No ratings yet
Segmundalisms
3 pages
Cwaauiyvg43dmqfgnecncnka
No ratings yet
Cwaauiyvg43dmqfgnecncnka
3 pages
Sony Alpha ILCE-7 Sample Photos Page 1
No ratings yet
Sony Alpha ILCE-7 Sample Photos Page 1
7 pages
HF500NG
No ratings yet
HF500NG
2 pages
Darsey
No ratings yet
Darsey
17 pages
David D - Mentor Report - Prairiewood - pp2
No ratings yet
David D - Mentor Report - Prairiewood - pp2
5 pages
Santoprene 101-73
No ratings yet
Santoprene 101-73
4 pages
Leeboard Strut Install
No ratings yet
Leeboard Strut Install
3 pages
Various Inventory Control Techniques.: Priyanka Heeralal Gupta HPGD/JA21/2187 Supply Chain Managment
No ratings yet
Various Inventory Control Techniques.: Priyanka Heeralal Gupta HPGD/JA21/2187 Supply Chain Managment
22 pages
Am - Co.za Quotation Tm4136 Knowle 87
No ratings yet
Am - Co.za Quotation Tm4136 Knowle 87
8 pages
Rur15ny1 - Rur18ny1sr2
No ratings yet
Rur15ny1 - Rur18ny1sr2
6 pages
(Complete) Laybrinth Acadrmy
No ratings yet
(Complete) Laybrinth Acadrmy
309 pages
III. 2. Understand The Basic Concepts and Principles of Electricity As Used in Home Circuit Connections
No ratings yet
III. 2. Understand The Basic Concepts and Principles of Electricity As Used in Home Circuit Connections
8 pages
Nasr, Seyyed Hossein - Ideals and Realities of Islam (2000) (Scan, OCR) PDF
100% (1)
Nasr, Seyyed Hossein - Ideals and Realities of Islam (2000) (Scan, OCR) PDF
249 pages
Integrative Programming and Technologies 2
No ratings yet
Integrative Programming and Technologies 2
3 pages
Creating An SSH Key Pair On The Command Line
No ratings yet
Creating An SSH Key Pair On The Command Line
4 pages

DBRC Guide and Reference

Uploaded by

DBRC Guide and Reference

Uploaded by

IMS Version 7

DBRC Guide and Reference

DBRC Guide and Reference

Second Edition (June 2001)

Summary of Changes . . . . . . . . . . . . . . . . . . . . . xxiii

Part 1. How to Use DBRC . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Chapter 1. DBRC in the IMS Database Recovery Process . . . . . . . . 5

Chapter 2. Considerations for a DBRC System . . . . . . . . . . . . 25

© Copyright IBM Corp. 1974, 2001 iii

Chapter 3. Initializing and Maintaining the RECON . . . . . . . . . . 45

Chapter 4. RECON Upgrade Utility (DSPURU00) . . . . . . . . . . . 71

Chapter 5. Database Recovery Control Utility (DSPURX00) . . . . . . . 75

Chapter 6. Hints and Tips for DBRC . . . . . . . . . . . . . . . . 79

iv DBRC Guide & Reference

Part 2. Command Reference . . . . . . . . . . . . . . . . . . . . . . . . . 93

Chapter 7. DBRC Commands . . . . . . . . . . . . . . . . . . . 99

Chapter 8. BACKUP Command . . . . . . . . . . . . . . . . . . 111

Chapter 9. CHANGE Commands . . . . . . . . . . . . . . . . . 113

Chapter 10. DELETE Commands . . . . . . . . . . . . . . . . . 171

vi DBRC Guide & Reference

Chapter 11. GENJCL Commands . . . . . . . . . . . . . . . . . 185

Chapter 13. LIST Commands . . . . . . . . . . . . . . . . . . 245

viii DBRC Guide & Reference

Chapter 14. NOTIFY Commands . . . . . . . . . . . . . . . . . 263

Chapter 15. RESET Command . . . . . . . . . . . . . . . . . . 303

Part 3. Appendixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

Appendix A. Introduction . . . . . . . . . . . . . . . . . . . . 307

Appendix B. Understanding Skeletal JCL . . . . . . . . . . . . . . 309

Appendix C. Sample Listings of RECONs. . . . . . . . . . . . . . 367

x DBRC Guide & Reference

Appendix D. Considering IMS DBRC RECON Data Set Placement . . . . 453

© Copyright IBM Corp. 1974, 2001 xiii

© Copyright IBM Corp. 1974, 2001 xv

This information could include technical inaccuracies or typographical errors.

© Copyright IBM Corp. 1974, 2001 xvii

Such information may be available, subject to appropriate terms and conditions,

Any performance data contained herein was determined in a controlled

This information contains sample application programs in source language, which

xviii DBRC Guide & Reference

Before using this book, you should understand:

How to Use This Book

How to Read the Syntax Diagrams

© Copyright IBM Corp. 1974, 2001 xxi

How to Send Your Comments

xxii DBRC Guide & Reference

| New information in the following sections is included:

New information on the following enhancements is also included:

Library Changes for IMS Version 7

Other changes include changes to these following books:

© Copyright IBM Corp. 1974, 2001 xxiii

xxiv DBRC Guide & Reference

Chapter 2. Considerations for a DBRC System . . . . . . . . . . . . 25

© Copyright IBM Corp. 1974, 2001 1

Chapter 3. Initializing and Maintaining the RECON . . . . . . . . . . 45

Chapter 4. RECON Upgrade Utility (DSPURU00) . . . . . . . . . . . 71

Chapter 5. Database Recovery Control Utility (DSPURX00) . . . . . . . 75

2 DBRC Guide & Reference

Chapter 6. Hints and Tips for DBRC . . . . . . . . . . . . . . . . 79

Part 1. How to Use DBRC 3

Figure 1. IMS Database Recovery

© Copyright IBM Corp. 1974, 2001 5

v Change accumulation data sets

6 DBRC Guide & Reference

Database Recovery Control Utility (DSPURX00)

RECON Upgrade Utility (DSPURU00)

IMS Recovery utilities and functions

Chapter 1. DBRC and Database Recovery 7

Related Reading: See “Registering Databases and Database Data Sets” on

Figure 2 on page 9 shows the input DBRC uses to create JCL.

8 DBRC Guide & Reference

Figure 2. DBRC JCL Generation

In addition, the GENJCL.USER command generates user-defined output, which can

Chapter 1. DBRC and Database Recovery 9

When Should You Use DBRC?

Specifying When DBRC Is to Be Used

The IMSCTRL Macro