DFSDBRG 4
DFSDBRG 4
DFSDBRG 4
SC18-7818-03
IMS
SC18-7818-03
Note
Before using this information and the product it supports, read the information in “Notices” on page 569.
| This edition applies to IMS Version 9 (program number 5655-J38) and to all subsequent releases and modifications
| until otherwise indicated in new editions. This edition replaces SC18-7818-02.
© Copyright International Business Machines Corporation 1974, 2007.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Figures . . . . . . . . . . . . . . . v Chapter 4. Initializing and Maintaining
the RECON Data Set . . . . . . . . . 55
Tables . . . . . . . . . . . . . . . vii Planning Considerations for the RECON Data Set 55
Initially Accessing the RECON Data Set . . . . . 62
About This Book. . . . . . . . . . . ix Records in the RECON Data Set . . . . . . . 63
Prerequisite Knowledge . . . . . . . . . . ix Maintaining the RECON Data Set . . . . . . . 72
How to Use This Book . . . . . . . . . . . ix Tracking Changes Made to the RECON Data Set . . 81
Related Reading . . . . . . . . . . . . . ix
IBM Product Names Used in This Information . . . x Chapter 5. Skeletal JCL . . . . . . . 83
Accessibility Features for IMS Version 9 . . . . . xi Generating JCL and User-Defined Output . . . . 83
How to Send Your Comments . . . . . . . . xii Using IBM-Supplied Skeletal JCL . . . . . . . 84
Writing Your Own Skeletal JCL . . . . . . . . 85
Summary of Changes . . . . . . . . xiii Contents of the Skeletal JCL Data Set . . . . . . 85
| Changes to the Current Edition of This Book for Skeletal JCL Syntax . . . . . . . . . . . . 86
| IMS Version 9 . . . . . . . . . . . . . xiii
Changes to This Book for IMS Version 9 . . . . xiii Chapter 6. Hints and Tips for DBRC 107
Library Changes for IMS Version 9 . . . . . . xiv Changing the RECON Data Set to Output Time
Stamps in Local Time of Origin . . . . . . . 107
Locating the Last SLDS Stop Time in RECON . . 108
Part 1. How to Use DBRC . . . . . . 1 Adjusting GENMAX When It Is Reached or It Is
Too High . . . . . . . . . . . . . . . 109
Chapter 1. Overview of DBRC . . . . . 3 Getting PRILOG Compression to Work . . . . . 110
What Is DBRC? . . . . . . . . . . . . . 3 Getting Notified When the PRILOG Record
DBRC Tasks . . . . . . . . . . . . . . 4 Exceeds the Maximum Record Size . . . . . . 111
DBRC Components . . . . . . . . . . . . 4 Closing an Open Online PRILOG . . . . . . . 111
When Should You Use DBRC? . . . . . . . . 5 Deleting Log Records . . . . . . . . . . . 112
| Communicating with DBRC . . . . . . . . . 6 Working with Subsystem Records (SSYS) . . . . 113
DBRC Functions . . . . . . . . . . . . . 7 Removing Authorization Inconsistency Between the
| Defining DBRC to IMS . . . . . . . . . . 19 SSYS from DB/AREA Records . . . . . . . . 114
Registering Databases and Database Data Sets . . . 20 Getting Change Accumulation to Start Processing
Planning for Recovery . . . . . . . . . . . 21 Logs Again . . . . . . . . . . . . . . 114
Getting Change Accumulation Working When It
Chapter 2. Database Recovery Control States Nothing to Process . . . . . . . . . 114
Utility (DSPURX00) . . . . . . . . . 27 Moving Log Data Sets . . . . . . . . . . 115
What Is the Database Recovery Control Utility Cataloging Data Sets . . . . . . . . . . . 115
(DSPURX00)? . . . . . . . . . . . . . . 27 Performing Multiple Cold Starts in a Test
Input and Output for the Database Recovery Environment . . . . . . . . . . . . . 116
Control Utility . . . . . . . . . . . . . 27 Avoiding Some Causes of RECON Data Set
Invoking the Database Recovery Control Utility Enqueue Problems. . . . . . . . . . . . 117
from Your Program . . . . . . . . . . . . 28
Example of Database Recovery Control Utility JCL 30 Part 2. DBRC Command Reference 119
Chapter 3. Considerations for a DBRC Chapter 7. DBRC Commands . . . . 121
System . . . . . . . . . . . . . . 33 DBRC Batch Commands. . . . . . . . . . 121
General Considerations for Using DBRC. . . . . 33 | DBRC Online Commands . . . . . . . . . 122
Data Set Naming Conventions . . . . . . . . 33 DBRC Command Syntax . . . . . . . . . 122
Database Backup Copies . . . . . . . . . . 35
Log Record Change Accumulation. . . . . . . 43 Chapter 8. BACKUP Command . . . . 133
DBDS Group Considerations . . . . . . . . 48 BACKUP.RECON . . . . . . . . . . . . 133
DB Groups . . . . . . . . . . . . . . 49
| DBRC Considerations for HALDB Online
Chapter 9. CHANGE Commands . . . 135
| Reorganization . . . . . . . . . . . . . 49
CHANGE Commands In This Chapter . . . . . 135
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 installation.
With IMS Version 9, you can reorganize HALDB partitions online, either by using
the integrated HALDB Online Reorganization function or by using an external
product. In this information, the term HALDB Online Reorganization refers to the
integrated HALDB Online Reorganization function that is part of IMS Version 9,
unless otherwise indicated.
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, go to the Education link off of the
IMS home page on the Web: http://www.ibm.com/ims.
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, see the IMS Version 9: Master Index and Glossary.
Accessibility Features
The following list includes the major accessibility features in z/OS products,
including IMS Version 9. These features support:
v Keyboard-only operation.
v Interfaces that are commonly used by screen readers and screen magnifiers.
v Customization of display attributes such as color, contrast, and font size.
Keyboard Navigation
You can access IMS Version 9 ISPF panel functions by using a keyboard or
keyboard shortcut keys.
For information about navigating the IMS Version 9 ISPF panels using TSO/E or
ISPF, refer to the z/OS TSO/E Primer, the z/OS TSO/E User’s Guide, and the z/OS
ISPF User’s Guide. These guides describe how to navigate each interface, including
the use of keyboard shortcuts or function keys (PF keys). Each guide includes the
default settings for the PF keys and explains how to modify their functions.
Organizational Changes
Organization changes to the IMS Version 9 library include changes to:
v IMS Version 9: Customization Guide
v IMS Version 9: IMS Connect Guide and Reference
v IMS Version 9: IMS Java Guide and Reference
v IMS Version 9: Messages and Codes, Volume 1
v IMS Version 9: Utilities Reference: System
| A new appendix has been added to the IMS Version 9: Customization Guide that
| describes the contents of the ADFSSMPL (also known as SDFSSMPL) data set.
| The IMS Connect messages that were in IMS Version 9: IMS Connect Guide and
| Reference have moved to IMS Version 9: Messages and Codes, Volume 1.
The chapter titled ″DLIModel Utility″ has moved from IMS Version 9: IMS Java
Guide and Reference to IMS Version 9: Utilities Reference: System.
The DLIModel utility messages that were in IMS Version 9: IMS Java Guide and
Reference have moved to IMS Version 9: Messages and Codes, Volume 1.
| To ease the transition of your security support from the Security Maintenance
| Utility (SMU) to RACF, new SMU to RACF conversion utilities have been
| introduced. These utilities are documented in a new part in the IMS Version 9:
| Utilities Reference: System.
Terminology Changes
IMS Version 9 introduces new terminology for IMS commands:
type-1 command
A command, generally preceded by a leading slash character, that can be
entered from any valid IMS command source. In IMS Version 8, these
commands were called classic commands.
type-2 command
A command that is entered only through the OM API. Type-2 commands
are more flexible than type-2 commands and can have a broader scope. In
IMS Version 8, these commands were called IMSplex commands or
enhanced commands.
Summary of Changes xv
xvi DBRC Guide and Reference
Part 1. How to Use DBRC
Chapter 1. Overview of DBRC . . . . . . . . 3 Concurrent Image Copy . . . . . . . . . 38
What Is DBRC? . . . . . . . . . . . . . 3 Creating Image Copy Data Sets for Future Use
DBRC Tasks . . . . . . . . . . . . . . 4 and Reuse . . . . . . . . . . . . . . 39
DBRC Components . . . . . . . . . . . . 4 Controlling the Number of Image Copies
RECON Data Set . . . . . . . . . . . . 4 Managed . . . . . . . . . . . . . . 39
Database Recovery Control Utility (DSPURX00) . 4 Recovery Period of Image Copy Data Sets and
Skeletal JCL . . . . . . . . . . . . . 5 GENMAX . . . . . . . . . . . . . . 40
When Should You Use DBRC? . . . . . . . . 5 Reusing Image Copy Data Sets . . . . . . . 41
| Communicating with DBRC . . . . . . . . . 6 HSSP Image Copy . . . . . . . . . . . 42
| DBRC Commands . . . . . . . . . . . 6 HISAM Copies (DFSURUL0 and DFSURRL0) . . 42
| DBRC API Requests . . . . . . . . . . . 6 Nonstandard Image Copy Data Sets . . . . . 43
DBRC Functions . . . . . . . . . . . . . 7 Frequency and Retention of Backup Copies. . . 43
Recording and Controlling Log Information . . . 7 Log Record Change Accumulation. . . . . . . 43
Recovering Databases . . . . . . . . . . 10 Condensing the Accumulated SLDS or RLDS
Recording Information About Opening and (Change Accumulation) . . . . . . . . . 44
Updating Databases . . . . . . . . . . 16 When Is Change Accumulation Required? . . . 45
Supporting Data Sharing . . . . . . . . . 16 DBDS Group Considerations . . . . . . . . 48
Supporting Remote Site Recovery . . . . . . 18 DB Groups . . . . . . . . . . . . . . 49
Supporting IMSplexes . . . . . . . . . . 18 | DBRC Considerations for HALDB Online
| Defining DBRC to IMS . . . . . . . . . . 19 | Reorganization . . . . . . . . . . . . . 49
The IMSCTRL Macro . . . . . . . . . . 19 | GENJCL.IC and GENJCL.OIC Command
IMS.PROCLIB Execution-Parameter Members . . 19 | Considerations . . . . . . . . . . . . 50
IMS Procedures and DBRC . . . . . . . . 19 | NOTIFY.IC and NOTIFY.UIC Command
DBRC Procedure . . . . . . . . . . . 20 | Considerations . . . . . . . . . . . . 50
Initializing the RECON Data Set . . . . . . 20 | Records Used in HALDB Online Reorganization 50
Registering Databases and Database Data Sets . . . 20 | RSR Tracking System . . . . . . . . . . 52
Planning for Recovery . . . . . . . . . . . 21 | Maintaining Recovery-Related Records . . . . 52
Setting Up Recovery Mechanisms . . . . . . 21 | The Online Reorganization Process . . . . . 53
Recovery Facilities . . . . . . . . . . . 22
Recovery without DBRC . . . . . . . . . 24 Chapter 4. Initializing and Maintaining the
Restart After an IMS Failure . . . . . . . . 24 RECON Data Set . . . . . . . . . . . . 55
Restart After a DBRC Failure . . . . . . . 25 Planning Considerations for the RECON Data Set 55
Recovery Involving IRLM Configurations . . . 25 Initializing the RECON Data Set for the First
Batch Backout . . . . . . . . . . . . 25 Time. . . . . . . . . . . . . . . . 56
Avoiding RECON Data Set Contention Problems 56
Chapter 2. Database Recovery Control Utility Initially Accessing the RECON Data Set . . . . . 62
(DSPURX00) . . . . . . . . . . . . . . 27 Records in the RECON Data Set . . . . . . . 63
What Is the Database Recovery Control Utility RECON Header Records . . . . . . . . . 64
(DSPURX00)? . . . . . . . . . . . . . . 27 Log Data Set Records . . . . . . . . . . 64
Input and Output for the Database Recovery Database Recovery Records . . . . . . . . 65
Control Utility . . . . . . . . . . . . . 27 Maintaining the RECON Data Set . . . . . . . 72
Invoking the Database Recovery Control Utility Backing Up the RECON Data Set . . . . . . 73
from Your Program . . . . . . . . . . . . 28 Deleting Unnecessary RECON Log Records . . 73
Example of Database Recovery Control Utility JCL 30 Reorganizing the RECON Data Set . . . . . 74
Replacing Damaged RECON Data Sets . . . . 75
Chapter 3. Considerations for a DBRC System 33 Recovering the RECON Data Set . . . . . . 76
General Considerations for Using DBRC. . . . . 33 Replacing a Discarded RECON Data Set . . . . 77
Data Set Naming Conventions . . . . . . . . 33 RECON Loss Notification. . . . . . . . . 78
Naming Convention for Image Copy Data Sets 34 Preserving the Integrity of the RECON Data Set
Naming Convention for Duplicate Image Copy with DBRC Command Authorization Support . . 78
Data Sets . . . . . . . . . . . . . . 34 Tracking Changes Made to the RECON Data Set . . 81
Naming Convention for Change Accumulation
Data Sets . . . . . . . . . . . . . . 34 Chapter 5. Skeletal JCL . . . . . . . . . . 83
Database Backup Copies . . . . . . . . . . 35 Generating JCL and User-Defined Output . . . . 83
The Image Copy Utilities (DFSUDMP0, Using IBM-Supplied Skeletal JCL . . . . . . . 84
DFSUDMT0, DFSUICP0) . . . . . . . . . 35 Writing Your Own Skeletal JCL . . . . . . . . 85
In This Chapter:
v “What Is DBRC?”
v “DBRC Tasks” on page 4
v “DBRC Components” on page 4
v “When Should You Use DBRC?” on page 5
v “Communicating with DBRC” on page 6
v “DBRC Functions” on page 7
v “Defining DBRC to IMS” on page 19
v “Registering Databases and Database Data Sets” on page 20
v “Planning for Recovery” on page 21
What Is DBRC?
| DBRC is an integral part of IMS. IMS relies on DBRC to:
| v Record and manage information about many items. DBRC keeps this
| information in a set of VSAM data sets that are collectively called the RECovery
| CONtrol (RECON) data set.
| v Advise IMS (based on the information in the RECON data set) about how to
| proceed for certain IMS actions.
| Specifically, DBRC:
| v Helps you ensure IMS system and database integrity by recording and
| managing information associated with the logging process.
| v Assists IMS in the restart process by notifying IMS which logs to use for restart.
| v Assists IMS to allow or prevent access to databases in data-sharing
| environments by recording and managing database authorization information.
| v Facilitates database and log recovery by:
| – Controlling the use and integrity of the information in the logs.
| – Recording and maintaining information about the databases and logs in the
| RECON data set.
| – Generating and verifying the Job Control Language (JCL) for various IMS
| utility programs.
| v Supports Extended Recovery Facility (XRF) by identifying (in the RECON data
| set) if the subsystem is XRF capable.
| v Supports Remote Site Recovery (RSR) by containing the RSR complex definition
| in the RECON data set and providing other services associated with controlling
| RSR.
| v Supports IMSplexes by notifying all DBRCs in the same IMSplex when one of
| the DBRCs performs a RECON data set reconfiguration.
DBRC Tasks
DBRC automatically performs the following tasks:
v Records and manages information about logs for IMS
v Records recovery information in the RECON data set
v Verifies that database utilities have the correct input
v Controls the recovery of databases that are registered with DBRC
v Controls the access authorization information for the control and serialization of
shared databases
You can perform the following tasks and more when you initiate them by passing
commands or requests to DBRC:
| v Start or stop the DBRC application programming interface (API)
v Record recovery information in the RECON data set
v Generate JCL for various IMS utilities and generate user-defined output
v List general information in the RECON data set
| v Gather specific information from the RECON data set
Related Reading:
v See “Recording and Controlling Log Information” on page 7 for additional
information about DBRC’s logging support.
v See “Supporting Data Sharing” on page 16 for additional information about
DBRC’s data sharing support.
| v See Part 2, “DBRC Command Reference,” on page 119 for detailed information
| about the DBRC commands.
| v See Part 3, “DBRC Application Programming Interface (API) Reference,” on page
| 351 for detailed information about the DBRC API requests.
DBRC Components
DBRC includes the following components, which are introduced in this section:
v “RECON Data Set”
v “Database Recovery Control Utility (DSPURX00)”
v “Skeletal JCL” on page 5
| Recommendation: Define three VSAM KSDSs for the RECON data sets when you
| install DBRC. The first two data sets 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 RECON data sets as if they were a single data set, the RECON
| data set.
Related Reading: These data sets are described in detail in Chapter 4, “Initializing
and Maintaining the RECON Data Set,” on page 55.
The DBRC commands allow you to perform all of the following tasks:
4 DBRC Guide and Reference
DBRC overview
Related Reading: The details for using the Database Recovery Control utility can
be found in Chapter 2, “Database Recovery Control Utility (DSPURX00),” on page
27.
Skeletal JCL
DBRC uses partitioned data set (PDS) members as input models (or templates) for
generating input for some of the recovery utilities. These PDS members are
distributed with IMS and are called skeletal JCL.
DBRC uses the skeletal JCL, information from the RECON data set, and
instructions from a GENJCL command to generate the JCL and control statements
that are needed to correctly run some of the recovery utilities. Modify the skeletal
JCL to reflect your installation’s system configuration.
Related Reading: For more information about skeletal JCL, see Chapter 5, “Skeletal
JCL,” on page 83.
IMS provides PDS members that contain skeletal JCL statements. These PDS
members are called skeletal JCL execution members and can be found in the
IMS.SDFSISRC target library.
The IMS Installation Verification Program (IVP), customizes the skeletal JCL
execution members and places the customized members into the IMS.PROCLIB
procedure library. DBRC uses the members (from IMS.PROCLIB) to generate jobs
(JCL and control statements) for the IMS utilities listed in Table 7 on page 83. There
is also a skeletal JCL execution member, JOBJCL, that produces a JOB statement.
DBRC also plays a key role in managing the log data needed to restart and recover
IMS online subsystems.
Attention: 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-data 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 9: Operations Guide provides detailed descriptions of recovery
procedures with and without DBRC.
v “How DBRC Helps in Recovery” on page 12 further describes how DBRC helps
with database recovery.
| DBRC Commands
| Use DBRC batch and online commands to:
| v Add to, change, and delete information in the RECON data sets.
| v Generate the JCL and the control statements necessary to run the various IMS
| utilities used in database recovery.
| Use the Database Recovery Control utility (DSPURX00) to issue DBRC batch
| commands. This utility can process these commands while running either in a
| batch environment or as a TSO foreground program.
| A variation of some of the DBRC batch commands can be issued online using the
| /RMxxxxxx command (for example, /RMCHANGE DBRC='RECON'). Although most of the
| command examples in this book feature the DBRC batch commands, the online
| version (where appropriate) of the example command can be used instead.
| Related Reading: For more information about the DBRC commands, see Chapter 7,
| “DBRC Commands,” on page 121.
| Related Reading: For more information about the DBRC application programming
| interface and the API requests, see Chapter 16, “Using the DBRC API,” on page
| 353.
DBRC Functions
The following sections describe DBRC’s major functions:
v “Recording and Controlling Log Information”
v “Recovering Databases” on page 10
v “Recording Information About Opening and Updating Databases” on page 16
v “Supporting Data Sharing” on page 16
v “Supporting Remote Site Recovery” on page 18
v “Supporting IMSplexes” on page 18
Figure 1 shows the log data sets and restart data set (RDS) that IMS produces and
the RECON data set that DBRC creates and maintains.
Related Reading: See the IMS Version 9: Operations Guide for detailed discussions
of the IMS logging process.
| After you have initialized DBRC, it participates in the IMS logging process by
| recording and controlling information about IMS’s logging activities. This
| information is recorded in the RECON data set. If you want DBRC to control the
| recovery of your database data sets (DBDSs), you must register them with DBRC.
| DBRC automatically records many items in the RECON data set, including:
| v Information about log data sets
| v Information about database data sets
| v Information about events, such as:
| – Database updates
| – Database authorizations
| – Creation of database image copies
| – Reorganizations of databases
| – Recoveries of databases
| – Archiving of an OLDS and creation of the corresponding SLDS and RLDS
| – Execution of the Log Recovery utility
| – Subsystem sign-on
| v Definitions and information about events for Remote Site Recovery
IMS uses this information for restarting itself and for database recovery jobs (if the
databases are registered with DBRC). DBRC also tracks the archiving requirements
of the OLDS and, if requested, generates and submits the JCL for archiving jobs.
For logs produced by batch systems, you are not required to use DBRC. The
advantage of using DBRC for batch jobs is that DBRC records information about
all the log data sets that are produced by batch jobs and prevents batch update
jobs from executing if you specify a dummy or null log data set.
Archiving an OLDS
Run 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 Log 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 Log Archive 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, information about the output RLDS data sets is recorded
in the PRILOG record in the RECON data set and information about the SLDS
data sets is recorded in the PRISLD record. If you do not request an RLDS, the
same information about the SLDS data sets is 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 information about the secondary-log output is recorded in
corresponding SECLOG and SECSLD records.
Important: Log data sets that are output from IMS batch jobs are technically
SLDSs, but the information about them is recorded in the PRILOG and SECLOG
records.
Run the Log Archive utility by issuing the GENJCL.ARCHIVE command. DBRC then
determines which OLDSs are full, and generates the appropriate JCL.
If DBRC has marked an OLDS in the RECON data set 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 the RECON data set as
having errors.
The following references point to where you can find more information about
archiving log records.
Related Reading:
v See IMS Version 9: Operations Guide for more information about automatic,
manual and custom archiving of log records.
v See IMS Version 9: Utilities Reference: System for more information about
specifying entry points and running the Log Archive utility.
v Refer to IMS Version 9: Customization Guide for more information about the Log
Archive and the Logger exit routines.
v DELETE.LOG
v GENJCL.ARCHIVE
v GENJCL.CLOSE
v LIST.LOG
v NOTIFY.PRILOG
v NOTIFY.SECLOG
In addition to the LIST.LOG command, you can use a Log or OLDS query API
request to retrieve log-related information from the RECON data set.
Recovering Databases
This topic provides an overview of how databases are recovered. Included in this
topic are:
v “The Basic Steps of Database Recovery”
v “How DBRC Helps in Recovery” on page 12
Information for a database recovery can come from any or all of the following
sources:
v Image copies of the database
You can use DBRC to track all of these information sources, greatly simplifying the
task of database recovery.
Related Reading: Refer to IMS Version 9: Operations Guide for more information
about the recovery process.
If you register recoverable databases in the RECON data set, DBRC records the
association of the databases to the log data sets containing database change
records.
DBRC can generate JCL for executing a database recovery, because DBRC records
this information in the RECON data set. Whether you use the GENJCL commands to
generate JCL or provide the JCL yourself, DBRC uses information in the RECON
data set to determine exactly which data sets are required for input. The Database
Recovery utility runs only if DBRC verifies that the JCL is correct.
You can omit all logged changes after a certain time from the input by performing
a time-stamp recovery. A time-stamp recovery is equivalent to backing out the
omitted changes from the database.
Figure 3 on page 12 shows how DBRC works with the Database Recovery utility.
DBRC can:
v Generate JCL that can be used to run various utilities (see “Generating Recovery
JCL” on page 13)
v Validate the input to those utilities (see “Validating Utility JCL” on page 14)
v Record the result (in the RECON data set) of running the utilities (see
“Recording the Result” on page 15)
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 the RECON data set, DBRC:
1. Selects the image copy data set to use for loading the most recent image copy
2. Selects the change accumulation and log data sets that are to be input to
applying all the changes that were logged since the image copy was created
The GENJCL.USER command can generate 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.
Issue the GENJCL command to request that DBRC generate JCL in batch or issue the
/RMGENJCL command online. When you enter either command, DBRC reads skeletal
JCL and replaces symbolic parameters with actual values based on the information
recorded in the RECON data set 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 with information about 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 amount of time and effort required to recover a database can be significantly
reduced by using the GENJCL to generate the JCL and control statements necessary
for the recovery. Using the GENJCL command also eliminate the causes of many
recovery errors. You could spend a large amount of time during database
recoveries determining which input data sets should be provided in what order to
the Database Recovery utility.
When change accumulation data sets or PRILOG records (in the RECON data set)
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.
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.
Related Reading:
v See IMS Version 9: Installation Volume 2: System Definition and Tailoring for more
information about the tailoring actions for IMS.PROCLIB members, the DBRC
procedure, and the JCLOUT and JCLPDS DD statements.
v See Chapter 5, “Skeletal JCL,” on page 83 for details about customizing your
own skeletal JCL and about the contents of IMS-supplied skeletal JCL.
online area. It does not provide backup copies for recovery. The DEDB Area Data
Set Create utility uses the RECON data set as part of its input.
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 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 HALDB online reorganization
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)
v /RECOVER commands
Related Reading:
v See IMS Version 9: Utilities Reference: Database and Transaction Manager for more
information on the IMS recovery utilities.
v See “NOTIFY.BKOUT” on page 311 for information about a related command,
which manually creates a BACKOUT record in the RECON data set.
When you run the Batch Backout utility (DFSBBO00), DBRC determines 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.
Exception: DBRC does not verify the JCL input For the HD and the HISAM
Reorganization utilities, but does record information about their execution in the
RECON data set.
Recording the Result: When the recovery completes successfully, DBRC records
information about the recovery in the RECON data set. If you performed a
time-stamp recovery, DBRC records information about the range of omitted
changes.
Related Reading: See IMS Version 9: Operations Guide for information on EEQEs.
When changes to DBDSs and areas occur, DBRC records information about these
changes in the RECON data set. DBRC subsequently uses this information to
determine which log data sets might contain change records for a given DBDS or
area.
When a DBDS that is registered in the RECON data set is first opened for updates
(or allocated), 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. The
ALLOC 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 also 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.
When you de-allocate (close) 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. If no de-allocation time is recorded, DBRC uses
the closing time of the associated log as the de-allocation time. Thus the RECON
data set 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 the changes.
Related Reading: See the IMS Version 9: Operations Guide and the IMS Version 9:
Administration Guide: System for more information on data sharing.
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).
The following sharing levels are defined using the INIT.DB command and modified
with the CHANGE.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.
SHARELVL 2 Sharing is at the block level but only within the scope of a single
IRLM and a single z/OS. Sharing requires that IMS subsystems
sharing a database use the same RECON data set. 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 Realms. Multiple IMS systems can be authorized for
non-exclusive access. The IMSs can be on multiple z/OS images
using different IRLMs.
Note:
| When a batch IRLM=N job has authorization for update, authorization for
| an online system or other batch job fails unless it is for read-only access.
Related Reading: See the IMS Version 9: Administration Guide: System for more
information on controlling database recovery in an RSR environment.
Supporting IMSplexes
When an I/O error occurs on a RECON data set in an IMSplex and a spare data
set is available, the instance of DBRC that noticed the error copies the good
RECON data set to the spare, activates the spare, and deallocates the original
RECON data set.
At this point in the processing, the DBRC that noticed the I/O error can
automatically notify the other DBRCs in the IMSplex about the reconfiguration.
Then, after the original RECON data set is deallocated, it can be deleted and
redefined as the spare RECON data set.
Related Reading: See the IMS Version 9: Common Service Layer Guide and Reference
for more information about IMSplexes.
Related Reading:
v Refer to IMS Version 9: Installation Volume 1: Installation Verification and IMS
Version 9: Installation Volume 2: System Definition and Tailoring for a complete
description of IMS installation procedures and requirements.
v See Chapter 4, “Initializing and Maintaining the RECON Data Set,” on page 55
for information on creating and allocating the RECON data set.
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.
| Batch and utility regions can use the DFSIDEF0 module during initialization. In
| DFSIDEF0, you can set the DBRC= keyword to YES, NO, or FORCE. The
| DFSIDEF0 module that is shipped in the IMS.ADFSSMPL library contains a batch
| and utility region default of DBRC=YES. This value is coded on the DFSIDEF
| macro.
| You are not required to use the DFSIDEF0 module. If you do not use the module
| or if the module cannot be loaded at initialization time, IMS defaults to
| DBRC=YES. Therefore, if DBRC is to be used for your batch and utility regions,
| then creating the DFSIDEF0 module is not required.
| Related Reading: For more information about the DFSIDEF0 module, see the IMS
| Version 9: Installation Volume 2: System Definition and Tailoring.
Use the DBRCNM= parameter to request that IMS create a cataloged DBRC
procedure.
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.
The DBRCNM= parameter can be used to override the DBRC procedure name for
an online IMS execution.
DBRC Procedure
IMS automatically starts the DBRC procedure by issuing a z/OS START command
during control region initialization. This procedure specifies parameters for the
DBRC region. DBRC runs in its own address space for an online IMS subsystem.
To include the DBRC procedure during system definition, copy the skeletal DBRC
procedure from 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.
Related Reading: See the IMS Version 9: Installation Volume 2: System Definition and
Tailoring for a complete description of the DBRC procedure and its parameters.
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.
Related Reading:
v See Chapter 4, “Initializing and Maintaining the RECON Data Set,” on page 55
for information about creating the RECON data set.
v See “Registering Databases and Database Data Sets” for information about
registering databases.
v See “INIT.RECON” on page 284 for detailed information about the INIT.RECON
command.
If you want DBRC to control database recovery, you must register the databases in
the RECON data set. DBRC then records information about database updates 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.
For non-HALDBs (High Availability Large Databases), use the INIT.DB and
INIT.DBDS commands to register databases in the RECON data set 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 non-HALDB 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).
Requirement: Utility jobs that issue either an INIT.DB or INIT.PART command (to
register a HALDB) or any INIT.DBDS command, require 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 263 for specifics
about the INIT commands.
To update or delete information about HALDBs in the RECON data set, you can
use the HALDB Partition Definition utility or the following DBRC commands;
CHANGE.DB, CHANGE.DBDS, CHANGE.PART, DELETE.PART, or DELETE.DB.
Related Reading:
v See the IMS Version 9: Administration Guide: Database Manager for an overview of
HALDBs and detailed information about how to create them.
v See the IMS Version 9: Utilities Reference: Database and Transaction Manager for
information about the HALDB Partition Definition utility.
v See Chapter 9, “CHANGE Commands,” on page 135 for information about the
CHANGE commands.
The following sections describe some additional aspects of planning for recovery:
v “Setting Up Recovery Mechanisms”
v “Recovery Facilities” on page 22
v “Recovery without DBRC” on page 24
v “Restart After an IMS Failure” on page 24
v “Restart After a DBRC Failure” on page 25
v “Recovery Involving IRLM Configurations” on page 25
v “Batch Backout” on page 25
Related Reading: See the IMS Version 9: Operations Guide for detailed information
on recovery procedures in non-data sharing and data-sharing environments.
Recovery Facilities
The following recovery facilities behave differently in non-data sharing and
data-sharing environments:
v “Dynamic Backout”
v “Batch Backout Support”
v “Forward Recovery” on page 24
Also included in this section is “Limitations of DBRC Backout Support” on page
23.
Dynamic Backout
In non-data sharing and data-sharing environments, an online IMS subsystem
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.
Related Reading: See the IMS Version 9: Operations Guide for detailed information
about dynamic backout.
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.
in-flight and indoubt UORs as candidates for backout. The next IMS restart
promotes candidate UORs to backout-needed status and DBRC sets BACKOUT
NEEDED=ON in the database records in the RECON data set.
When dynamic backout fails, a BACKOUT record is created with a UOR indicating
dynamic backout failure and DBRC sets BACKOUT NEEDED=ON in the database
record in the RECON data set.
When the databases are backed out successfully, DBRC resets the backout flags in
the database records (in the RECON data set) appropriately and updates the
BACKOUT records. When backout processing for all of the UORs have been
completed, DBRC deletes the BACKOUT record from the RECON data set.
For DBCTL, if you choose not to back out an unresolved indoubt UOR, use either
the DELETE.BKOUT or CHANGE.BKOUT command to remove the unresolved indoubt
UOR from the BACKOUT record in the RECON data set.
DBRC commands are available to update BACKOUT records if needed. The need
to make manual changes to the backout record should be minimal.
DBRC verifies the validity of the logs used as input to the Batch Backout utility.
DBRC checks the input log volumes to ensure that they are in the correct sequence,
that all the needed logs are provided, and that they are properly closed. When you
include ACTIVE or COLDSTART statements in the Batch Backout utility SYSIN
statement, DBRC performs an additional check 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.
Related Reading: See IMS Version 9: Operations Guide and IMS Version 9: Utilities
Reference: Database and Transaction Manager for more information about UORs, the
backout process, and the Batch Backout utility.
Forward Recovery
The process of recovering a database in a data-sharing environment has certain
similarities to recovering a database in a non-data sharing environment. In both
environments, use DBRC for database recovery and use the following as input to
the recovery process:
v The most recent image copy of the lost database
v The recovery log data set (RLDS) or all pertinent system log data sets used since
that copy was made
Recommendation: Use the RLDS as input to the recovery process. The RLDS is a
more efficient input to the recovery process than the pertinent system log data sets
because the RLDS contains only database change log records.
If you are using the Database Recovery utility for forward recovery and block-level
data sharing is involved, you might require the additional step of change
accumulation.
Related Reading: See the IMS Version 9: Operations Guide for further discussion of
forward recovery.
Related Reading: See the IMS Version 9: 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.
In a data-sharing environment, 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 9: Operations Guide for more information
about restarting IMS after it fails.
Related Reading: See Appendix B, “Sample Listings from the RECON Data Set,”
on page 473 and IMS Version 9: Operations Guide for information on the IRLM
status information that DBRC records in the subsystem record.
Batch Backout
Prior to executing an emergency restart with the COLDSYS parameter (/ERESTART
COLDSYS), run the Batch Backout utility 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 BACKOUT record.
Attention: Use the DELETE.BKOUT command with extreme caution. It deletes all
backout information for a subsystem from the RECON data set.
Commands submitted to the Database Recovery Control utility have the same
general format. Each command is composed of a verb and a modifier (separated
by a period) and then followed by parameters.
Related Reading:
v See “CHANGE.RECON” on page 179 and the IMS Version 9: Release Planning
Guide, GC17-7831 for more information on RECON data set conversion.
v See Chapter 7, “DBRC Commands,” on page 121 for information about
command syntax.
Notes to Figure 5:
1. The DBRC command (input to the Database Recovery Control utility)
2. The RECON data set (input to the Database Recovery Control utility)
3. The PDS, which contains the JCL and control statements for the utility that
DBRC uses to generate a job (input to the Database Recovery Control utility)
4. The data set that contains the database descriptions for the databases that are
under the control of DBRC (occasional input to the Database Recovery Control
utility)
5. Jobs created by GENJCL commands (output from the Database Recovery Control
utility)
6. The RECON data set, which might have been updated by the utility (output
from the Database Recovery Control utility)
7. One or more of the following (output from the Database Recovery Control
utility):
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
| Unless stated otherwise, programs that invoke DBRC do not have to pass DBRC
| any parameters specified on the EXEC statement. DBRC will locate the parameter
| list passed by z/OS. The invoking program should not alter this parameter list.
DSPURXRT must be called in 31-bit mode. It executes in 31-bit mode and returns
to the caller in 31-bit mode with the return code set in register 15. Up to two
parameters may be passed on the CALL. The first parameter specifies the address
of an option that could be specified in the PARM parameter of the EXEC
statement. DSPURXRT currently does not support any options. This address must
point to a halfword of binary zeros. The second parameter specifies the address of
a list of alternate ddnames for standard data sets used during DSPURXRT
processing. If standard ddnames are to be used, the second parameter should
either point to a halfword of binary zeros or be omitted.
Figure 6. Registers and Operand List Contents Needed To Invoke the Database Recovery
Control Utility
The second word is the address of the ddname list (see Figure 6 on page 30). The
ddname list consists of the following:
v A halfword containing the total length of the ddname list, including this
halfword.
v A reserved halfword.
v An eight-byte field containing the ddname to be used in place of SYSIN, or eight
bytes of blanks (X'40') if SYSIN is not to be substituted. The ddname must be left
justified and padded on the right with blanks if necessary.
v An eight-byte field containing the ddname to be used in place of SYSPRINT, or
eight bytes of blanks (X'40') if SYSPRINT is not to be substituted. The ddname
must be left justified and padded on the right with blanks if necessary.
v An eight-byte field containing the ddname to be used in place of IMS, or eight
bytes of blanks (X'40') if IMS is not to be substituted. The ddname must be left
justified and padded on the right with blanks if necessary.
//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)
/*
The numbers in the following list refer to the JCL statements illustrated in Figure 7.
1. EXEC Indicates the program to be executed.
2. STEPLIB Points to IMS.SDFSRESL, which contains the IMS nucleus and the
required action modules.
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 the RECON data set 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; and the CHANGE.PART command if you change the
KEYSTRNG value.
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).
In This Chapter:
v “General Considerations for Using DBRC”
v “Data Set Naming Conventions”
v “Database Backup Copies” on page 35
v “DBDS Group Considerations” on page 48
v “DB Groups” on page 49
v “Log Record Change Accumulation” on page 43
| v “DBRC Considerations for HALDB Online Reorganization” on page 49
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
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 the RECON data set. DBRC
assumes that data set names specified in quotation marks do not follow the
naming convention. Therefore, DBRC does not check data set names surrounded
by quotation marks.
When you add records to the RECON data set 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 the RECON data set.
This format 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.
cagrpname
The name of the CA group for which you are creating the change
accumulation data set.
CA Indicates that this is a change accumulation data set.
low-level-qualifier
A character string that can be from 1 to 8 alphanumeric characters long
and must be unique for each CA group. The first character must be
alphabetic.
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.
When these utilities run, they can (depending on installation parameters) call
DBRC to update essential information in the RECON data set. 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.
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 43 for a discussion of how to notify
DBRC about these data sets.
Related Reading: See IMS Version 9: Administration Guide: Database Manager for
more information on HSSP processing of DEDB areas.
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 DEDB
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 both an image copy data set and a duplicate image
copy data set in one run of the utility.
Recommendation: 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. Changes already made to the database by active
applications might be missing from the copy because the changes might not have
been physically written to the data set. These changes, however, have been written
to the log. In this case, it is necessary to go back to some earlier point in the logs
to ensure that all changes are applied. How far to go back depends on the type of
database and which image copy utility was used.
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 38 for more
information.
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.
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 the RECON data set.
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:
v To verify the input to the utility (DBRC allows it to run only if the input is
valid.
v Calls DBRC to record information in the RECON data set about the image copy
data sets that it creates.
An image copy record in the RECON data set 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.
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. The database could be
damaged by the combination because the batch processing is not guaranteed to be
physically repeatable.
The Database Image Copy runs offline. It supports a concurrent image copy (CIC)
option that enables you to create an image copy while the database remains online.
The CIC option can create image copies of OSAM data sets and VSAM Entry
Sequenced Data Sets (ESDSs). The Database Image Copy does not support creating
image copies of VSAM Key Sequenced Data Set (KSDSs).
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.
When you run the Database Image Copy utility to take a consistent image copy
(CIC option not specified), 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.
The Database Image Copy 2 utility provides greater database availability when
taking consistent image copies. The database needs to unavailable for update
processing for only a very short period of time while DFSMS establishes a
concurrent copy session. Update processing can then 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 concurrent image copy. The
Database Image Copy 2 utility can copy all supported data set types, including
VSAM KSDSs, while the databases remain online.
Requirement: 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 information about the primary and
secondary copies are recorded in the RECON data set.
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 database recovery. Information
about the image copies are recorded in the RECON data set with image copy type
SMSCIC or SMSNOCIC.
Requirement: The Database Recovery utility must use DBRC when using the
SMSCIC or SMSNOCIC image copy data sets for recovery.
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.
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
38 DBRC Guide and Reference
Backup Considerations
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.
When a consistent 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.
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 the RECON data set 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 the RECON data set 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 the
RECON data set 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.
Related Reading:
v See “Recovery Period of Image Copy Data Sets and GENMAX” for more
information about the RECOVPD parameter.
v See “INIT.DBDS” on page 271 for more information on the REUSE, NOREUSE,
GENMAX, and RECOVPD.
To prevent DBRC from discarding information relating to the earlier copies, specify
the optional recovery period 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.
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 2 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 2. Results of GENJCL.IC Processing When GENMAX and RECOVPD are Specified
with REUSE
Number of
Number of In-Use Image Age of Oldest
Image Data Sets Copies Image Copy GENJCL Result
=GENMAX =GENMAX <RECOVPD Fail (DSP0063I)
>GENMAX =GENMAX <RECOVPD Avail IC DS used (DSP0065I)
=GENMAX =GENMAX >RECOVPD Oldest IC DS reused
>GENMAX =GENMAX >RECOVPD AVAIL IC DS used
Table 3 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 3. Results of GENJCL.IC Processing When GENMAX and RECOVPD are Specified
with NOREUSE
Age of Oldest Image
Number of Image Copies Copy Utility EOJ Result
=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.
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 the RECON data set. 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.
v A run of one of the IMS image copy utilities automatically uses an available
image copy if one exists. If GENMAX has been reached and the oldest image
copy is beyond the recovery period or there is no recovery period, the oldest
image copy data set is made available.
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, if you issue a GENJCL.IC command for a DBDS defined as REUSE,
DBRC generates JCL for only one or two output copies (because you can define
image copy data sets for only one or two copies). If you use the GENJCL.IC
command for the Database Image Copy 2 utility to process a DBDS defined as
REUSE and you want more than two output copies, modify the generated JCL
before you run the job.
DBRC generates JCL so that the oldest DASD data set is always used for output
for 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.
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). 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.
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
in the RECON data set 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 the RECON data set 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 the RECON data set by specifying the AUTH parameter of the
CHANGE.DB command for the database that was just reorganized.
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 the RECON data set (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).
DBRC does not allow DBRC to process any log that contains changes outside the
recovery range because an image copy is not used for Step 2. The recovery range is
defined by the time-stamp recovery record RECOV TO (image copy time) and
RUNTIME values.
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.
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.
Figure 8. What Change Accumulation Does with Redo Data from Divergent Data Streams
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 DB Recovery utility.
Related Reading: See the IMS Version 9: Utilities Reference: Database and Transaction
Manager for detailed instructions on running the Database Change Accumulation
utility.
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.
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 DB Recovery utility only if it represents a complete log subset.
An image copy of the specified database data set is needed and must be identified
to the RECON data set 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
time-stamp 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
to reduce data to a minimum.
When the most recent image copy is used as input to the Change Accumulation
utility and that image copy is a concurrent image copy, changes already made to
the database by active applications might be missing from the copy because the
changes might not have been physically written to the data set. These changes,
however, have been written to the log. In this case, it is necessary to go back to
some earlier point in the logs to ensure that all changes are applied. How far to go
back depends on the type of database and which image copy utility was used.
The point-in-time selected to start the Change Accumulation utility is called the
purge time.
Related Reading:
v See the IMS Version 9: Utilities Reference: System for more information on the
Database Change Accumulation utility.
v See the IMS Version 9: Operations Guide for more information on the change
accumulation process in general.
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.
A Change Accumulation group can contain from one to 32767 members, which
must be registered DBDSs or areas.
You can run the Change Accumulation utility for DBDSs that do not belong to a
Change Accumulation group even with DBRC=YES in effect. However, DBRC does
not verify the input to the utility nor record its output.
If you define a Change Accumulation group with the REUSE parameter and also
use a GENJCL.CA command to generate the job for the Database Change
Accumulation utility, data set reuse can occur. When all available change
accumulation data sets for this Change Accumulation 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 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.
v When you run the Change Accumulation utility and the number of data sets
specified by GRPMAX has been reached, DBRC deletes the record of the change
accumulation data set (from the RECON 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.
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 time-stamp 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 the RECON data set. 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 DD name to operate on the
whole database.
DBDS groups can include ILDS (Indirect List Data Set) and index data sets.
Related Reading: See Chapter 11, “GENJCL Commands,” on page 221 for the
impact of these data sets on the GENJCL commands.
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 9: Command Reference for
more information.
| You can define as many DB groups as you want. Up to 32767 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 the RECON data set.
DB groups are a form of a DBDS group, so they are stored in the RECON data set
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
| The records in the RECON data set that contain HALDB online reorganization
| information are the:
| v HALDB master record
| v Partition DB record
| v DBDS record
| v REORG record
| GENJCL no longer generates DD statements for the HALDB DBDS that is being
| copied because dynamic allocation is recommended for the Database Image Copy
| utility and the Database Image Copy 2 utility. The SYSIN control statement
| identifies which DBDS to copy: either the A-through-J or the M-through-V set of
| data sets. The image copy utility then copies the corresponding active set of data
| sets: A-through-J or M-through-V.
| DBDS Record Definitions: The M-through-V and Y DBDS records are defined in
| the RECON data set with the same attributes as the corresponding A-through-J, L,
| and X DBDS records. The M-through-V and Y DBDS records are added to the same
| The exceptions to the similarities in attributes include DD names, data set names,
| and the DSID. The DSID of the M-through-V and Y data set is the same as the
| corresponding A-through-J, L, and X data set, except that its X'80' bit is set on. For
| the RECON data set list purposes, the X'80' bit is ignored.
| Table 4 shows the data set ID (DSID) DCB number associated with the A-through-J,
| L, and X data sets and the M-through-V and Y data sets.
| Table 4. DSID DCB Numbers for the A-J, L, and X and the M-V and Y Data Sets
| A-J, L, and X Data Sets M-V and Y Data Sets
| DSID DCB
| Number PHIDAM PHDAM PHIDAM PHDAM
| 1 A A M M
| 2
| 3 L L
| 4 B N
| 5 X C Y O
| 6 B D N P
| 7 C E O Q
| 8 D F P R
| 9 E G Q S
| 10 F H R T
| 11 G I S U
| 12 H J T V
| 13 I U
| 14 J V
|
| Support for OLR Coexistence: The DB record header also includes parameters
| that indicate if online reorganization is allowed. These parameters are OLRCAP or
| OLRNOCAP.
| A REORG record is recorded under both the A-through-J, L, and X DBDS and the
| M-through-V and Y DBDS. The REORG record for the DBDS that was the output
| data set indicates that it can be used as input for recovery. The REORG record for
| the DBDS that was the input data set indicates that it cannot be used for recovery
| after online reorganization completes.
| The RECON data set at the tracking site always reflects the current status of the
| covered databases. Counters keep track of outstanding HALDB online
| reorganizations that have been recorded in the RECON data set at the tracking site
| but not yet applied to the databases.
| The recovery information in the two DBDS headers is maintained as if they are one
| logical DBDS. For example, the values for GENMAX, RECOVPD, and CAGRP are
| the same. Any changes that are made to the active DBDS are also made to the
| inactive DBDS.
| There is a one-to-one relationship between each partition data set; for example, A
| correlates to M, B correlates to N, C correlates to O, and so on. You can perform
| online reorganization on any of these data sets (A-through-J, L and X or
| M-through-V and Y) at any time, depending on which set is active before the
| online reorganization starts. Therefore, data sets A and M are one logical data set
| during an online reorganization. After an image copy is taken, DBRC removes any
| extraneous recovery-related records (IMAGE, ALLOC, RECOV, and REORG) from
| the RECON data set. The extraneous records are determined by the maximum
| For example, assume that the GENMAX value for data set A (and M) is 2, and that
| data set A has two image copies. When data set M becomes the active data set and
| an image copy is taken, the image copy cleanup process deletes the oldest image
| copy from data set A, including any of its extraneous recovery records. Another
| image copy of data set M causes the rest of data set A’s image copy and recovery
| records to be deleted. Note that data set A becomes unrecoverable if its image copy
| and recovery records are deleted.
| After these changes take place, the online reorganization must complete; otherwise,
| you must run an offline reorganization to reset the HALDB online reorganization
| settings.
If you define only two RECON data sets and an error occurs on one of them
during operation, the current jobs continue using the remaining one. New jobs
cannot start unless your RECON setting allows a job to start with only one active
RECON data set. If you want to continue operations in dual mode, you can define
a third RECON data set (RECON3). DBRC does not use this spare data set unless
an error occurs on one of the two active RECON data sets. 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 recommended three RECON data set operating configuration.
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 viable
RECON data set, so IMS also abnormally terminates.
In This Chapter:
v “Planning Considerations for the RECON Data Set”
v “Initially Accessing the RECON Data Set” on page 62
v “Records in the RECON Data Set” on page 63
v “Maintaining the RECON Data Set” on page 72
v “Tracking Changes Made to the RECON Data Set” on page 81
Define your RECON data sets specifying VSAM SHAREOPTION(3,3). Ideally, each
data set should be on a different device, channel, control unit, and catalog. The
RECON data sets should also be of different sizes (see “Avoiding RECON Data Set
Space Problems” on page 60).
Recommendations:
v When defining the RECON data sets using Access Method Services (AMS):
– Use the same index control interval (CI) size and data CI size for all the
RECON data sets.
| – Allocate at least twice as much space for an IMS Version 9 RECON data set as
| was allocated for an IMS Version 7 RECON data set during the initial
| upgrade. After the next reorganization of the RECON, you can check the
| amount of space being used and lower the space allocation.
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 Use secondary allocation to safeguard against a RECON data set becoming full.
To eliminate deadlocks (if you are using implementing hardware reserves for the
RECON data sets), the RECON data sets must:
v Be the only objects cataloged in their respective catalogs.
v Be on the same device as their catalogs. When the RECON data sets are
accessed, an enqueue on the RECON data sets can result, followed by an
enqueue on the catalog. When the RECON data sets and catalog are on the same
device, the possibility of conflicts with another job enqueuing the devices in
reverse order is eliminated.
However, other jobs that reserve multiple volumes can cause deadlock if any of the
volumes also contain a RECON data set.
RESERVE: DBRC issues the z/OS RESERVE macro to serialize access to each
RECON data set. DBRC keeps the RECON data sets reserved until it completes its
processing. The more RECON records DBRC must examine or change, the longer it
holds the RECON data sets. The RESERVE macro serializes access to a resource (a
data set on a shared DASD volume) by obtaining control of the volume on which
the resource resides to prevent jobs on other systems from using any data set on
the entire volume. This reserve is done under the major name DSPURI01 and has a
scope of SYSTEMS.
Batch jobs will serialize on another resource name first, before issuing a RESERVE
for the RECON data sets. The resource name for batch is DSPURI02 and has a
scope of SYSTEM. Each job gets control of the resource, based on the position of
the task’s request and whether the request was exclusive or share control. The
queue is not ordered by the priority of tasks. The effect of this serialization of
batch jobs is that an IMS online region never has to wait for more than one batch
job to complete before gaining access to the RECON data set.
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
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 z/OS RESERVE, DEQ, and ENQ macros:
v z/OS MVS Programming: Authorized Assembler Services Reference, GC28-1763
v z/OS MVS Planning: Global Resource Serialization, GC28-1759
The SYNCHRES option can be activated through either the GRSCNFxx parmlib
member or the SETGRS operator command. The GRSDEF statement of GRSCNFxx
contains the SYNCHRES (Y | N) parameter. The default value for SYNCHRES is
| NO. During normal system operation, the operator can modify the setting of
SYNCHRES by issuing the SETGRS command. Activate SYNCHRES by issuing
SETGRS SYNCHRES=YES and deactivate it by issuing SETGRS SYNCHRES=NO.
DEQ: DBRC releases the RECON data sets by using the z/OS DEQ macro.
| Recommendations:
| v In a GRS Star configuration, a RESERVE CONVERSION RNL should be
| implemented for DSPURI01 if all systems accessing the RECON data sets are
| within the sysplex (or GRSPlex).
| Note: If the RECON data sets are accessed by systems that are outside of the
| sysplex, the reserve must not be converted. A SYSTEMS EXCLUSION
| RNL must be implemented instead.
| v In a GRS Ring configuration, a SYSTEMS EXCLUSION RNL should be
| implemented for DSPURI01 so that the RECON is serialized by hardware
| reserve.
| GRS RESERVE CONVERSION RNL
| If you implement GRS RNL CONVERSION by adding the
| QNAME for the RECON data set, DSPURI01, to the conversion list,
| the hardware reserve is eliminated and replaced by a GRS enqueue
| that is communicated to all other sharing z/OS systems.
| Other data sets on the same DASD volume can be used while the
| RECON data set is reserved; this is the benefit of performing the
| RNL conversion. GRS RNL conversion uses CPU and storage and
| affects system performance positively. The performance (in terms
| of least CPU time used, least storage used, and least elapsed time)
| is best using this option in a GRS STAR configuration.
| To implement this method, follow these steps:
| 1. Add the RECON data set QNAME to the RESERVE
| CONVERSION RNL. For example:
| RNLDEF RNL(CON) TYPE(GENERIC) QNAME(DSPURI01)
| 2. Consider carefully the placement of the following VSAM
| QNAMEs: SYSZVVDS and SYSIGGV2.
| Related Reading: For more information on implementing GRS
| RNL CONVERSION, see z/OS MVS Planning: Global Resource
| Serialization.
| GRS SYSTEMS EXCLUSION RNL
| If you implement GRS SYSTEMS EXCLUSION RNL, then GRS
| does not perform global serialization and the RESERVE macro is
| issued. This might work well provided that the RECON data set is
| located on a DASD volume that does not contain other data sets
| that are needed by other z/OS systems.
| To implement this method, follow these steps:
| 1. Add the RECON data set QNAME to the SYSTEMS
| EXCLUSION RNL. For example:
| RNLDEF RNL(EXCL) TYPE(GENERIC) QNAME(DSPURI01)
| 2. Carefully consider the placement of the following VSAM
| QNAMEs; SYSZVVDS and SYSIGGV2.
| Related Reading: The z/OS MVS Planning: Global Resource
| Serialization provides more information about VSAM QNAMEs.
| v See the Informational APAR II10735 for information on performance and tuning
| diagnostics.
When dynamically allocating the RECON data set, omit the DD statements for
RECON1, RECON2, and RECON3.
| Use the TYPE=RECON macro statement of the IMS DFSMDA dynamic allocation
| macro to establish three dynamic allocation parameter lists in IMS.SDFSRESL.
| When multiple processors access the same RECON data sets, keep the
| IMS.SDFSRESL information pertaining to dynamic allocation parameters in
| synchronization on all processors.
Related Reading: See IMS Version 9: Utilities Reference: System for information
about the DFSMDA macro.
Although JCL allocation and dynamic allocation are both valid methods for
allocating RECON data sets, 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 dynamically allocating the RECON data set are:
v All DBRC jobs automatically use the correct and current RECON data sets, and
no JCL statements are left to become outdated.
v You can reorganize and restore RECON data sets, in case of error, without
having to shut down online IMS systems.
If one RECON data set becomes full during online operation, IMS deallocates it.
DBRC responds by copying and reorganizing the good RECON data set to a spare
RECON data set, if one is available. If no spare RECON data set 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 AMS. See “Replacing a Discarded RECON Data
Set” on page 77 for information on replacing a discarded RECON data set. If you
are in single mode, and a spare RECON data set is available, the next time DBRC
accesses the RECON data set, it automatically enters dual-RECON mode. You do
not have to enter the CHANGE.RECON command with the DUAL or REPLACE option.
| following list. Information on all the keywords can be found in the z/OS DFSMS
| Access Method Services for Integrated Catalog Facility.
| CONTROLINTERVALSIZE
| The values used with this keyword affect the total amount of storage used by
| DBRC for VSAM and internal buffers. DBRC uses the Local Shared Resources
| (LSR) option of VSAM to process the RECON data sets. 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 X index_ci_size) + (120 X data_ci_size)
| This amount of storage is used when the index and data CI sizes are the same
| for all RECON data sets. You can change the default number of index or data
| buffers used by DBRC in an online or batch environment with the DSPBUFFS
| Buffer Size Specification Facility.
| DBRC uses one set of internal buffers for each RECON data set to build logical
| records from smaller segments. The size of these buffers depends initially upon
| the CI size or the VSAM maximum record size (LRECL), whichever is smaller.
| After the initial allocation of these buffers, the logical record buffers grow over
| time as the largest logical record on the RECON data set grows. Because only
| the initial allocation of buffers is determined by the VSAM data set definition,
| the storage allocated to internal buffers cannot ultimately be affected by
| changes to either the CI or the record size.
| DBRC divides its own records into segments, each of which is always smaller
| than a single control interval and which is seen by VSAM as a complete
| physical record. VSAM record spanning is not used. Segmenting allows a
| logical RECON record to be as large as 16M bytes independent of the VSAM
| RECORDSIZE parameter.
| 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 exceeds the largest index CI size by
| at least 2048 bytes. Failure to do so can seriously degrade your DBRC
| performance.
| Related Reading: See IMS Version 9: Customization Guide for further details
| about using the DSPBUFFS Buffer Size Specification Facility.
| CYLINDERS
| Specifies the amount of space to allocate to the cluster.
| FREESPACE
| The default values of FREESPACE(0 0) must not be used. While you are
| entering initial information in the RECON data set, 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
| Specifies that the cluster is defined for key-sequenced data.
| KEYS
| KEYS(32 0) is required.
| NAME
| Defines the cluster’s entry name and is required.
| NONSPANNED
| See RECORDSIZE.
| RECORDSIZE
| DBRC always writes physical VSAM records that are less than the CI size in
| length, even though the logical RECON records can be a long as 16 MB.
| Recommendation: Set the maximum record size to be, at most, equal to the CI
| size minus seven bytes and ensure that NONSPANNED is specified. For
| example, if the CI size was defined as 8192 bytes, then RECORDSIZE
| (4086,8185) is appropriate.
| SHAREOPTIONS
| SHAREOPTIONS(3 3) must be specified. The first value is required with
| single-host processors. Both values are required with multiple-host processors.
| SPEED
| This is recommended because the initial load is faster.
| NOWRITECHECK
| Avoid using WRITECHECK. It can degrade the RECON data set I/O
| performance. Using dual RECON data sets eliminates the need for
| WRITECHECK.
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.
Case 4 is the situation where two RECON data sets are available, but one is now
out of date. DBRC does not use the out-of-date RECON data set. Instead, it copies
the up-to-date RECON data set to the spare data set.
Only one RECON data set 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 data set. Otherwise, processing ends.
Figure 10 on page 64 shows the major relationships between RECON record types.
These relationships are described in detail in the sections that follow Figure 10 on
page 64.
Figure 10. Major RECON Record Types and the Relationships Between Them
Related Reading:
v See Appendix B, “Sample Listings from the RECON Data Set,” on page 473 for
details of what the records contain.
v See the IMS Version 9: Diagnosis Guide and Reference for a complete listing of
RECON keys.
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 an OLDS” on page 8 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.
Related Reading: See IMS Version 9: 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 data set repair purposes):
v NOTIFY.PRILOG
v NOTIFY.SECLOG
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.
All groups must have unique names. For example, a DBDSGRP cannot have the
same name as a DBGRP.
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
To describe DL/I databases and DBDSs, DBRC maintains logically related records,
as shown in Figure 11.
Figure 12 shows the relationship of the RECON data set records that represent a
HALDB.
Figure 12. Record Structure for a HALDB in the RECON Data Set
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
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
| – OLRCAP | OLRNOCAP
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 9: 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 13 on page 70
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
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.
Related Reading: See the sample listing in Appendix B, “Sample Listings from the
RECON Data Set,” on page 473.
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.
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.
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 data set.
Related Command: See “NOTIFY.UIC” on page 346 for more information on the
IMAGE COPY 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:
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
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 data set.
Its parameters determine whether it makes one or two copies.
Related Reading: See Chapter 8, “BACKUP Command,” on page 133 for additional
information on the BACKUP.RECON command.
When the RECON data set 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 the RECON data set. This is the image copy
cleanup process.
At the same time that extraneous IMAGE records are deleted from the RECON
data set, 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.
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.
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.
Use the DELETE.LOG INACTIVE command to delete inactive PRILOG and SECLOG
records.
Deleting log records does not prevent the RECON data sets from filling up because
the space freed by deletions might not be reused by VSAM. However, if you delete
the log records before backing up or reorganizing the RECON data set, you are
able to reclaim the space during backup or reorganization.
Related Reading:
v See “DELETE.LOG (for OLDS)” on page 212 for more information on LIST.LOG.
v See “LIST.LOG (for a PRILOG Family)” on page 300 for more information on
DELETE.LOG.
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 data set (the one that
needed reorganization). Before you can delete and redefine this data set, however,
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 data set. If you use JCL in order to allocate data sets,
dynamic deallocation does not occur.
If you do not use dynamic allocation or if a spare RECON data set is not available,
you must wait for the online subsystem and all other subsystems that access the
RECON data set to deallocate it before you can reorganize.
If an I/O error occurs in a RECON data set and two RECON data sets exist, DBRC
attempts to locate a spare data set. If a spare is available, DBRC copies the RECON
data set without the I/O error to the spare RECON data set. DBRC then
establishes the spare as the Copy2 RECON data set.
Recommendation: After the spare RECON data set replaces the RECON data set
that had the error, redefine the discarded RECON data set 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 RECON data sets. See “Replacing
a Discarded RECON Data Set” on page 77for more information.
If DBRC cannot locate a spare RECON data set and you have specified the
STARTNEW parameter of the INIT.RECON command, DBRC continues processing
with one RECON data set. Otherwise, DBRC completes the current job but does
not start new jobs until you define a spare RECON data set.
A Spare RECON data set is available: 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.
If, however, you want to analyze the RECON error, before deleting and redefining
the discarded RECON data set, make a copy of it for later problem diagnosis.
A Spare RECON data set is not available: If a spare RECON is not available, all
currently executing jobs continue processing using the RECON data set 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
data set. This is not recommended as it jeopardizes the integrity of the system.
If one of the data sets in the set of RECON data sets becomes unusable by DBRC,
you need to deallocate the RECON data set that is unusable and allocate a new
spare.
In an RSR environment, the isolated log sender (ILS) starts its own copy of DBRC.
If Automatic RECON Loss Notification is not active, 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 RECON data sets so that you can replace the unusable
RECON data set. Issue a STOP ILS(gsg) command for each started ILS instance.
Then issue START ILS(gsg) to bring up ILS and DBRC again.
It is unlikely that both RECON data sets would be not usable. If, however, both
RECON data sets ever become unusable, follow this procedure:
1. Stop all jobs that require access to the RECON data set.
2. Use the AMS REPRO command to back up the RECON data sets if you can
access both of them. This step is optional, but it is recommended.
3. Use the AMS utility to delete and redefine your RECON data sets.
4. Use the AMS REPRO command to restore one of the RECON data sets.
5. Use the AMS REPRO command to restore the other RECON data set from the
first.
6. Use the LIST.RECON command to list one of the RECON data sets. Evaluate the
list and determine which DBDSs have been updated since you made the
backup in step 2 on page 76. 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 RECON data
sets.
The RECON data sets are now restored and resynchronized with the databases.
Finally, before you proceed with your regular operations, clean up the new
RECON data set by, for example, closing any open, out-of-date OLDSs with the
NOTIFY.PRILOG command.
To redefine a RECON data set 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 if you do not have Automatic
Loss Notification active. Issuing the command causes the online subsystems to
obtain the same Copy1 and Copy2 RECONs and to deallocate the discarded
RECON data set. If you do have Automatic Loss Notification active, all
subsystems are automatically notified to deallocate the discarded RECON data
set. See “RECON Loss Notification” on page 78 for more information on
RECON Loss Notification.
3. Use the AMS DELETE command to delete the discarded RECON data set.
4. Use the AMS DEFINE command to recreate the RECON data set as an empty
VSAM KSDS data set. Use the same procedure that you used originally to
create the RECON data set. See “Creating a RECON Data Set” on page 60.
DBRC obtains the IMSplex name from the SCI Registration exit routine
(DSPSCIX0), or from an EXEC parameter, IMSPLEX. DBRC records the IMSplex
name in the RECON data set when the first use of RECON Loss Notification
occurs for a given RECON data set. Any subsequent attempt at accessing a
RECON data set using a different IMSplex, or no IMSplex, is rejected and message
DSP1136A is issued. Otherwise, RECON Loss Notification is automatically invoked.
If you want to change the IMSplex associated with a set of RECONs, use the
IMSPLEX() or NOPLEX parameter on the CHANGE.RECON command. See
“CHANGE.RECON” on page 179 for more information. To change an
IMSplex/RECON association when a DBRC instance is active, perform the
following procedure to avoid having your command rejected and message
DSP1137I issued:
1. Wait for all DBRC activity on the current IMSplex to cease.
2. Submit a Database Recovery Control utility job to change the IMSplex name.
3. Alter the IMSplex name in DSPSCIX0.
4. Ensure that the new IMSplex SCI is ready.
5. Resume DBRC activity on the new IMSplex.
Related Reading:
v See the IMS Version 9: Common Service Layer Guide and Reference for introductory
information about IMSplexes.
v See the IMS Version 9: Customization Guide for more information on the SCI
Registration exit routine.
v See the IMS Version 9: Utilities Reference: Database and Transaction Manager and the
IMS Version 9: Installation Volume 2: System Definition and Tailoring for more
information about the IMSPLEX EXEC parameter.
In the online region, IMS provides some authorization functions for commands
issued. By default, IMS restricts /RMxxxxxx commands (except for /RMLIST) to the
Master Terminal Operator (MTO).
| You can establish authorization control for DBRC commands through RACF® (or
| an equivalent product), a user exit routine, or both. For example, logon ID SMITH
| could have access to issue an INIT.DB command against DBD PAYROLL but not
| against DBD CUSTOMER.
Related Reading: For more information about using exit routines and RACF for
command authorization, see:
v “Authorizing Commands with RACF” on page 79
The HALDB Partition Definition utility is an ISPF application that allows you to
manage the definitions of IMS HALDBs and their partitions in the RECON data
set, providing functionality equivalent to the following:
v INIT.DB
v INIT.PART
v CHANGE.DB
v CHANGE.PART
v CHANGE.DBDS
v DELETE.DB
v DELETE.PART
v LIST.DB
Authorization for the HALDB Partition Definition utility is controlled using the
same resources as defined for these commands with one exception; the
CHANGE.PART resource is used in place of the CHANGE.DBDS resource.
Related Reading: See the IMS Version 9: Utilities Reference: Database and Transaction
Manager, SC18-7833 for more information about the HALDB Partition Definition
utility.
DBRC uses a list of resource names for command authorization support. See
Appendix C, “Resource Names for Command Authorization,” on page 565.
Different profiles can be used based on the set of RECON data sets being used, but
only one HLQ per RECON data set is allowed. For example, you might use an
HLQ name of PRODRECN for the production RECON data sets and an HLQ name
of TESTRECN for the test RECON data sets.
Related Reading: See IMS Version 9: Customization Guide, for more information on
the DBRC Command Authorization exit (DSPDCAX0).
| outcome of the security product. Therefore, DBRC messages that are put out as a
| result of unsuccessfully invoking the security product will be suppressed.
Related Reading: See IMS Version 9: Customization Guide for more information on
the DBRC Command Authorization exit (DSPDCAX0).
Related Reading: See IMS Version 9: Customization Guide for detailed information
about the RECON I/O exit routine.
In This Chapter:
v “Generating JCL and User-Defined Output”
v “Using IBM-Supplied Skeletal JCL” on page 84
v “Writing Your Own Skeletal JCL” on page 85
v “Contents of the Skeletal JCL Data Set” on page 85
v “Skeletal JCL Syntax” on page 86
Table 7 lists the eight GENJCL commands and what they generate.
Table 7. GENJCL Commands and What They Generate
Command (PDS Member) What the Command Generates
GENJCL.ARCHIVE (ARCHJCL Log Archive utility JCL and control statements
member)
GENJCL.CA (CAJCL member) Database Change Accumulation utility JCL and
control statements
GENJCL.CLOSE (LOGCLJCL member) Log Recovery utility JCL and control statements
GENJCL.IC (ICJCL member) Database Image Copy or Database Image Copy 2
utility JCL and control statements
GENJCL.OIC (OICJCL member) Online Database Image Copy utility JCL and control
statements
GENJCL.RECEIVE (ICRCVJCL Database Recovery utility JCL and control statements
member)
GENJCL.RECOV (RECOVJCL member) Database Recovery utility JCL and control statements
GENJCL.USER (DSPUPJCL member) User-defined output, including JCL and control
statements
Note: Sample JCL for the HALDB INDEX/ILDS Rebuild utility (DSPUPJCL) is
shipped with IMS and can be used with the GENJCL.USER command, 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
the RECON data set 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.”
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 85.
Recommendation: Exercise care when modifying the skeletal JCL, because DBRC
does not verify any of the JCL that is generated.
Execution members are models of the output you are generating. Execution
members can be IBM supplied (as described in “Using IBM-Supplied Skeletal JCL”
on page 84) or supplied by you. Execution members contain symbolic keywords,
which represent information DBRC provides.
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 (see “Specifying Default Members” on page 104 for more
information).
| Control keywords regulate what output is generated by DBRC, based upon what is
| specified on a GENJCL command (for example, what RECON records are to be used
| for keyword substitution).
Simple keywords and control keywords are explained in the following sections:
v “Symbolic Keywords”
v “Using Control Keywords” on page 88
v “Writing Control Keywords” on page 94
v “Understanding Skeletal JCL Default Members” on page 103
Symbolic Keywords
When JCL is generated, symbolic keywords in the skeletal JCL execution members
are replaced with the current keyword value. For example, the IBM-supplied
skeletal JCL execution members use %TIME as a symbolic keyword. When DBRC
encounters %TIME, it replaces it with the time of day. Keyword substitution occurs
each time DBRC encounters a symbolic keyword. Multiple symbolic keywords can
exist in a skeletal JCL execution member.
Symbolic keywords must be assigned a value before you use them. Keyword
values are assigned (or set) in several different ways as specified below:
v The GENJCL command specifies values for some of the symbolic 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 data set 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
symbolic keywords as well as use the symbolic keywords already recognized by
DBRC. For a list of the symbolic keywords that DBRC recognizes, see Appendix A,
“Symbolic Keywords Recognized by DBRC,” on page 435. You can also define your
own symbolic 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 symbolic 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 symbolic 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
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.
| As RECON records are selected, information from them is used to set the values of
| symbolic keywords. Depending on the type of record being selected, the values of
| a particular group of symbolic keywords associated with the selected record are
| set. The group of symbolic keywords associated with particular records are
| discussed in “Writing Control Keywords” on page 94.
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).
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 symbolic keyword. Otherwise, a
concatenated DD statement is generated.
Example:
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 8 on page 90.
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 126.
FIRST
Specifies that the oldest record is to be selected.
LAST
Specifies that the most recent record is to be selected.
| LASTDSET
| Similar to LAST but will ignore empty log records and return the last
| RLDS or SLDS that contains DSN entries. LASTDSET is only valid for
| RLDS and SLDS (including secondary) and will default to LAST if
| specified for any other record type.
(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.
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.
%SET_MEMBER=newmbrname
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.
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 might be invalid.
Example:
And here is what the output from the preceding example of %SET would render:
LOGEND =960111315000
The next 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.
%SET_TIMEFMT(subparm,[subparm],...)
Related Reading: For detailed information about the TIMEFMT keyword, its
parameters, and format, see “TIMEFMT Parameter” on page 127. 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.
Selecting OLDSs
The syntax of the %SELECT keyword to select OLDSs is as follows:
%SELECT OLDS(ssid,olds_qualifier)
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 symbolic
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.
%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
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
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:
%SELECT slds_type(ssid,time_qualifier)
slds_type
Can be specified as SLDS (for the PRISLD) or SSLDS (for the SECSLD). This
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, %SLDUNIT, and %SLDVOLS are null. You can use the LASTDSET
| time qualifier to have the last PRISLDS data set that contains data set entries
| returned. You must use the %DELETE statement in order to ensure that DBRC
| substitutes valid data in the generated JCL. See “Example 4” on page 97.
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 “Understanding the Selection Criteria
Parameter” on page 90.
In the execution member records following the %SELECT keyword, you specify
(using symbolic 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}.
%SLDOTIM The start time of the PRISLDS/SECSLDS. DBRC sets %SLDOTIM 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 last log record of the SLDS.
%SLDCHKT The Checkpoint Types value of the SLDS data set entry. This is a
hexadecimal representation of the bit settings of the value where:
v Bit 0 - simple checkpoint
v Bit 1 - snapq checkpoint
v Bit 2 - dumpq checkpoint
v Bit 3 - purge checkpoint
v Bit 4 - freeze checkpoint
v Bit 5-7 - not used
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
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
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 as follows:
%SELECT RLDS(ssid,time_qualifier )
,max_volumes
SRLDS(ssid,time_qualifier )
,max_volumes
RLDS(dbds_qualifier,time_qualifier )
,max_volumes
| 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. An RLDS record might not contain
| a DSN entry. In this case, the values for %LOGDSN, %LOGUNIT, and %LOGVOLS are null.
| You can use the LASTDSET time qualifier to have the last PRILOG data set that
| contains data set entries returned.
| 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 “Understanding the Selection Criteria Parameter”
| on page 90.
| dbds_qualifier
| DBDS qualifier as specified in “Understanding the Selection Criteria
| Parameter” on page 90. 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 the RECON data
| set.) 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 symbolic
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.
%LOGLRID The log record sequence number of the last log record of the RLDS.
%LOGOTIM The start time of the PRILOG/SECLOG. DBRC sets %LOGOTIM in the
form yydddhhmmsst{offset}.
If no RLDS is recorded in the RECON data set 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)
%SELECT IC(dbds_qualifier,time_qualifier)
In the execution member records following the %SELECT keyword, you specify
(using symbolic 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.
Chapter 5. Skeletal JCL 99
Skeletal JCL Syntax
%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.
%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
%SELECT CA(dbds_qualifier,time_qualifier)
In the execution member records following the %SELECT keyword, you use symbolic
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:
%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
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).
%SELECT ALLOC(dbds_qualifier,time_qualifier)
%SELECT ALLOC(PRILOG,time_qualifier)
In the execution member records following the %SELECT keyword, you use symbolic
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
%SELECT DBDS(dbds_qualifier)
dbds_qualifier
DBDS qualifier is as specified in “Understanding the Selection Criteria
Parameter” on page 90. 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.
In the execution member records following the %SELECT keyword, you use symbolic
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 the
RECON data set. 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.
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.
Using the DEFAULTS parameter and assuming the values are not overridden, the
GENJCL command generates the following:
DATABASE NAME = DIVNTZ04
AREA NAME = DBHVSAM1
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.
In This Chapter:
v “Changing the RECON Data Set to Output Time Stamps in Local Time of
Origin”
v “Locating the Last SLDS Stop Time in RECON” on page 108
v “Adjusting GENMAX When It Is Reached or It Is Too High” on page 109
v “Getting PRILOG Compression to Work” on page 110
v “Getting Notified When the PRILOG Record Exceeds the Maximum Record
Size” on page 111
v “Closing an Open Online PRILOG” on page 111
v “Deleting Log Records” on page 112
v “Working with Subsystem Records (SSYS)” on page 113
v “Removing Authorization Inconsistency Between the SSYS from DB/AREA
Records” on page 114
v “Getting Change Accumulation to Start Processing Logs Again” on page 114
v “Getting Change Accumulation Working When It States Nothing to Process” on
page 114
v “Moving Log Data Sets” on page 115
v “Cataloging Data Sets” on page 115
v “Performing Multiple Cold Starts in a Test Environment” on page 116
v “Avoiding Some Causes of RECON Data Set Enqueue Problems” on page 117
Changing the RECON Data Set to Output Time Stamps in Local Time
of Origin
If the listing of the RECON data set does not list the offset value for time stamps,
the record might have been created when the offset value was different from the
current offset value. Using DBRC commands to change or delete such a record will
result in a “record-not-found” condition because the current offset is applied if it is
not included in the time stamp parameter of the command.
To change the RECON data set to output time stamps in local time of origin, when
they were created, use one of the following:
CHANGE.RECON TIMEFMT(O,O,P,4,PERM)
or
CHANGE.RECON TIMEFMT(O,O,P,2,PERM)
This will permanently change the RECON data set to output time stamps when the
records were originally created with the appropriate offsets in punctuated
four-digit or two-digit year formats. The time stamp listed can be used in
commands such as the following:
CHANGE.PRILOG STARTIME('2002.063 16:11:58.1 -08:00') -
DSSTART('2002.063 16:11:58.1 -08:00') ERROR RLDS
|
| VOLSER=000000 STOPTIME = 04.194 09:02:33.9
| CKPTCT=1 CHKPT ID = 04.194 09:02:33.7
| LOCK SEQUENCE#= 000000000000
Below is the output that results from issuing the previous sample GENJCL.USER
command:
| SLDSDD BEG=041940901412-0700
| END=041940902339-0700
| VOL=000000
| UNT=SYSDA
| DSN=IMSVS.SLDSP.IMS1.D04194.T0901412.V00
| Issue the CHANGE.DBDS command 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.
The current size of the PRILOG record is printed on the listing of the PRILOG
record.
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 commands can be used to
create a dummy DSN entry in the PRILOG:
| NOTIFY.PRILOG SSID(IMS1) RLDS DSN(DUMMY) FIRSTREC(00) -
| STARTIME(042010652499) VOLSER(VOL001)
| NOTIFY.PRILOG SSID(IMS1) RLDS -
| STARTIME(042010652499) RUNTIME(042010753260) LASTREC(500)
| CHANGE.PRILOG STARTIME(042010652499)
| ERROR - DSSTART(042010653260)
Below is the PRILOG as it appears in the RECON data set before issuing the
NOTIFY.PRILOG command to close it:
| PRILOG RECORD SIZE= 464
| START = 04.201 06:52:49.9 * SSID=IMS1 VERSION=9.1
| STOP = 00.000 00:00:00.0 #DSN=2
| GSGNAME=**NULL**
| FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 0
| EARLIEST CHECKPOINT = 04.201 06:52:52.0
|
| DSN=IMSVS.RLDSP.IMS1.D04201.T0652499.V00 UNIT=SYSDA
| START = 04.201 06:52:49.9 FIRST DS LSN= 0000000000000001
| STOP = 04.201 06:53:12.7 LAST DS LSN= 0000000000000642
| FILE SEQ=0001 #VOLUMES=0001
|
| VOLSER=000000 STOPTIME = 04.201 06:53:12.7
| CKPTCT=1 CHKPT ID = 04.201 06:52:52.0
| LOCK SEQUENCE#= 000000000000
|
| DSN=IMSVS.RLDSP.IMS1.D04201.T0653127.V00 UNIT=SYSDA
| START = 04.201 06:53:12.7 FIRST DS LSN= 0000000000000643
| STOP = 04.201 06:53:26.0 LAST DS LSN= 00000000000007A9
| FILE SEQ=0001 #VOLUMES=0001
|
| VOLSER=000000 STOPTIME = 04.201 06:53:26.0
| CKPTCT=0 CHKPT ID = 04.201 06:52:52.0
| LOCK SEQUENCE#= 000000000000
|
| LOGALL
| START = 04.201 06:52:49.9 *
Below is the PRILOG as it appears in the RECON data set after issuing the
NOTIFY.PRILOG command to close it (differences are highlighted):
PRILOG RECORD SIZE= 624
START = 04.201 06:52:49.9 * SSID=IMS1 VERSION=9.1
STOP = 04.201 07:53:26.0 #DSN=3
GSGNAME=**NULL**
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 0
EARLIEST CHECKPOINT = 04.201 06:52:52.0
DSN=IMSVS.RLDSP.IMS1.D04201.T0652499.V00 UNIT=SYSDA
START = 04.201 06:52:49.9 FIRST DS LSN= 0000000000000001
STOP = 04.201 06:53:12.7 LAST DS LSN= 0000000000000642
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.IMS1.D04201.T0653127.V00 UNIT=SYSDA
START = 04.201 06:53:12.7 FIRST DS LSN= 0000000000000643
STOP = 04.201 06:53:26.0 LAST DS LSN= 00000000000007A9
FILE SEQ=0001 #VOLUMES=0001
Related Reading: See “DELETE.LOG (for OLDS)” on page 212 and “DELETE.LOG
(for RLDS and SLDS)” on page 212 for descriptions of the available DELETE.LOG
commands and their parameters.
Use the DELETE.LOG INACTIVE command periodically to keep the RECON data set
free of unnecessary PRILOG family records. Refer to the description of the
DELETE.LOG command INACTIVE parameter for the conditions that must be met
before DBRC deletes a PRILOG family of records. The DELETE.LOG command,
specified with either the INACTIVE or the TOTIME parameter, does not delete
active log records.
Common problems are old open (nonzero stop time) PRILOG records that were
created by jobs that terminated abnormally. These jobs abended without closing
their logs. You can find these open logs by issuing the LIST.LOG command with the
OPEN parameter. You can use the DELETE.LOG command with the STARTIME
parameter to remove old, unnecessary, open PRILOG family records.
Here is a list of some other factors that can affect the PRILOG family of records:
v GENMAX
v Frequency of creating DB Image copies
v RECOVPD
v Log Retention Period
Online image copy is the only BMP that creates its own subsystem record in the
RECON data set.
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.
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.
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 listing of the RECON data set. If
no log volume exists with this start time, there is an unarchived OLDS.
T1--T2---T3--T4-T5--------T6--------T7---------T8----T9---
|---A1---D1--|--------------------A4-----------------// (open)
Log1 (DSN1) (OPEN OLDS)
|--A2--| |--A3-|
Log2 Log3
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.
| 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 for each set of RECON data sets (3) required for an IMS region.
-OR-
//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.
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
/*
| 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
the RECON data set). If you also need to delete the OLDS from the RECON data
set, 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
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.
|
| DDNAME=DFSOLP01 DSN=IMSTESTL.IMS01.OLDSP1
| START = 04.205 20:37:29.1 FIRST DS LSN= 0000000000000643
| STOP = 04.205 20:37:52.6 LAST DS LSN= 00000000000007A9
| LOCK SEQUENCE# = 000000000000
| STATUS=ARC COMPLT FEOV=YES AVAIL
| PRILOG TIME=04.205 20:36:58.7 ARCHIVE JOB NAME=JT203752
| VERSION=9.1
|
| DDNAME=DFSOLP02 DSN=IMSTESTL.IMS01.OLDSP2
| START = 04.205 20:37:52.6 FIRST DS LSN= 00000000000007AA
| STOP = 00.000 00:00:00.0 LAST DS LSN= 0000000000000000
| LOCK SEQUENCE# = 000000000000
| STATUS=ACTIVE FEOV=NO AVAIL
| PRILOG TIME=04.205 20:36:58.7
| VERSION=9.1
| The PRIOLD record after issuing the commands to close and mark DFSOLP02 as
archived (with the differences highlighted):
PRIOLD
SSID=IMS1 # DD ENTRIES=3
EARLIEST CHECKPOINT = 04.205 20:37:02.3
DDNAME=DFSOLP00 DSN=IMSTESTL.IMS01.OLDSP0
START = 04.205 20:36:58.7 FIRST DS LSN= 0000000000000001
STOP = 04.205 20:37:29.1 LAST DS LSN= 0000000000000642
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=YES AVAIL
PRILOG TIME=04.205 20:36:58.7 ARCHIVE JOB NAME=JT203738
VERSION=9.1
DDNAME=DFSOLP01 DSN=IMSTESTL.IMS01.OLDSP1
START = 04.205 20:37:29.1 FIRST DS LSN= 0000000000000643
STOP = 04.205 20:37:52.6 LAST DS LSN= 00000000000007A9
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=YES AVAIL
PRILOG TIME=04.205 20:36:58.7 ARCHIVE JOB NAME=JT203752
VERSION=9.1
DDNAME=DFSOLP02 DSN=IMSTESTL.IMS01.OLDSP2
START = 04.205 20:37:52.6 FIRST DS LSN= 00000000000007AA
STOP = 04.205 21:37:52.6 LAST DS LSN= 00000000000008AA
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=04.205 20:36:58.7
VERSION=9.1
Related Reading: See “RECON Data Set Serialization” on page 57 for more
information.
If you catalog each RECON data set 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 might lead to deadlocks.
In This Chapter:
v “DBRC Batch Commands”
v “DBRC Online Commands” on page 122
v “DBRC Command Syntax” on page 122
| You can also issue a variation of some of these commands online using the
| /RMxxxxxx command (see “DBRC Online Commands” on page 122).
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 9: Command Reference for details pertaining to the
syntax of the online commands (/RMxxxxxx).
v See CICS Transaction System for z/OS CICS Supplied Transaction, SC34-5992 for a
description of CDBM, and CICS Transaction System for z/OS V2R2 IMS Database
Control Guide, SC34-6010, for details of the DBCTL and DBRC commands you
can use with the CDBM transaction.
v See “How to Read Syntax Diagrams” on page 124 for information about the
syntax diagrams and notations used in this book.
v See “Data Set Naming Conventions” on page 33 for information on naming
conventions.
| Related Reading: See IMS Version 9: Command Reference for details on DBRC
| commands that can be entered online and the supported DBRC parameters
| (modifiers) that are associated with those commands.
| After these commands successfully pass through IMS security, IMS passes these
| commands to DBRC where they are processed. These commands are processed in a
| similar manner as the regular DBRC commands of similar name. For example,
| DBRC processes a /RMCHANGE command in a similar manner as a CHANGE command.
| The authorization of these online commands can also be controlled in a similar
| manner as the batch DBRC commands, namely you can use the DBRC Command
| Authorization exit (DSPDCAX0), a security authorization program like RACF, or
| both.
| Related Reading:
| v For more information about DBRC command authorization support, see
| “Preserving the Integrity of the RECON Data Set with DBRC Command
| Authorization Support” on page 78.
| v For the details of using the DBRC Command Authorization Exit (DSPDCAX0),
| see the IMS Version 9: Customization Guide.
You can enter commands in uppercase, lowercase, or mixed case format. DBRC
translates most command input into uppercase format before processing, regardless
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.
v “Comments”
v “Commands”
v “Parameters”
v “How to Read Syntax Diagrams” on page 124
v “DBRC Time Stamps” on page 126
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.
Parameters
Most DBRC commands have both required and optional parameters.
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..)..)
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)
Except where otherwise noted, optional keywords with values have the following
defaults.
Numeric values 0
Character values blank
required_item
required_item
optional_item
If an optional item appears above the main path, that item has no effect on the
execution of the syntax element and is used only for readability.
optional_item
required_item
v 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.
required_item required_choice1
required_choice2
If choosing one of the items is optional, the entire stack appears below the main
path.
required_item
optional_choice1
optional_choice2
If one of the items is the default, it appears above the main path, and the
remaining choices are shown below.
default_choice
required_item
optional_choice
optional_choice
v An arrow returning to the left, above the main line, indicates an item that can be
repeated.
required_item repeatable_item
If the repeat arrow contains a comma, you must separate repeated items with a
comma.
required_item repeatable_item
A repeat arrow above a stack indicates that you can repeat the items in the
stack.
v Sometimes a diagram must be split into fragments. The syntax fragment is
shown separately from the main syntax diagram, but the contents of the
fragment should be read as if they are on the main path of the diagram.
required_item fragment-name
fragment-name:
required_item
optional_item
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 179
for more information on the TIMEZIN parameter.
The time stamp value might have elements truncated on the right, in which case
the omitted element’s digits are assumed to be zeros.
You can truncate the input at the beginning of any element after ddd; so, yyyy|ddd
is acceptable, as is yyyy|ddd|hh. Part of an element cannot be entered: for example,
yyyy|ddd|h is invalid.
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 130.
The same time stamp value could be entered in the following ways:
942520824457
942520824457-0800
94.252/08:24:45.7
TIMEFMT Parameter: Use the optional TIMEFMT parameter to define the form
in which time stamps appear in messages, displays, and listings from DBRC. Each
parameter associated with TIMEFMT is optional and can be omitted by including
only the comma.
Restriction: The parameters that are associated with TIMEFMT are positional.
TIMEFMT( )
offset ,
offset_display , A
A:
form ,
year_size ,
(1)
duration
(2)
precision
Notes:
1 duration can only be set on the CHANGE.RECON command.
2 precision is only valid on the %SET statement.
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
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
the default.
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
time-stamp 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 in Skeletal JCL: 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(....)
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 93 for more
examples of %SET output specifications.
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 the INIT.RECON command are
TIMEFMT(O,N,P,2,TEMP).
Note: The offset is always added to UTC to obtain local time. To obtain UTC from
local time, reverse the sign and add. The time stamp from a record in the RECON
data set, that is PRILOG, lists as:
'1998.030 10:0:00.1 -08:00'
When the time stamp above is entered in a command with the quotes, DBRC finds
the record in the RECON data set with the recorded time as:
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 time stamp, DBRC uses the TIMEZIN value which
might not be correct if a clock change has occurred since the time when the record
was written in RECON.
Time stamps from different RECON listings, even with time stamps displayed in
different formats, can be used freely, so long as the offsets are included.
Listing an allocation record without offset values lists the time stamp as:
99.027 19:03:47.0
The allocation record was written prior to daylight savings change. The time stamp
is entered on a command to list the record without an offset. With TIMEZIN=%SYS
set in RECON, the offset is obtained from current z/OS clock which has changed.
The record is not found in RECON.
v LIST.LOG
v NOTIFY.ALLOC
v NOTIFY.BKOUT
v NOTIFY.CA
v NOTIFY.IC
v NOTIFY.PRILOG
v NOTIFY.RECOV
v NOTIFY.REORG
v NOTIFY.SECLOG
v NOTIFY.UIC
Related Reading: See “Standard Time Stamp Format” on page 126 for more
information on the standard time-stamp format.
In This Chapter:
v “BACKUP.RECON”
BACKUP.RECON
“BACKUP.RECON Usage” contains the details for the BACKUP.RECON command.
BACKUP.RECON Usage
The BACKUP.RECON 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.
BACKUP.RECON Syntax
RECON1
BACKUP.RECON
RECON2
BOTH
//BKUP JOB
//BACKUP1 DD . . .
//BACKUP2 DD . . .
.
.
.
//SYSIN DD *
BACKUP.RECON BOTH
/*
CHANGE.ADS
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, refer to “INIT.ADS” on page 263.
CHANGE.ADS Syntax
CHANGE.ADS ADDN(name) AREA(name) DBD(name)
ADDNNEW(name)
UNAVAIL
ADSN ( name ) AVAIL
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.
CHANGE.BKOUT
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.
CHANGE.BKOUT Syntax
CHANGE.BKOUT SSID(name) UOR(uor) UORTIME(time_stamp)
DELETE( UOR ) PSB(name) ,
ALL
, DBD( name )
name
,
BKO( name )
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.
HALDB Restriction: When using the CHANGE.BKOUT command for HALDBs,
name specifies the name of a HALDB partition.
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.
HALDB Restriction: When using the CHANGE.BKOUT command for HALDBs,
name specifies the name of a HALDB partition.
CHANGE.CA
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.
CHANGE.CA Syntax
CHANGE.CA GRPNAME(name) RECTIME(time_stamp)
CADSN(name)
FILESEQ(value) INVALID 3400
VALID UNIT( unittype )
, COMP
SUBSET
VOLLIST( volser )
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.
CHANGE.CAGRP
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: HALDB, ILDS, and PHIDAM Primary Index DBDSs are not
recoverable and changes to them are not logged. The CHANGE.CAGRP command does
not support these data sets.
CHANGE.CAGRP Syntax
CHANGE.CAGRP GRPNAME(name)
,
CAJCL(member) DEFLTJCL(member) GRPMAX(value) NOREUSE
NODEFLT REUSE
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.
For HALDBs, dbname specifies the name of a HALDB partition. 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
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 225.
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.
For additional information about reusing change accumulation data sets, see
the explanation of the REUSE parameter “INIT.CAGRP” on page 266.
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))
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 the 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 database or area (DB/AREA) record. This
inconsistency occurs when either the SSYS record still has an entry for the
DB/AREA in its authorized databases/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:
v The following restrictions apply when you use the UNAUTH parameter:
– If any parameters other than DBD, AREA, SSID, and ACTIVE | TRACKING
are specified for UNAUTH, the command fails.
– If AREA, ACTIVE, or TRACKING is specified without UNAUTH, the
command fails.
– If the inconsistency between the SSYS and DB/AREA records as described
above does not exist, the command fails.
– If the ACTIVE or TRACKING parameter do not match the SS ROLE field in
the associated subsystem information entry of the specified database or area,
the command fails.
| v When issuing a CHANGE.DB command during a HALDB online reorganization:
| – CHANGE.DB can only be specified for a HALDB partition (TYPE=PART).
| – HALDB online reorganization must have already been attempted for this
| partition (the M-through-V data sets must exist).
| – The ALL parameter can only be used when issuing a CHANGE.DB ALL OLRCAP
| command. All HALDBs that are available to be marked as online
| reorganization capable are marked “OLRCAP.” Those unavailable for change
| (such as HALDBs that are currently authorized) are skipped and are not
| marked as OLRCAP.
| v If you change a VSO DEDB from SHARELVL (2 or 3) to SHARELVL (0 or 1),
| MAS is reset to NOMAS. See “Parameters for CHANGE.DBDS” on page 154 for
| a the description of MAS and NOMAS.
CHANGE.DB Syntax
Use one of the following two diagrams for the CHANGE.DB command.
| ALL
| CHANGE.DB
DBD(name) AUTH NOBACK SSID(name)
NOAUTH BACKOUT(value) SSID(name)
|
| OLRCAP OLRBYTES(value) OLRROOTS(value) OLRSEGS(value)
OLRNOCAP
OLRRGON OLRIMSID(name) OLRDBDS( A ) PINIT
OLRRGOFF NOOWNER M NOPINIT
READON SHARELVL( 0 ) NONRECOV ICREQ TYPEFP
READOFF 1 RECOVABL NOICREQ TYPEIMS
2 USERRCOV
3
|
GSGNAME(gsgname) RCVTRACK PARTSEL(pgmname) (***)
NOTCOVER DBTRACK HIKEY REORGI
NOREORGI
Or:
ACTIVE
TRACKING
Notes:
1 Required if using this command for a Fast Path DEDB
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.
If any of the databases 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, including HALDBs.
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 at a remote site. Message DSP1044I is
issued if you attempt to change the covered state of the database with this
command. In order to change a database not covered at a remote site,
delete and reinitialize the database. Neither Fast Path DEDBs nor
non-recoverable databases can be assigned to a GSG. Neither GSGNAME
nor NOTCOVER can be specified while the database is in use.
ICREQ | NOICREQ
Mutually exclusive, optional parameters used to specify whether DBRC should
enforce the requirement of taking an image copy of a non-recoverable or
user-recoverable database after it has been loaded or reorganized. This option
affects all DBDSs within the DB.
ICREQ
Used to reset the IMAGE COPY NEEDED option. When this option is
active, DBRC will set IC NEEDED ON in the DBDS record and increment
the IMAGE COPY NEEDED COUNT in the DB record following initial
load (PROCOPT=L) or a reorganization of the DBDS.
NOICREQ
Used to disable the IC NEEDED requirement. DBRC will not set IC
NEEDED ON in the DBDS record or increment the IMAGE COPY
NEEDED COUNT in the DB record following initial load or a
reorganization of the DBDS. The IC NEEDED flag can still be set manually
with the CHANGE.DB ICON command.
Restrictions:
v If the DB is recoverable, NOICREQ cannot be specified without also
specifying NONRECOV or USERRCOV.
v NOICREQ will reset all DBDS IC NEEDED values to OFF and the DB
IMAGE COPY NEEDED COUNT to 0.
v If the DB is changed to RECOVABL, this option is reset to ICREQ and IC
NEEDED is set ON in all DBDSs; and the DB IMAGE COPY NEEDED
COUNT is set accordingly.
v ICREQ | NOICREQ cannot be specified with the ALL parameter.
| NOBACK SSID(name) | BACKOUT(value) SSID(name)
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.
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 databases/areas list.
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, including all the
partitions of a HALDB.
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 9: 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 1, 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 9: 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, resets
| the LKASID parameter to NOLKASID, and resets the MAS parameter to
| NOMAS. See “CHANGE.DBDS” on page 152 for explanations of the
| CFSTR1, LKASID, NOLKASID, MAS, and NOMAS 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
| REORGI
| Indicates that the database is going to be reorganized and sets the REORG
| INTENT flag to ON in the database record of the RECON data set if the
| following conditions have been met:
| v Database type is valid. Must be full function including HALDBs.
| v The REORG INTENT flag is off.
| v No batch jobs are authorized to the database.
| v HALDB Online Reorganization (OLR) cannot have cursor active set
| (OLREORG CURSOR ACTIVE=YES).
| v The database cannot be owned by an IMS OLRIMSID=imsid.
| NOREORGI
| Indicates that the database is not going to be reorganized (or has just
| completed reorganization) and sets the REORG INTENT flag to OFF in the
| database record of the RECON data set if the following conditions have
| been met:
| v Database type is valid. Must be full function including HALDBs.
| v The REORG INTENT flag is on.
CHANGE.DBDS
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.
Some attributes of a HALDB DBDS can be changed with this command. See
“CHANGE.PART” on page 164 if you want to change all the DBDSs of a HALDB
partition.
Restrictions for HALDBs: For HALDBs, you can use this command only as
indicated in Table 10 on page 152.
Table 10. CHANGE.DBDS for HALDBs
CHANGE.DBDS Partition Data DBDS Partition Index/ILDS
DBDS
ADDEQE | DELEQE Yes Yes
CFSTR1 N/A N/A
CFSTR2 | NOCFSTR2 N/A N/A
AUTH | NOAUTH N/A N/A
DDNEW | AREANEW No No
DEFLTJCL | NODEFLT Yes No
CHANGE.DBDS Syntax
| CHANGE.DBDS DBD(name) DDN(name)
| AREA(name) ,
ADDEQE( value )
,
DELEQE( value )
|
| CFSTR1(name) CFSTR2(name) AUTH DDNNEW(name)
NOCFSTR2 NOAUTH AREANEW(name)
|
| DEFLTJCL(member) DSN(name) GENMAX(value) GSGNAME(gsgname)
NODEFLT NOTCOVER
|
| ICJCL(member) ICON NOREUSE OICJCL(member) LKASID
ICOFF REUSE NOLKASID
|
| MAS PRELOAD PREOPEN RCVTRACK RECOV
NOMAS NOPREL NOPREO DBTRACK NORECOV
|
| RECOVJCL(member) RECOVPD(value) RECVJCL(member) VSO
NOVSO
|
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
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, use the
INIT.IC command to create additional image copy records in RECON. If the
number of data sets does not equal GENMAX, reuse of the data sets 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.
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,
use the INIT.IC command to add additional data sets; otherwise, reuse of
the data sets does not take place. See “INIT.IC” on page 278 for more
information.
For additional information about reusing image copy data sets, see
“INIT.DBDS” on page 271 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.
| MAS | NOMAS
| Mutually exclusive, optional parameters you use to specify whether a shared
| VSO area is to reside in a multi-area coupling facility structure.
| MAS Indicates that the area is to reside in a multi-area coupling facility
| structure. A second coupling facility structure name (CFSTR2) cannot
| be specified if MAS is specified. If a second structure is already
| defined, the second structure’s name is removed.
| Restrictions: MAS can only be specified if the DEDB is specified as
| SHARELVL (2 or 3) and either VSO is specified or the area is already
| specified as a VSO DEDB. Also, CFSTR2 cannot be specified with MAS
| or cannot be specified if the area is already specified as a multi-area
| coupling facility structure.
| NOMAS
| Indicates that the coupling facility structure (or structures) should
| contain data for only 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 or coupling
| facility structure the next time that it is opened. Selecting this option also
| causes the area to be preopened.
NOPREL
| Indicates that the VSO area is not to be loaded into the data space or
| coupling facility structure the next time that 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 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.
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 a z/OS 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.
CHANGE.DBDSGRP
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.
CHANGE.DBDSGRP Syntax
CHANGE.DBDSGRP GRPNAME(name)
ADDDB( ( dbname ) )
areaname
,
DELDB( ( dbname ) )
areaname
,
Notes:
1 Full-function database name
2 Fast Path DEDB name
ADDMEM(dbname,ddname)
Identifies one or more members to be added to a DBDS group, where
dbname is the database name and ddname is the DD statement name or the
area name.
DELMEM(dbname,ddname)
Identifies one or more members to be deleted from a DBDS group, where
dbname is the database name and ddname is the DD statement name or the
area name.
ADDRECOV(dbname,areaname)
Identifies one or more databases or DEDB areas to be added to a recovery
group, where dbname is the database (or DEDB) name and areaname is the
DD statement name or the area name.
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 databases or DEDB areas to be deleted from a
recovery group, where dbname is the database (or DEDB) name and
areaname is the DD statement name or the area name.
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.
Restrictions for HALDBs: For HALDBs, dbname specifies the name of a HALDB
partition or the HALDB master. When specifying HALDB database names, use the
CHANGE.DBDSGRP command only as defined in Table 11.
Table 11. Supported dbname specifications for HALDBs on CHANGE.DBDSGRP command
parameters
CHANGE.DBDSGRP dbname = HALDB dbname = Partition
Master
ADDDB Yes Yes
DELDB Yes Yes
ADDMEM No Yes
DELMEM No Yes
ADDRECOV Yes No
DELRECOV Yes No
//CHGDBGRP JOB
.
.
.
//SYSIN DD *
CHANGE.DBDSGRP GRPNAME(GRP1) -
ADDMEM((DB1,DD1),(DB2,DD2))
/*
CHANGE.IC
Use a CHANGE.IC command to modify information contained in an image copy
record in RECON.
CHANGE.IC Syntax
CHANGE.IC DBD(name) DDN(name) RECTIME(time_stamp)
AREA(name)
FILESEQ(value) FILESEQ2(value) ICDSN(name) ICDSN2(name)
INVALID INVALID2 RECDCT(value) 3400
VALID VALID2 UNIT( unittype )
3400 ,
UNIT2( unittype )
VOLLIST( volser )
, STOPTIME(time_stamp)
VOLLIST2( volser )
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 that you use to prevent or permit the
| use of an image copy data set as input to a subsequent run of the Database
| Recovery utility (DFSURDB0).
| INVALID
| Prevents the use of the specified image copy data set as input to a
| subsequent run of the Database Recovery utility. If the invalidated image
| copy data set is reused, it is automatically marked as valid. See
| “INIT.DBDS” on page 271 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 the Database Recovery utility.
| The Database Recovery utility expects this image copy data set as input
| unless it is marked as INVALID, in which case the utility expects a
| duplicate image copy data set as input.
INVALID2 | VALID2
| Mutually exclusive, optional parameters that you use to prevent or permit the
| use of a duplicate image copy data set as input to a subsequent run of the
| Database Recovery utility (DFSURDB0).
| INVALID2
| Prevents the use of the specified, duplicate image copy data set as input to
| a subsequent run of the Database Recovery utility. If the invalidated,
| duplicate image copy data set is subsequently reused, it is automatically
| marked as valid. See “INIT.DBDS” on page 271 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 Recovery utility.
| 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 126) 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.
CHANGE.PART
Use a CHANGE.PART command to change attributes of a HALDB partition. The
changes apply to all the DBDSs of the partition. Some attributes such as skeletal
JCL member names can be changed for a single DBDS of a partition by a
CHANGE.DBDS command. See “CHANGE.DBDS” on page 152 for a list of what
can be changed.
Restriction: The IMS DBDLIB data set must be identified in the job stream for the
RECOVERY Control utility with a ddname of IMS if KEYSTRNG is being set.
| Use the DISABLE parameter to temporarily remove a partition from active use.
| Use the ENABLE parameter to return the partition to active use. You would
| normally DISABLE a partition prior to deleting it (see “DELETE.PART” on page
| 215), but do not want to remove all the recovery related information that DBRC
| maintains until the changes have been tested. A partition marked as DISABLE can
| be deleted or made active again by marking it ENABLE. A partition that is
| changed from DISABLE to ENABLE must be recovered before it can be used.
Related Reading: See the IMS Version 9: Administration Guide: Database Manager for
information on designing databases, especially the following:
v “Designing Databases”
v “Naming Conventions”
v “Procedure for Changing PHDAM, PHIDAM, and PSINDEX Partition
Definitions”
CHANGE.PART Syntax
Use one of the following diagrams for the CHANGE.PART command.
DSNPREFX(string) RANDOMZR(name) ANCHOR(value)
HIBLOCK(value) BYTES(value) FBFF(value) FSPF(value)
, GENMAX(value) DEFLTJCL(member)
BLOCKSZE( nnnnn )
ICJCL(member) OICJCL(member) REUSE RECOVJCL(member)
NOREUSE
RECOVPD(value) RECVJCL(member)
Or:
FSPF(value)
Optional parameter used to change 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.
BLOCKSZE(nnnnn)
Optional parameter used to change the block size for OSAM data sets. Specify
an even numeric value no greater than 32766. The block size value is used by
OSAM only. You may specify up to 10 values, one for each data set group
defined in the DBD. Omitted values remain unchanged.
GENMAX(value)
Optional parameter used to change 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 to
255. All partition DBDSs will be changed to use this GENMAX value. The
CHANGE.DBDS command can be used to change this for individual partition
DBDSs.
DEFLTJCL(member)
Optional parameter used to change the 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 changed to use this
DEFLTJCL member. The CHANGE.DBDS command can be used to change this
for individual partition DBDSs.
ICJCL(member)
Optional parameter used to change 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 changed to use this
ICJCL member. The CHANGE.DBDS command can be used to change this for
individual partition DBDSs.
NOREUSE | REUSE
Mutually exclusive, optional parameters used to change 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 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. The NOREUSE parameter prohibits such actions. All partition DBDSs
will be changed to use the parameter specified. The CHANGE.DBDS command
can be used to change this for individual partition DBDSs.
OICJCL (member)
Optional parameter used to change 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 Image Copy
utility for the partition DBDS specified on the GENJCL command. Appropriate
partition DBDSs will be changed to use this OICJCL member. The CHANGE.DBDS
command can be used to change this for individual partition DBDSs.
RECOVJCL(member)
Optional parameter used to change 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 changed to use this RECOVJCL member. The
CHANGE.DBDS command can be used to change this for individual partition
DBDSs.
RECOVPD(value)
| Optional parameter used to change the recovery period for a specified
| partition DBDS. Specify a numeric value from 0 to 999 that represents the
| number of days you want DBRC to maintain sufficient recovery-generation
| information in the RECON data set. All partition DBDSs will be changed to
| use this RECOVPD value. The CHANGE.DBDS command can be used to
| change this for individual partition DBDSs.
RECVJCL(member)
Optional parameter used to change 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
changed to use this RECVJCL member. The CHANGE.DBDS command can be
used to change this for individual partition DBDSs.
| DISABLE | ENABLE
| Mutually exclusive parameters used to change the state of the partition.
| DISABLE marks the partition as unavailable for use by IMS and most utilities.
| In most situations, a partition marked DISABLE will not be known by IMS (it
| is treated as if it is not registered to DBRC). DBRC LIST commands will list
| information about partitions marked DISABLE and the HALDB Partition
| Definition utility (PDU) displays partitions which are marked DISABLE. The
| partition still counts towards the maximum number of partitions which may be
| defined for a HALDB.
| Although a partition that is marked DISABLE is not removed from DBRC
| groups (a CAGROUP, DBDSGRP, DBGROUP and RECOVGRP), it is generally
| not processed as part of the group when the group is used in a DBRC
| command. This also applies to implied groups used in a command. The one
| exception to this is the GENJCL.CA command and the execution of the IMS
| Database Change Accumulation utility. Changes will be accumulated for
| partitions that are members of a CA Group, even when marked DISABLE.
| GENJCL.IC and GENJCL.RECOV commands fail for partitions that are marked
| DISABLE. If the commands specify a group of any kind, partitions that are
| marked DISABLE are skipped, that is, JCL is not generated and no message is
| issued.
| ENABLE makes a partition which had been made DISABLE available for use
| by IMS again. The partition is set to a Recovery Needed status and must be
| recovered before being used by IMS. Setting a partition to ENABLE has the
| same effect as adding a new partition to the HALDB. If the HALDB uses a
| partition selection exit, all the other partitions are set to a Partition
| Initialization Needed status. If the HALDB uses high key values, the partition
| with the next high key value is set to a Partition Initialization Needed status.
| Requirement: When you issue a CHANGE.PART ENABLE command, the IMS
| DBDLIB data set must be identified in the job stream for the Database
| Recovery Control utility with a ddname of IMS.
| The following example changes the partition identified by the DBD and PART
| parameters to a DISABLE status.
| //CHGPART JOB
| ...
| //SYSIN DD *
| CHANGE.PART DBD(DB3) PART(PART3) DISABLE
| /*
ERROR SSID(name)
NORMAL
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.
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.
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.)
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.
, ,
DSSTART(time_stamp) ERROR FILESEQ(value) GAP( ON )
NORMAL OFF
GSG(gsgname) , ,
, PREVGAP( ON )
OFF
OLDVOL( volser )
, 3400
UNIT( unittype )
RUNTIMES( time_stamp )
,
VOLLIST( volser )
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.
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 321 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
126).
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.
The volume serial numbers that you specify in NEWVOL replaces 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 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.
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. Use NEWTIME OLDVOL NEWVOL to change the
stop times of log volumes. If you do specify RUNTIMES, you must also specify
VOLLIST. The following parameter sets are mutually exclusive:
v NEWTIME
v OLDVOL
v NEWVOL
v RUNTIMES
v VOLLIST
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 126).
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 321.
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, and 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
for CHANGE.PRILOG (for RLDS)” on page 172 for an explanation of how the
two parameters interact. The following parameter sets are mutually exclusive:
v NEWTIME
v OLDVOL
v NEWVOL
v RUNTIMES
v VOLLIST
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
/*
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.
, ,
DSSTART(time_stamp) ERROR FILESEQ(value) GSG(gsgname)
NORMAL
, ,
, , SSID(name)
3400 ,
UNIT( unittype )
VOLLIST( volser )
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 126). 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 126).
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 326 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 126).
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.
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. Use the NEWTIME, OLDVOL, and NEWVOL
parameters to change the stop times of log volumes. If you do specify
RUNTIMES, you must also specify VOLLIST. The following parameter sets are
mutually exclusive:
v NEWTIME
v OLDVOL
v NEWVOL
v RUNTIMES
v VOLLIST
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 126).
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 326.
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
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
Use a CHANGE.RECON command to update options in the RECON status record.
CHANGE.RECON Syntax
| CHANGE.RECON
| CATDS CDSLID(value)
NOCATDS
|
| CMDAUTH( SAF ,safhlq ) DASDUNIT(unittype)
EXIT
BOTH
NONE
|
| DUAL FORCER NOCHECK IMSPLEX(imsplex_name)
REPLACE(RECONn) NOFORCER CHECK17 NOPLEX
CHECK44
|
| LISTDL LOGALERT( dsnum,volnum ) LOGRET('time_interval')
NOLISTDL
|
| MINVERS( '7.1' ) REORGV SSID(name)
'8.1' NOREORGV
'9.1'
|
| SIZALERT(dsum,volnum,percent) STARTNEW TAPEUNIT(unittype)
NONEW
|
| TRACEON ,
TRACEOFF
TIMEZONE( (label , ) )
(1)
offset
|
| TIMEZIN( offset_rep,duration ) TIMEFMT(sublist) UPGRADE
|
Notes:
1 The offset subparameter of the TIMEZONE parameter must be omitted in
order to delete an entry.
| 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.
| If log data sets are SMS-managed, select the CATDS option and remove the
| %LOGVOLS keyword from skeletal JCL member CAJCL.
| 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 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.
| CDSLID(value)
| CDSLID sets the cross-DBRC service level ID in the RECON data set. The
| service level ID indicates that the maintenance corresponding to the given
| value has been applied to all systems that will be accessing this RECON data
| set.
| Occasionally, maintenance must be applied to all systems that access the same
| RECON data set before you enable that maintenance. The ++HOLD card
| associated with the maintenance will indicate the need to issue the
| CHANGE.RECON CDSLID() command.
| This command is used to enable the function provided by the maintenance
| after the maintenance has been applied to all the systems. The value to specify
| on the command will be indicated in the ++HOLD card.
| After the cross-DBRC service level ID is set, all maintenance related to any
| service level ID less than or equal to the value set will be activated. If, after
| enabling some maintenance, you find that a system does not yet have the
| maintenance applied, to deactivate the enabled function specify a value less
| than the enabling service level ID. For example if service level ID 5 was set in
| the RECON data set, issuing a CHANGE.RECON CDSLID(3) command would
| deactive functions associated with IDs 4 and 5.
| The following table describes the maintenance that is associated with a
| particular service level ID:
| Table 12. Service Level IDs and Associated Required Maintenance
| Service level ID Associated maintenance
| 1 v PQ98438 (for IMS V7)
| v PQ98654 (for IMS V8)
| v PQ98655 (for IMS V9)
|
| CMDAUTH(SAF,safhlq | EXIT,safhlq | BOTH,safhlq | NONE)
Optional parameter you use to specify whether DBRC command authorization
is to be performed.
Specification of this parameter will result in command authorization being
performed using the specified command authorization setting. However, in
order to turn off command authorization (specifying NONE), you must be
authorized under the current command authorization setting.
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.
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 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
DD statement, the utility stops.
IMSPLEX(imsplex_name) | NOPLEX
Mutually exclusive, optional parameters you use to change the IMSplex name
associated with the RECON. CHANGE.RECON cannot be used to set an initial
IMSplex name in the RECON.
| There can be no other DBRC instances that are registered to SCI accessing the
| RECON when this command is processed. The DBRC instance processing the
| command must be using the IMSplex name that is currently saved in the
| RECON.
The IMSplex name in the RECON should only be changed when your SCI
registration exit, DSPSCIX0, is changed to return the new IMSplex name.
There is no default for this parameter. If neither is specified, the current setting
is unchanged.
Note: If DSPSCIX0 is not found, DBRC will behave as though the sample exit
were used. So, if the IMSPLEX parameter is not used, DBRC will
assume that RECON Automatic Loss Notification is inactive. When the
IMSPLEX parameter is used, DBRC will use its value to register with
SCI.
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.
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 16M record size maximum.
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.
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 126 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, 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') x= 10 days, 12 hours, 30 minutes
Related Reading: See “DELETE.LOG (for RLDS and SLDS)” on page 212 for
more information on deleting inactive logs.
| MINVERS('7.1' | '8.1' | '9.1')
| Optional parameter that you use to specify the lowest version of IMS allowed
| to sign on. This keyword cannot be set to a higher IMS release if any
| subsystems with a lower version of IMS are currently signed on to DBRC.
| When the UPGRADE keyword is specified on a CHANGE.RECON command and
| the MINVERS value is less than '7.1', the MINVERS value is set to a default of
| '7.1' in the new RECON.
| Note: The IMS Version 9 format for the MINVERS keyword includes a period.
| DBRC considers this a special character and requires it to be enclosed in
| single quotes. The format from earlier versions (71 | 81 | 91) is also
| accepted for compatibility.
| REORGV | NOREORGV
| Mutually exclusive, optional parameters you use to modify the HALDB
| partition reorganization number verification. A CHANGE command with these
| parameters is allowed while databases are currently authorized to other
| subsystems.
| REORGV
| Specifies that HALDB partition reorganization number verification is
| enabled. The RECON will store the reorganization number for each
| partition to prevent the reorganization number from being regressed, or
| incremented by more than one. After a CHANGE.RECON REORGV
| command is issued, the partition reorganization number in each partition
| record is set to zeros.
| NOREORGV
| Specifies that HALDB partition reorganization number verification is
| disabled. Any requests to store, update or verify the reorganization number
| will be ignored.
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
DSP0387W 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 16M record size maximum.
percent
This value applies to all records. The threshold is reached when a record
exceeding percent percentage of the 16MB record size maximum.
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
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.
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 189.
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 z/OS 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 126 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” on page 127.
UPGRADE
| Optional parameter that you use to upgrade all IMS Version 7 and IMS Version
| 8 RECON records to an IMS Version 9 level. 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. When UPGRADE is specified, a default of
| 71 is set for the MINVERS value in the new RECON.
| 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.
| 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 mode
| 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 mode
| Other jobs are currently accessing the RECON. These jobs can be either
| Version 7 or Version 8 and must have the respective Version 9 SPE
| applied. Two RECONs plus a spare must be allocated for a concurrent
| upgrade.
| When an upgrade is performed, an existing HALDB is marked (in the RECON)
| to indicate that it is not capable of being reorganized online with the HALDB
| Online Reorganization function. To enable the HALDB for online
| reorganization, use the CHANGE.DB DBD(HALDB_master)OLRCAP command.
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.
SSID(name)
subsystem identifier in the RECON header record. If you have not specified a
default in the RECON header record, you must specify SSID.
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.
, ,
DSSTART(time_stamp) ERROR FILESEQ(value) GSG(gsgname)
NORMAL
, ,
, ,
3400 ,
UNIT( unittype )
VOLLIST( volser )
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 following parameter sets are mutually exclusive:
v NEWTIME
v OLDVOL
v NEWVOL
v RUNTIMES
v VOLLIST
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 321 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
126).
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.
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. Use the NEWTIME, OLDVOL, and NEWVOL
parameter set to change the stop times of log volumes. If you do specify
RUNTIMES, you must also specify VOLLIST. The following parameter sets are
mutually exclusive:
v NEWTIME
v OLDVOL
v NEWVOL
v RUNTIMES
v VOLLIST
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 126).
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 321.
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 NEWTIME, OLDVOL,
and NEWVOL parameter set 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
for CHANGE.PRILOG (for RLDS)” on page 172 for an explanation of how the
two parameters interact. The following parameter sets are mutually exclusive:
v NEWTIME
v OLDVOL
v NEWVOL
v RUNTIMES
v VOLLIST
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.
, , DSSTART(time_stamp)
ERROR FILESEQ(value) GSG(gsgname) ,
NORMAL
NEWTIME( time_stamp )
, , ,
SSID(name) 3400 ,
UNIT( unittype )
VOLLIST( volser )
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 126). 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 126).
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 following parameter sets are mutually exclusive:
v NEWTIME
v OLDVOL
v NEWVOL
v RUNTIMES
v VOLLIST
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 326 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 126).
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. Use the NEWTIME, OLDVOL, and NEWVOL
parameter set to change the stop times of log volumes. If you do specify
RUNTIMES, you must also specify VOLLIST. The following parameter sets are
mutually exclusive:
v NEWTIME
v OLDVOL
v NEWVOL
v RUNTIMES
v VOLLIST
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 126).
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 326.
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
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.
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
/*
CHANGE.SG
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.
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.
CHANGE.SG Syntax
CHANGE.SG SGNAME(sgname) GSGNAME(gsgname)
ACTIVE LOCAL NORTA
TRACKING NONLOCAL
CHANGE.SUBSYS
Use a CHANGE.SUBSYS command to modify information that is contained in a
subsystem record in RECON.
CHANGE.SUBSYS Syntax
ALL
CHANGE.SUBSYS
SSID(name) BACKIRLM(name) IRLMID(name) NORMAL
NOBACKUP ABNORMAL
STARTRCV TRACKING
ENDRECOV
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.
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.
CHANGE.UIC
Use a CHANGE.UIC command to modify information in the image copy record in
RECON that corresponds to a nonstandard image copy data set.
CHANGE.UIC Syntax
CHANGE.UIC DBD(name) DDN(name) RECTIME(time_stamp) UDATA('string')
AREA(name)
DELETE.ADS
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.
DELETE.ADS Syntax
DELETE.ADS ADDN(name) AREA(name) DBD(name)
DBD(name)
Required parameter you use to identify the database name of the area that is
to be deleted.
DELETE.ALLOC
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
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.
DELETE.ALLOC Syntax
DELETE.ALLOC DBD(name) DDN(name) RECTIME(time_stamp)
AREA(name)
//DELALLOC JOB
.
.
.
//SYSIN DD *
DELETE.ALLOC DBD(DBDKSDS1) DDN(DDNKSDS1) -
RECTIME(840231102234)
/*
DELETE.BKOUT
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.
DELETE.BKOUT Syntax
DELETE.BKOUT SSID(name)
DELETE.CA
Use a DELETE.CA command to delete from RECON a change accumulation run
record for a specified CA group.
DELETE.CA Syntax
DELETE.CA GRPNAME(name) RECTIME(time_stamp)
DELETE.CAGRP
Use a DELETE.CAGRP command to delete a CA group record and all associated CA
run records from RECON.
DELETE.CAGRP Syntax
DELETE.CAGRP GRPNAME(name)
DELETE.DB
Use a DELETE.DB command to delete from RECON a database and all information
related to the database that has been recorded in the RECON. If the database is a
HALDB, the database and all its partitions are deleted. If the named database is a
HALDB partition, the command fails. Use DELETE.PART command to delete a
HALDB partition. If the database or any partition of a HALDB database is in use,
the command fails and none of the RECON records are deleted.
Related Reading: See the IMS Version 9: Administration Guide: Database Manager for
information on designing databases, especially “Procedures for Changing PHDAM,
PHIDAM, and PSINDEX Partition Definitions.”
DELETE.DB Syntax
DELETE.DB DBD(name)
DELETE.DBDS
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.
DELETE.DBDS Syntax
DELETE.DBDS DBD(name) DDN(name)
AREA(name)
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.
DELETE.DBDSGRP
Use a DELETE.DBDSGRP command to delete the record of a specified DBDS group
from RECON.
DELETE.DBDSGRP Syntax
DELETE.DBDSGRP GRPNAME(name)
DELETE.GSG
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.
DELETE.GSG Syntax
DELETE.GSG GSGNAME(gsgname)
DELETE.IC
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.
DELETE.IC Syntax
DELETE.IC DBD(name) DDN(name) RECTIME(time_stamp) ICDSN2(name)
AREA(name)
//DELIC JOB
.
.
.
//SYSIN DD *
DELETE.IC DBD(DBDKSDS1) AREA(AREA006) -
RECTIME(841231223221) ICDSN2(IMS.*.ICDSN5)
/*
INTERIM
TOTIME(time_stamp)
TRACKING SSID(name)
LISTDL
NOLISTDL
SSID(name)
Required parameter (when you specify TRACKING) that specifies the
subsystem name of the RSR tracking IMS subsystem that created the SLDSs to
be deleted.
The SSID is an eight-character string of any alphanumeric characters that
comprise a valid IMS subsystem identification name.
Restriction: The default SSID specified on the INIT.RECON or CHANGE.RECON
command is not used on this form of the DELETE.LOG 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.
Requirement: This parameter must be specified with SSID and either
STARTIME or TOTIME.
Restrictions:
v If TRACKING is specified, neither DSN nor INACTIVE can be specified.
v If INTERIM is specified, only the TIPSL and TISSL records are deleted.
DELETE.PART
Use a DELETE.PART command to delete from RECON a HALDB partition and all
information related to the partition that has been recorded in the RECON. If the
partition, or any other partition affected by the deletion, is in use, the command
fails and none of the RECON records are deleted.
Related Reading: See the IMS Version 9: Administration Guide: Database Manager for
information on designing databases, especially ″Procedures for Changing PHDAM,
PHIDAM, and PSINDEX Partition Definitions.″
DELETE.PART Syntax
DELETE.PART DBD(name) PART(name)
PART(name)
Required parameter you use to identify the HALDB partition name to be
deleted.
DELETE.RECOV
Use a DELETE.RECOV command to delete a specified recovery run record from
RECON. Specifying DELETE.RECOV for the recovery run record of a time-stamp
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 time-stamp
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 time-stamp recovery
occurred.
DELETE.RECOV Syntax
DELETE.RECOV DBD(name) DDN(name) RECTIME(time_stamp)
AREA(name)
DELETE.REORG
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.
DELETE.REORG Syntax
DELETE.REORG DBD(name) DDN(name) RECTIME(time_stamp)
DELETE.SG
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.
DELETE.SG Syntax
DELETE.SG GSGNAME(gsgname) SGNAME(sgname)
DELETE.SUBSYS
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.
To close the subsystem log, issue the NOTIFY.PRILOG command, and then issue the
DELETE.SUBSYS command.
DELETE.SUBSYS Syntax
DELETE.SUBSYS SSID(name)
DELETE.UIC
Use a DELETE.UIC command to delete the record of a nonstandard image copy data
set from RECON.
DELETE.UIC Syntax
DELETE.UIC DBD(name) DDN(name) RECTIME(time_stamp)
AREA(name)
GENJCL.ARCHIVE
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 “Generating JCL and
User-Defined Output” on page 83.
GENJCL.ARCHIVE Syntax
ALL
GENJCL.ARCHIVE
, ,
JOB NOLIST
JCLOUT JCLPDS JOB(member) LIST
JCLOUT( ddname ) JCLPDS( ddname ) NOJOB
MAXOLDS(n) MEMBER(member) SSID(name) TIMEFMT(sublist)
,
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 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(time_stamp)
Specifies that only tracking log data sets with start times older than or
equal to time_stamp 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 that 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 that 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.
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 “Generating JCL and User-Defined Output” on
page 83.
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.
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” on page 127.
v See “TIMEFMT Subparameter Order of Precedence” on page 129 for
information on the precedence of the subparameters.
v See “Standard Time Stamp Format” on page 126 for examples of the
different output forms.
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.
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)
/*
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)
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.
//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
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
“Generating JCL and User-Defined Output” on page 83.
GENJCL.CA Syntax
GENJCL.CA GRPNAME(name)
, JCLOUT
JCLOUT( ddname )
DEFAULTS( member )
JOB NOLIST
JCLPDS JOB(member) LIST MEMBER(member) NODEFLT
JCLPDS( ddname ) NOJOB
TIMEFMT(sublist) 3400
UNIT( unittype )
, ,
VOLNUM(value)
CATIME(time)
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 “Generating JCL and User-Defined Output” on page 83.
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.
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” on page 127.
v See “TIMEFMT Subparameter Order of Precedence” on page 129 for
information on the precedence of the subparameters.
v See “Standard Time Stamp Format” on page 126 for examples of the
different output forms.
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' | %key1, %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.
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)
/*
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.
//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
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 “Generating JCL and User-Defined Output” on page 83.
GENJCL.CLOSE Syntax
GENJCL.CLOSE
, JCLOUT
JCLOUT( ddname )
DEFAULTS( member )
JOB NOLIST
JCLPDS JOB(member) LIST MEMBER(member)
JCLPDS( ddname ) NOJOB
OLDS(ddname) SSID(name) TIMEFMT(sublist)
,
LIST | NOLIST
Mutually exclusive, optional parameters that 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 “Generating JCL and User-Defined Output” on
page 83.
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.
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” on page 127.
v See “TIMEFMT Subparameter Order of Precedence” on page 129 for
information on the precedence of the subparameters.
v See “Standard Time Stamp Format” on page 126 for examples of the
different output forms.
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.
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
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 “Generating JCL and User-Defined Output” on page 83.
Important:
v 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.
| v For HALDB DBDSs, the GENJCL.IC command does not generate DD statements
| for the DBDSs to be copied. The SYSIN control statement identifies which active
| DBDSs to copy. These can be either the A-through-J data set or the M-through-V
| data sets.
Related Reading: See the IMS Version 9: Utilities Reference: Database and Transaction
Manager for an overview of the Database Image Copy utility and the Database
IMage Copy 2 utility.
GENJCL.IC Syntax
| GENJCL.IC DBD(name)
| GROUP(name) COPIES( 1 ) DDN(ddname)
2 AREA(name)
3
4
| CIC
|
NOCIC ,
SMSCIC
(Sameds) DEFAULTS( member )
(Compress)
(n)
(Sameds,Compress)
(Sameds,Compress,n)
(Compress,n)
DBREL(L)
SMSNOCIC
(Sameds) DBREL(P)
(Compress)
(n)
(Sameds,Compress)
(Sameds,Compress,n)
(Compress,n)
| JOB NOLIST
|
JCLOUT JCLPDS JOB(member) LIST
JCLOUT( ddname ) JCLPDS( ddname ) NOJOB
| MULTIJOB
|
MEMBER(member) ONEJOB NODEFLT TIMEFMT(sublist)
|
| 3400 3400 3400
UNIT( unittype ) UNIT2( unittype ) UNIT3( unittype )
|
| 3400 ,
UNIT4( unittype )
USERKEYS( ( %key1, 'value' ) )
%key2
|
| , , ,
|
| ,
VOLLIST4( volser )
If the specified DBDS is identified in RECON with the REUSE attribute, the
COPIES parameter is not allowed. The number of copies is determined by the
number of pre-defined image copy data sets specified on the INIT.IC
command.
DDN(name) | AREA(name)
Mutually exclusive, optional parameters that 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(Sameds | Compress | n | any combination) |
| SMSNOCIC(Sameds | Compress | n | any combination | DBREL(L | P)
| Optional parameters that you use to indicate how the image copy is to be
| taken.
| Restriction: CIC and SMSCIC cannot be used for nonrecoverable or
| user-recoverable databases.
| CIC
| Specifies that the Database Image Copy (DFSUDMP0) utility is to be used
| to take an image copy. If CIC is specified, the copy is concurrent with
| update processing.
| NOCIC
| Specifies that the Database Image Copy (DFSUDMP0) utility is to be used
| to take an image copy. If NOCIC is specified, the copy is made while the
| database is unavailable for update processing.
| SMSCIC(Sameds | Compress | n | any combination)
| 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 DFSMSdss to dump the database data set or sets using the
| Concurrent Copy option.
| Sameds
| An optional parameter you use to specify that all the image copies
| generated by the job are to be written to a single output data set. This
| option is not valid if any of the DBDs or areas have the REUSE
| attribute, if ONEJOB is not specified, or if more than 255 data sets
| and/or areas are to be copied. You can abbreviate this option when
| specifying it. When a DBDS group (explicit or implicit) is specified, this
| option applies to all members of the group.
| Compress
| An optional parameter you use to indicate that the utility is to specify
| the DFSMSdss compress option. 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. You can abbreviate this option when
| specifying it. When a DBDS group (explicit or implicit) is specified, this
| option applies to all members of the group.
| n An optional parameter you use to specify the value to be used for the
| DFSMSdss OPTIMIZE parameter. n is a number from 1 to 4 where:
| v If n is 1, DFSMSdss reads one track at a time.
| v If n is 2, DFSMSdss reads two tracks at a time.
| v If n is 3, DFSMSdss reads five tracks at a time.
| v If n is 4, DFSMSdss reads one cylinder at a time.
| If n is not specified, the default is 1 for SMSCIC and 4 for SMSNOCIC.
| Note that higher values use more real and virtual storage, and keeps
| the channel busy for longer blocks at a time. You can abbreviate this
| option when specifying it. When a DBDS group (explicit or implicit) is
| specified, this option applies to all members of the group.
| SMSNOCIC(Sameds | Compress | n | any combination | DBREL(L | P)
| 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 DFSMSdss to dump the database
| data set(s) using the Concurrent Copy option.
| Sameds
| An optional parameter you use to specify that all the image copies
| generated by the job are to be written to a single output data set. This
| option is not valid if any of the DBDs or areas have the REUSE
| attribute, if ONEJOB is not specified, or if more than 255 data sets
| and/or areas are to be copied. You can abbreviate this option when
| specifying it. When a DBDS group (explicit or implicit) is specified, this
| option applies to all members of the group.
| Compress
| An optional parameter you use to indicate that the utility is to specify
| the DFSMSdss compress option. 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. You can abbreviate this option when
| specifying it. When a DBDS group (explicit or implicit) is specified, this
| option applies to all members of the group.
| n An optional parameter you use to specify the value to be used for the
| DFSMSdss OPTIMIZE parameter. n is a number from 1 to 4 where:
| v If n is 1, DFSMSdss reads one track at a time.
| v If n is 2, DFSMSdss reads two tracks at a time.
| v If n is 3, DFSMSdss reads five tracks at a time.
| v If n is 4, DFSMSdss reads one cylinder at a time.
| If n is not specified, the default is 1 for SMSCIC and 4 for SMSNOCIC.
| Note that higher values use more real and virtual storage, and keeps
| the channel busy for longer blocks at a time. You can abbreviate this
| option when specifying it. When a DBDS group (explicit or implicit) is
| specified, this option applies to all members of the group.
| DBREL(L | P)
| Indicates when the database is to be made available for update
| processing. DBREL is applicable only when SMSNOCIC is also
| specified. IMS ignores DBREL when it is specified with SMSCIC.
MULTIJOB | ONEJOB
Mutually exclusive, optional parameters that you use to control how many JOB
and EXEC 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 job with:
v A separate step for each group member with the CIC or NOCIC option.
v A single step to copy all members of the group with the SMSCIC or
SMSNOCIC option.
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.
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)
The EXEC and SYSIN statements for the generated JCL are shown below:
.
.
.
//IC1 EXEC PGM=DFSUDMP0,REGION=nnnK,
// PARM='CIC,GSGNAME='
//D1OU1 DD DSN=...
.
.
.
//SYSIN DD *
D1 DBDKSDS1 DDNKSDS1 D1OU1
/*
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='
//D1OU1 DD DSN=...
.
.
.
//SYSIN DD *
D1 DBD1GRP1 DDN1GRP1 D1OU1
/*
//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 . . .
.
.
.
//SYSIN DD *
GENJCL.IC DBD(DBDVSAM1) DDN(DDNVSAM1) COPIES(4) SMSCIC(1) -
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 D1OU1 D2OU1 D3OU1 D4OU1 S 1
/*
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
/*
The following are the EXEC and SYSIN cards in the generated JCL:
.
.
.
//IC1 EXEC PGM=DFSRRC00,REGION=800K,
// PARM='ULU,DFSUDMT0,,,,,,,,,,,,Y,,,,,,,,'
//D1OU0 DD DSN=...
//SYSIN DD *
G DHVNTZ02 S C1
1 DHVNTZ02 HIDAM D1OU0
S DHVNTZ02 HIDAM2 /*
GENJCL.OIC
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 “Generating
JCL and User-Defined Output” on page 83.
Important:
v 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.
| v For HALDB DBDSs, the GENJCL.IC command does not generate DD statements
| for the DBDSs to be copied. The SYSIN control statement identifies which active
| DBDSs to copy. These can be either the A-through-J data set or the M-through-V
| data sets.
Restriction: The GENJCL.OIC command and online image copy cannot be used on
databases at an RSR-tracking site.
GENJCL.OIC Syntax
GENJCL.OIC DBD(name) PSB(name)
GROUP(name) CHKINT(value) COPIES( 1 )
2
DDN(ddname) , JCLOUT
JCLOUT( ddname )
DEFAULTS( member )
JOB NOLIST
JCLPDS JOB(member) LIST MEMBER(member)
JCLPDS( ddname ) NOJOB
MULTIJOB
ONEJOB NODEFLT TIMEFMT(sublist) 3400
UNIT( unittype )
3400 ,
UNIT2( unittype )
USERKEYS( ( %key1, 'value' ) )
%key2
, ,
DBD
Specifies the name of the DBDS or DEDB area that is to be copied.
Restriction for HALDBs: For the GENJCL.OIC command, name specifies the
name of either a HALDB master database 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.OIC command executes repeatedly, once for each
DBDS of the DBDS group.
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.
NODEFLT
Optional parameter you use to specify that the implicit skeletal JCL default
member, if any, for the DBDS is not to be used.
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” on page 127.
v See “TIMEFMT Subparameter Order of Precedence” on page 129 for
information on the precedence of the subparameters.
v See “Standard Time Stamp Format” on page 126 for examples of the
different output forms.
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.
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.
GENJCL.RECEIVE
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
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 “Generating JCL and User-Defined Output” on page
83.
GENJCL.RECEIVE Syntax
GENJCL.RECEIVE DBD(name)
GROUP(name) , DDN(ddname)
AREA(name)
DEFAULTS( member )
JOB NOLIST
JCLOUT JCLPDS JOB(member) LIST
JCLOUT( ddname ) JCLPDS( ddname ) NOJOB
MEMBER(member) TIMEFMT(sublist)
,
DBD
Specifies the name of the database to be received. The database must be
RSR-covered.
Restriction for HALDBs: For the GENJCL.RECEIVE command, name specifies
the name of either a HALDB master database 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 that 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.
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.
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.
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)
/*
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,
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
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 time-stamp recovery of a specified DBDS
or area. All log data must be archived; otherwise the GENJCL.RECOV command fails.
Restrictions:
v 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.
v A GENJCL.RECOV command cannot be issued for a user-recoverable database.
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
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 “Generating JCL and User-Defined Output” on page 83.
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 470 for information about IBM-supplied sample JCL
that you can use.
GENJCL.RECOV Syntax
GENJCL.RECOV DBD(name)
GROUP(name) , DDN(ddname)
AREA(name)
DEFAULTS( member )
JOB NOLIST
JCLOUT JCLPDS JOB(member) LIST
JCLOUT( ddname ) JCLPDS( ddname ) NOJOB
MULTIJOB
MEMBER(member) ONEJOB NODEFLT RCVTIME(time_stamp) RESTORE
USEIC
TIMEFMT(sublist) USEDBDS ,
USEAREA
USEOLRRG USERKEYS( ( %key1, 'value' ) )
%key2
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 that 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 that 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 “Generating JCL and User-Defined Output” on page 83. If this parameter is
not specified, the default specified on the INIT.DBDS command is used.
MULTIJOB | ONEJOB
Mutually exclusive, optional parameters that 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.
v See “Standard Time Stamp Format” on page 126 for examples of the
different output forms.
| USEIC | USEDBDS | USEAREA | USEOLRRG
| Mutually exclusive, optional parameters that 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.
| 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 time-stamp
| 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 time-stamp recovery in
| which an image copy data set is used as input.
| USEOLRRG
| Starts the recovery with a HALDB Online Reorganization updates.
| 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.
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
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 “Generating JCL and
User-Defined Output” on page 83.
GENJCL.USER Syntax
GENJCL.USER MEMBER(name)
DBD(name) DDN(ddname)
GROUP(name)
NOLIST MULTIJOB
LIST ONEJOB NODEFLT PARTONLY PSB(name) SSID(name)
TIMEFMT(sublist) ,
for each DBDS of the specified DBDS group. For each repeated execution,
the DBD and DDN parameters are set to the corresponding group member.
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 that 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 that 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.
MULTIJOB | ONEJOB
Mutually exclusive, optional parameters that 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.
//SYSIN DD *
LIST.SUBSYS SSID(%SSID) /* (SSID) SHOULD BE SUBSTITUTED */
LIST.DBDS DBD(%DBNAME) DDN(%DDNAME) -
/* (DBNAME) and (DDNAME) SHOULD BE SUBSTITUTED */
/*
INIT.ADS
Use the INIT.ADS command to create an entry in the RECON data set 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 the RECON data set. Use the INIT.DBDS command to register the area. If
| the ADDN or ADSN names are not unique for this area, the INIT.ADS command
| fails. When you register the area, 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. While an area has a recovery needed status, you
| can create the ADS records in the RECON data set, but you must create them as
| unavailable by issuing the command INIT.ADS UNAVAIL. However, you can create
| an ADS that is immediately available if you first remove the recovery needed status
| from the area with the CHANGE.DBDS NORECOV command and then create the ADS by
| issuing the INIT.ADS AVAIL command.
| To create multiple copies of an area data set, issue multiple INIT.ADS commands
| that have the same area name, as recorded in the RECON data set.
INIT.ADS Syntax
UNAVAIL
INIT.ADS ADDN(name) ADSN(name) AREA(name) DBD(name)
AVAIL
In this example, a record is created in the RECON data set that defines a single
area data set:
|| //INITADS
. JOB
|| .
.
| //SYSIN DD *
| INIT.DB DBD(DEDBJN21) SHARELVL(1) TYPEFP
| INIT.DBDS DBD(DEDBJN21) AREA(DB21AR0) GENMAX(2) VSO PRELOAD
| INIT.ADS DBD(DEDBJN21) AREA(DB21AR0) ADSN(IMSTESTL.DB21AR01) -
| ADDN(DB21AR01)
|| //INITADS
. JOB
|| .
.
| //SYSIN DD *
| INIT.DB DBD(DEDBJN21) SHARELVL(1) TYPEFP
| INIT.DBDS DBD(DEDBJN21) AREA(DB21AR0) GENMAX(2) VSO PRELOAD
| INIT.ADS DBD(DEDBJN21) AREA(DB21AR0) ADSN(IMSTESTL.DB21AR01) -
| ADDN(DB21AR01)
| INIT.ADS DBD(DEDBJN21) AREA(DB21AR0) ADSN(IMSTESTL.DB21AR02) -
| ADDN(DB21AR02)
| INIT.ADS DBD(DEDBJN21) AREA(DB21AR0) ADSN(IMSTESTL.DB21AR03) -
| ADDN(DB21AR03)
| /*
INIT.CA
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.
INIT.CA Syntax
,
3400
UNIT( unittype )
INIT.CAGRP
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.
INIT.CAGRP Syntax
,
NOREUSE
CAJCL DEFLTJCL( DEFLTJCL ) REUSE
CAJCL( member ) member
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 32767 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.
Restrictions:
v When using the INIT.CAGRP command for HALDBs, dbdname specifies the
name of a HALDB partition.
v User-recoverable databases cannot be added to a CA group.
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 that 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.
INIT.DB
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 you issue an INIT.DB command for a HALDB partition (TYPE=PART), the
| following fields are set as defaults:
| v OLREORG CURSOR ACTIVE =NO
| v OLRIMSID=**NULL**
| v ACTIVE DBDS=A-J
INIT.DB Syntax
RECOVABL 0
INIT.DB DBD(name) SHARELVL( 1 )
ICREQ 2
NONRECOV 3
NOICREQ
USERRCOV
TYPEIMS DBTRACK
TYPEFP GSGNAME(gsgname) RCVTRACK
OLRCAP
TYPHALDB
OLRNOCAP HIKEY
PARTSEL(pgmname)
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.
ICREQ | NOICREQ
Mutually exclusive, optional parameters used to specify whether DBRC should
enforce the requirement of taking an image copy of a non-recoverable or
user-recoverable database after it has been loaded or reorganized. This option
affects all DBDSs within the DB.
ICREQ
Default value that turns on IC NEEDED in the DBDS record and
increments the IMAGE COPY NEEDED COUNT in the DB record
following initial load (PROCOPT=L) or REORG of the DBDS.
NOICREQ
Turns off the IC NEEDED requirement. DBRC will not turn on IC
NEEDED in the DBDS record or increment the IMAGE COPY NEEDED
COUNT in the DB record following initial load or REORG of the DBDS.
The IC NEEDED flag can still be set manually with the CHANGE.DBDS ICON
command.
Requirement: When NOICREQ is specified, NONRECOV or USERRCOV
must also be specified.
NONRECOV | RECOVABL | USERRCOV
Mutually exclusive, optional parameters used to specify whether DBRC can
record the updates in the RECON for the data sets of the specified databases.
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.
USERRCOV
Specifies that update allocations for the Fast Path database are not to be
recorded in the RECON. Database updates are logged, however, DBRC will
not be able to manage recovery for the database. Recovery is allowed with
JCL manually generated by the user. This parameter is only valid for
TYPEFP. USERRCOV cannot be specified for an RSR-covered database.
Notes:
1. USERRCOV should only be used if a critical need to reduce database
open time exists and recoverability is require.
2. USERRCOV requires the user to provide their own manually-created
JCL for change accumulation and recovery.
Restrictions:
v If the database is registered as RECOVABL or USERRCOV, VIO or DD
DUMMY 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.
v NONRECOV or USERRCOV cannot be specified if GSGNAME is specified.
v You cannot make concurrent image copies of non-recoverable or
user-recoverable databases.
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 17.
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 9: Administration Guide: System.
| TYPEFP | TYPEIMS | TYPHALDB
| Mutually exclusive, optional parameters that you use to specify whether the
| database is a Full Function, 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).
| TYPHALDB
| Specifies that the database is a DL/I database (HALDB). When you issue a
| INIT.DB TYPHALDB command, the IMS DBDLIB data set must be identified
| in the job stream for the Database Recovery Control utility with a ddname
| of IMS.
| OLRCAP | OLRNOCAP
| Mutually exclusive, optional parameters used to indicate that HALDB
| OLR is allowed to run on that database.
| OLRCAP Specifies in the master database record and in the
| partition database record that HALDB OLR is allowed
| to run on that database. This is the default (except for
| a PSINDEX, which is always OLRNOCAP).
| OLRNOCAP Specifies in the master database record and in the
| partition database record that HALDB OLR is not
| allowed to run on that database.
| HIKEY | PARTSEL (pgname)
| Mutually exclusive, optional parameters that you use to identify
| whether the HALDB uses a Partition Selection Exit or high key values.
| This setting determines whether the KEYSTRNG parameter on the
| INIT.PART command defines a partition selection exit string or a high
| key value. These parameters are valid only with TYPHALDB.
| PARTSEL(pgmname)
| Specifies the name of the Partition Selection Exit program to be
| used for the HALDB. The pgmname is specified as a value up to 8
| characters long that is a valid program name.
| HIKEY
| Specifies that this HALDB uses high key values.
| If both PARTSEL and HIKEY are omitted, the HALDB will use the
| Partition Selection Exit module name (PSNAME) from the HALDB
| DBD. If no Partition Selection Exit module name was specified in the
| DBD, the HALDB will use high key values.
INIT.DBDS
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 Database
Recovery Control utility with a ddname of IMS.
The INIT.DBDS command fails if you issue it while the database is in use.
When you issue an INIT.DBDS command, DBRC sets the image copy status in the
DBDS record in the RECON to IC RECOMMENDED. After registering the DBDS,
you can reset the image copy status in the RECON by performing either of the two
following actions:
v Use the Image Copy utility to create a backup copy.
v Use the CHANGE.DBDS command to change the image copy status in the RECON
(see the explanations of the ICON and ICOFF parameters under
“CHANGE.DBDS” on page 152 for more information).
| Restriction for HALDBs: You cannot use the INIT.DBDS command to register
| DBDSs of HALDB databases. You must instead use either the HALDB Partition
| Definition utility or the INIT.DB and INIT.PART commands.
INIT.DBDS Syntax
| DBTRACK
| INIT.DBDS DBD(name) DDN(name) DSN(name) GENMAX(value)
AREA(name) RCVTRACK
| NOREUSE
|
DEFLTJCL(member) GSGNAME(gsgname) ICJCL REUSE
ICJCL( member )
| NOPREO
|
OICJCL PREOPEN RECOVJCL
OICJCL( member ) RECOVJCL( member )
|
| 0 RECVJCL
RECOVPD( value ) RECVJCL( member )
| NOVSO
NOLKASID NOMAS NOPREL
VSO
CFSTR1(name) CFSTR2(name) LKASID MAS PRELOAD
|
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 that 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
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 that 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 for a specified
DBDS or DEDB area.
The recovery period is the amount of time before the current date for which
DBRC maintains recovery information in the RECON data set. For example, if
the recovery period of a DBDS or area is 14 days, DBRC maintains sufficient
recovery-generation information for at least 14 days.
The recovery period is calculated as 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: See IMS Version 9: 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 that 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 a z/OS data space.
Areas defined with SHARELVL(2 | 3) use the coupling facility to share
data between connected subsystems.
CFSTR1(name)
Optional parameter you use to specify the name of the first coupling
facility structure for the identified area. z/OS 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. z/OS 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.
| Restrictions: The name cannot be the area name if the CFSTR1
| keyword is not specified. CFSTR2 cannot be specified if MAS is
| specified.
//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
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. Define a separate DB group for such
use.
A recovery group is used with database recoveries. It can also be used anywhere
that a DB group can be used.
INIT.DBDSGRP Syntax
,
DBGRP( dbname )
,
RECOVGRP( (dbname ) )
,areaname
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. HALDB partitions and Fast Path databases cannot
| belong to a recovery group. If you perform a time-stamp recovery on one
| of the members of the group, some database recovery tools require 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.
Restrictions for HALDBs: For HALDBs, dbname specifies the name of a HALDB
partition or the HALDB master database. When specifying HALDB database
names, use the INIT.DBDSGRP command only as defined in Table 13.
Table 13. Supported dbname specifications for HALDBs on INIT.DBDSGRP command
parameters
INIT.DBDSGRP dbname = HALDB dbname = Partition
Master
MEMBERS No Yes
DBGRP Yes Yes
RECOVGRP Yes No
INIT.GSG
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.
INIT.GSG Syntax
INIT.GSG GSGNAME(gsgname)
SEQNUM(number)
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.
INIT.IC
Use an INIT.IC command to create image copy records in RECON. These image
copy records define image copy data sets that are available for use during
subsequent runs of the supported image copy utilities.
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.
INIT.IC Syntax
INIT.IC DBD(name) DDN(name) ICDSN(name)
AREA(name) 1
FILESEQ( value )
1 ICDSN2(name) 3400
FILESEQ2( value ) UNIT( unittype )
3400 , ,
UNIT2( unittype )
VOLLIST( volser ) VOLLIST2( volser )
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.
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.
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
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.
| INIT.PART Syntax
| INIT.PART DBD(name) PART(name)
| KEYSTRNG string
hex_string
| DSNPREFX(string)
| RANDOMZR(name) ANCHOR(value) HIBLOCK(value)
|
| BYTES(value) 0 0
FBFF( value ) FSPF( value )
|
| , 2
GENMAX( value )
BLOCKSZE ( 4096 )
value
| NOMVDBDS
|
DEFLTJCL(member) ICJCL MVDBDS
ICJCL( member )
| NOREUSE
|
OICJCL REUSE RECOVJCL
OICJCL( member ) RECOVJCL( member )
|
| 0 RECVJCL
RECOVPD( value ) RECVJCL( member )
INIT.RECON
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.
INIT.RECON Syntax
| NOCATDS CMDAUTH(NONE)
| INIT.RECON
CATDS CMDAUTH( SAF ,safhlq)
EXIT
BOTH
| LOGRET(001) MINVERS('7.1')
|
LOGRET('time_interval') MINVERS( '8.1' ) REORGV
'9.1' NOREORGV
| NONEW TAPEUNIT(3400)
|
SSID(name) STARTNEW TAPEUNIT(unittype)
|
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 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 from a tenth of a second to
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('10 12:30') = 10 days, 12 hours, 30 minutes
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 212 for more information
on deleting inactive logs.
v See “Standard Time Stamp Format” on page 126 for more information on
time stamps.
LISTDL | NOLISTDL
Mutually exclusive, optional parameters that you use to specify whether data
set names 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 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.
| MINVERS('7.1' | '8.1' | '9.1')
| Optional parameter used to specify the lowest version of IMS allowed to sign
| on. This keyword cannot be set to a higher IMS release if any subsystems with
| a lower version of IMS are currently signed on to DBRC. The default is IMS
| '7.1'.
| Note: The IMS Version 9 format for the MINVERS keyword includes a period.
| DBRC considers this a special character and requires it to be enclosed in
| single quotes. The format from earlier versions (71 | 81 | 91) is also
| accepted for compatibility.
| REORGV | NOREORGV
| Mutually exclusive, optional parameters you use to modify the HALDB
| partition reorganization number verification. A CHANGE command with these
| parameters is allowed while databases are currently authorized to other
| subsystems.
| REORGV
| Specifies that HALDB partition reorganization number verification is
| enabled. The RECON will store the reorganization number for each
| partition to prevent the reorganization number from being regressed, or
| incremented by more than one. After a CHANGE.RECON REORGV
| command is issued, the partition reorganization number in each partition
| record is set to zeros.
STARTNEW | NONEW
Mutually exclusive, optional parameters that 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.
INIT.SG
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.
INIT.SG Syntax
NONLOCAL
INIT.SG GSGNAME(gsgname) SGNAME(sgname) ACTIVE
TRACKING LOCAL
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 that 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.
LIST.BKOUT
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 B, “Sample Listings from the
RECON Data Set,” on page 473.
LIST.BKOUT Syntax
ALL
LIST.BKOUT
SSID(name) TIMEFMT(sublist)
v See “Standard Time Stamp Format” on page 126 for examples of the
different output forms.
The LIST commands get the TIMEFMT default from what is specified in the
RECON header record.
LIST.CAGRP
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 B, “Sample Listings from the RECON Data Set,” on
page 473.
LIST.CAGRP Syntax
ALL
LIST.CAGRP
GRPNAME(name) TIMEFMT(sublist) MEMBERS
LIST.DB
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 B, “Sample
Listings from the RECON Data Set,” on page 473.
Related Reading:
v See “HALDB Records” on page 68 for detailed information about how HALDBs
are represented in the RECON data set.
v See IMS Version 9: Administration Guide: Database Manager for an overview of
HALDBs and information about how to create them.
LIST.DB Syntax
ALL
LIST.DB
TYPEIMS COVERED DBDS TIMEFMT(sublist)
TYPEFP GSG(gsgname)
TYPHALDB
DBD(dbname)
LIST.DBDS
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 B, “Sample Listings from the RECON
Data Set,” on page 473.
LIST.DBDS Syntax
LIST.DBDS DBD(name)
GROUP(name) DDN(name) TIMEFMT(sublist)
AREA(name)
If neither DDN nor AREA is specified, the LIST.DBDS command is executed for
each DBDS or DEDB area of the specified database.
Restrictions for HALDBs: 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” on page 127 for a description of the TIMEFMT
parameter sublist format.
v See “Standard Time Stamp Format” on page 126 for examples of the
different output forms.
Chapter 13. LIST Commands 295
LIST.DBDS
The TIMEFMT default for LIST commands is obtained from what is specified
in the RECON header record.
LIST.DBDSGRP
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 276
v “CHANGE.DBDSGRP” on page 159
LIST.DBDSGRP Syntax
ALL
LIST.DBDSGRP GRPNAME(name)
, TIMEFMT(sublist)
ALL( (dbname ) )
,areaname
,ddname
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” on page 127 for a description of the TIMEFMT
parameter sublist format.
v See “Standard Time Stamp Format” on page 126 for examples of the
different output forms.
The TIMEFMT default for LIST commands is obtained from what is specified
in the RECON header record.
LIST.GSG
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 B, “Sample
Listings from the RECON Data Set,” on page 473.
LIST.GSG Syntax
ALL
LIST.GSG
GSGNAME(gsgname) TIMEFMT(sublist)
The TIMEFMT default for LIST commands is obtained from what is specified
in the RECON header record.
LIST.HISTORY
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.
LIST.HISTORY Syntax
LIST.HISTORY DBD(name)
GROUP(name) DDN(name) FROMTIME(time_stamp)
AREA(name)
TOTIME(time_stamp) TIMEFMT(sublist) TIMELINE
|
| TIMEFMT(sublist)
|
v PRILOG
v LOGALL
v SECLOG
v PRISLD
v SECSLD
v PRIOLD
v SECOLD
ALL
LIST.LOG INTERIM
See “Optional Filters”
v IPRI
v ISEC
v IPRISL
v ISECSL
v IPRIOL
v ISECOL
ALL
LIST.LOG TRACKING
See “Optional Filters”
v PRITSLDS
v SECTSLDS
ALL
LIST.LOG TRACKING INTERIM
See “Optional Filter”
v IPRITSLD
v ISECTSLD
LIST.LOG ALLOLDS
See “Optional Filters”
v PRIOLD
v SECOLD
v IPRIOL
v ISECOL
LIST.LOG OLDS(ddname)
SSID(name) See “Optional Filters”
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.
| Optional Filters: The LIST.LOG 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.
| The optional parameters for LIST.LOG ALL, ALLOLDS, and OLDS are:
|
| FROMTIME(time_stamp) TOTIME(time_stamp) SSID(name) GSG(gsgname)
|
| OPEN ERROR UNARCH
|
TIMEFMT(sublist)
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” on page 127 for a description of the TIMEFMT
parameter sublist format.
v See “Standard Time Stamp Format” on page 126 for examples of the
different output forms.
The TIMEFMT default for LIST commands is obtained from what is specified
in the RECON header record.
LIST.RECON
Use the LIST.RECON command to obtain a display of the RECON’s current status
and a formatted display of all records it contains.
LIST.RECON Syntax
LIST.RECON
STATUS TIMEFMT(sublist)
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 B, “Sample Listings from the RECON
Data Set,” on page 473.
//LISTRCON JOB
.
.
.
//SYSIN DD *
LIST.RECON STATUS
/*
Only the first segment of output shown in the Appendix B, “Sample Listings from
the RECON Data Set,” on page 473 is produced in this case.
Related Reading: See Chapter 4, “Initializing and Maintaining the RECON Data
Set,” on page 55 for an explanation of the possible RECON states.
LIST.SUBSYS
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 B, “Sample Listings from the RECON Data Set,” on page 473.
LIST.SUBSYS Syntax
ONLINE
LIST.SUBSYS
SSID(name) TIMEFMT(sublist) TRACKING
ALL
BATCH
TRACKING
Specifies that all RSR tracking subsystem information is to be displayed.
NOTIFY.ALLOC
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.
HALDB Restriction: This command is not allowed for ILDS or Index DBDSs of
HALDB partitions.
NOTIFY.ALLOC Syntax
NOTIFY.ALLOC ALLTIME(time_stamp) DBD(name) DDN(name)
AREA(name)
DEALTIME(time_stamp)
STARTIME(time_stamp) DSSN(value) USID(value)
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 126).
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.
Restriction for HALDBs: When using the NOTIFY.ALLOC command for
HALDBs, name must specify the name of a HALDB partition.
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(time_stamp) | STARTIME(time_stamp)
Mutually exclusive, required parameters. The time stamp must be in standard
form (see “Standard Time Stamp Format” on page 126).
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.
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.
NOTIFY.BKOUT
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.
NOTIFY.BKOUT Syntax
NOTIFY.BKOUT SSID(name) UOR(uor) UORTIME(time_stamp) PSB(name)
, ,
NOTIFY.CA
Use a NOTIFY.CA command to add information about a run of the Database Change
Accumulation utility for a specified CA group.
NOTIFY.CA Syntax
NOTIFY.CA CADSN(name) GRPNAME(name) RUNTIME(time_stamp) STOPTIME(time_stamp)
VOLLIST( volser )
1
FILESEQ( value )
, 3400
NO COMPLETE UNIT( unittype )
PURGLIST( ( time_stamp, YES , INCOMPLETE ) )
COMP
SUBSET
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 126).
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(time_stamp,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 126). 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.
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 292 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.
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.
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 of this parameter can result in invalid
generated JCL.
NOTIFY.IC
Use a NOTIFY.IC command to add information about an image copy.
HALDB Restrictions:
v The NOTIFY.IC command is not allowed for ILDS or Index DBDSs of HALDB
partitions
| NOTIFY.IC Syntax
| NOTIFY.IC DBD(name) DDN(name) ICDSN(name) RUNTIME(time_stamp)
| AREA(name)
| ,
| FILESEQ(1) UNIT(3400)
VOLLIST( volser )
FILESEQ(value) UNIT(unittype)
| BATCH
|
, ONLINE RECDCT(value)
CIC
ICDSN2(name) VOLLIST2( volser ) A SMSCIC
SMSNOCIC
|
| STOPTIME(time_stamp) USID(value)
| A:
| FILESEQ2(1) UNIT2(3400)
FILESEQ2(value) UNIT2(unittype)
|
VOLLIST(volser)
Required 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.
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.
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.
BATCH| ONLINE | CIC | SMSCIC | SMSNOCIC
Mutually exclusive, optional parameters you use to specify the type of image
copy that the data set contains.
Restriction: CIC, SMSCIC, and ONLINE cannot be used for user-recoverable
databases.
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 can 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 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(time_stamp)
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 126).
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.
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.
FIRSTREC(number) GSG(gsgname) INTERIM LASTREC(number)
LOGTOKEN(number) NXTOLDS(ddname) SSID(name)
These two parameters are used in conjunction with the STARTIME, FIRSTREC,
and NXTOLDS parameters to identify what type of primary OLDS entry is to
be added to the RECON. Table 14 indicates which parameter combinations are
required for each type of primary OLDS entry.
Definitions:
OLDS Open
Starting to use an OLDS and inserting a starting time.
OLDS Switch
Stopping the use of the current OLDS (inserting a stop time) and
starting to use the next OLDS (inserting a starting time into the new
OLDS).
OLDS Close
Stopping the use of an OLDS (inserting a stop time)
Table 14. Parameters of NOTIFY.PRILOG (for OLDS) Command for Open, Switch, and Close
Type of Log Entry Required Keywords
OLDS Open STARTIME, DSN, FIRSTREC
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(time_stamp)
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 126.
See Table 14 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
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.
DSN(IMS.OLDP02) NXTOLDS(DFSOLP02)
NOTIFY.PRILOG SSID(IMSA) STARTIME(812181212120) OLDS(DFSOLP02) -
RUNTIME(932191010101)
/*
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)
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.
0 CHKPTID(chkptid) 1
CHKPTCT( value ) FILESEQ( value )
FIRSTREC(number) GSG(gsgname) INTERIM LASTREC(number)
LOCAL RLDS
LOGTOKEN(number) NONLOCAL SSID(name) 3400
UNIT( unittype )
VOLSER(volser)
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 15 indicates which parameter combinations are required for each type of
primary-recovery-log-data-set entry.
Definitions:
RLDS Open
Starting to use an RLDS and inserting a starting time.
RLDS EOV
RLDS end of volume (EOV) notification from the operating system.
This is analogous to an OLDS Switch.
RLDS Close
Stopping the use of an RLDS (inserting a stop time)
Table 15. 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(time_stamp)
Required parameter you use to specify the starting time of a primary RLDS.
The time stamp must be in standard form, see “Standard Time Stamp Format”
on page 126.
See Table 15 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:
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.
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)
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.
CHKPTCT(value) CHKPTID(chkptid) 1
FILESEQ( value )
LOCAL
FIRSTREC(number) GSG(gsgname) INTERIM LASTREC(number) NONLOCAL
SSID(name) 3400 VOLSER(volser)
UNIT( unittype )
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 126).
These two parameters are used in conjunction with the STARTIME, FIRSTREC,
LASTREC, and VOLSER parameters to identify what type of
primary-system-log-data-set entry is to be added to RECON. Table 16 indicates
which parameter combinations are required for each type of
primary-system-log-data set entry.
Definitions:
SLDS Open
Starting to use an SLDS and inserting a starting time.
SLDS EOV
SLDS end of volume (EOV) notification from the operating system.
This is analogous to an OLDS Switch.
SLDS Close
Stopping the use of an RLDS (inserting a stop time)
Table 16. 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(time_stamp)
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 126).
See Table 16 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
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 126).
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.
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.
NOTIFY.RECOV
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.
| For a receive, specify both the RCVUSID and RUNUSID parameters. Specify the
| same usid value for both parameters: the update set identifier (usid) of the image
| copy that was used for recovery. For a time-stamp recovery, specify the RCVUSID
| parameter with the usid value that the database was recovered to, and specify the
| RUNUSID parameter with the usid that was current when the recovery occurred.
| Future recoveries will ignore all records associated with usid values between those
| specified for the RCVUSID and RUNUSID parameters.
Related Reading: See IMS Version 9: Operations Guide for more information about
recovery in a data sharing environment.
Restriction for HALDBs: This command is not allowed for ILDS or Index DBDSs
of HALDB partitions.
NOTIFY.RECOV Syntax
NOTIFY.RECOV DBD(name) DDN(name)
AREA(name) RCVTIME(time_stamp) RCVUSID(usid)
CURRENT DBDS
RUNUSID(usid) ADDN(name) RUNTIME(time_stamp) TRACK
PITR
You can specify this parameter only when you specify the AREA(name)
parameter.
CURRENT | RUNTIME(time_stamp)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 126).
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 time-stamp recovery.
TRACK
Specifies that the recovery was a track recovery.
If you specify this parameter and the RCVTIME parameter, the command fails.
RCVTIME(time_stamp)
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 RUNTIME parameter with the PITR
parameter.
Restriction: Do not use the RCVTIME parameter when recovering from a
nonstandard image copy at a tracking subsystem.
See 251 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.
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
Use a NOTIFY.REORG command to add a record to RECON about the reorganization
of the database to which an identified DBDS belongs.
Restrictions:
v This command should not be used following the reorganization of a Fast Path
DEDB. Such databases can be recovered after 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.
NOTIFY.REORG Syntax
CURRENT
NOTIFY.REORG DBD(name) DDN(name)
RUNTIME(time_stamp)
1 1 ICDSN(name) ICDSN2(name)
FILESEQ( value ) FILESEQ2( value )
OFFLINE
ONLINE RECDCT(value)
NORECOV
STOPTIME(time_stamp)
RECOV
3400 3400 ,
UNIT( unittype ) UNIT2( unittype )
VOLLIST( volser )
, USID(value)
VOLLIST2( volser )
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.
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.
| OFFLINE | ONLINE
| Mutually exclusive, optional parameters that specify whether the
| reorganization is a HALDB OLR or an offline reorganization.
| OFFLINE
| Specifies that the DBDS was reorganized offline.
| ONLINE
| Specifies that the reorganization is a HALDB OLR.
| STOPTIME(time_stamp)
| Optional parameter that specifies the time when a HALDB
| OLR completed successfully.
| NORECOV | RECOV
| Mutually exclusive, optional parameters that specify whether
| the online reorganization can be used as input for recovery.
| NORECOV Specifies that the HALDB OLR cannot be used
| as input to recovery.
| RECOV Specifies that the HALDB OLR may be used as
| input to recovery.
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.
FIRSTREC(number) GSG(gsgname) INTERIM LASTREC(number)
NXTOLDS(ddname) SSID(name)
DSN and RUNTIME are used in conjunction with the STARTIME, FIRSTREC,
LASTREC, and NXTOLDS parameters to identify which type of secondary
online-log-data-set entry is to be added to RECON. Table 17 indicates the
keyword combinations that correspond to the type of secondary-online-log
data-set entry.
Table 17. 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(time_stamp)
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 126).
See Table 17 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.
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 create an interim log data set, you must create a
secondary 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
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.
0 CHKPTID(chkptid) 1
CHKPTCT( value ) FILESEQ( value )
LOCAL
FIRSTREC(number) GSG(gsgname) INTERIM LASTREC(number) NONLOCAL
RLDS SSID(name) 3400 VOLSER(volser)
UNIT( unittype )
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 18 indicates the keyword combinations that
correspond to the type of secondary recovery log data set entry.
Table 18. 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(time_stamp)
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 126).
If you issue a subsequent STARTIME parameter, that time is the start time of
the volume. See Table 18 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 126).
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').
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
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.
0 CHKPTID(chkptid) 1
CHKPTCT( value ) FILESEQ( value )
LOCAL
FIRSTREC(number) GSG(gsgname) INTERIM LASTREC(number) NONLOCAL
SSID(name) 3400 VOLSER(volser)
UNIT( unittype )
DSN(name) | RUNTIME(time_stamp)
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 126).
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 19 indicates the keyword combinations that
correspond to the type of secondary system log data set entry.
Table 19. 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(time_stamp)
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 126).
See Table 19 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 126).
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).
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.
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 19 on page 343 identifies when you use the VOLSER parameter.
NOTIFY.SUBSYS
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.
NOTIFY.SUBSYS Syntax
NORMAL ONLINE ENDRECOV
NOTIFY.SUBSYS SSID(name)
IRLMID(name) ABNORMAL BATCH STARTRCV
NOTIFY.UIC
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 Chapter 2, “Database Recovery Control Utility
(DSPURX00),” on page 27 for more information).
v This command is not allowed for ILDS or Index DBDSs of HALDB partitions.
| v The NOTIFY.UIC command will fail if it is attempting to record an image copy of
| a HALDB that has an online reorganization in progress. This is because an
| image copy of a HALDB cannot be taken while the HALDB is being reorganized
| online and the reorganization has not completed (either it is in progress or was
| terminated).
NOTIFY.UIC Syntax
CURRENT
NOTIFY.UIC DBD(name) DDN(name)
AREA(name) RUNTIME(time_stamp) UDATA(‘string‘)
USID(number)
In This Chapter:
v “RESET.GSG”
RESET.GSG
“RESET.GSG Usage” contains the details for the RESET.GSG command.
RESET.GSG Usage
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
z/OS 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.
RESET.GSG Syntax
RESET.GSG GSGNAME(gsgname) BOTH
RECON1
RECON2
| The API is provided with IMS in the DSPAPI macro. A sample application program
| (DSPAPSMP) that uses the DBRC API is included in the IMS.ADFSSMPL (also
| known as IMS.SDFSSMPL) library.
| Note: All DBRC API requests must be issued under the same TCB where the
| DBRC start request (STARTDBRC) was issued. Any request that is issued
| under a different TCB fails with reason code X’C900000A’.
| Prerequisite Knowledge: To write a program that uses the DBRC API, you must
| have a working knowledge of:
| v Assembler language programming
| v z/OS and the services it supplies
| v IMS
| v DBRC
| In This Chapter:
| v “Writing an Application to Access the DBRC API”
| v “Runtime Considerations of the DBRC API” on page 357
|
| Writing an Application to Access the DBRC API
| The general structure of an application that uses the DBRC API is as follows:
| 1. Include the API DSECTS (DSPAPI FUNC=DSECT)
| 2. Initialize the API, start DBRC, establish a connection to the RECON data sets,
| and receive the API token (DSPAPI FUNC=STARTDBRC)
| 3. Issue one or more Query requests (DSPAPI FUNC=QUERY)
| 4. Process the information returned from the Query requests
| 5. Return buffer storage (DSPAPI FUNC=RELBUF)
| Address Space Control (ASC) Mode and State When Using the
| DBRC API
| Your application must be in primary ASC mode to invoke the API services. Cross
| memory mode is not supported. The application can run in either problem
| program state or supervisor state, and can also run as an APF authorized program.
| Name Fields
| Unless specifically noted, name fields are 8-character fields, left justified and
| padded with blanks.
| Note: The expansion of the list form does not contain any executable
| instructions. Therefore, you cannot use register notation in the list
| form.
| The IMS libraries concatenated to JOBLIB or STEPLIB are usually APF Authorized.
| If your program runs APF Authorized and the library containing the MDA
| members is not APF Authorized, allocate it using IMSDALIB as the DD name.
| Requirement: All jobs accessing a set of RECON data sets must allocate the same
| data set by the same DD name. For example, RECON1=dsn1, RECON2=dsn2, and
| RECON3=dsn3. Failure to follow this convention causes serious damage to the
| RECONs.
| The API uses only one set of RECONs between a FUNC=STARTDBRC request and
| its associated FUNC=STOPDBRC request. Your program, however, can use
| multiple sets of RECONs by deallocating the RECONs after the FUNC=STOPDBRC
| request and then allocating a new set of RECONs before issuing the next
| FUNC=STARTDBRC request. In order for this to work, your program must
| dynamically allocate the RECONs.
| Where:
| yyyy Is the year (0000 to 9999)
| ddd Is the day (000 to 366)
| F Is a hexadecimal character for padding purposes (X'F')
| hh Is the hour (0 to 23)
| mm Is the minute (0 to 59)
| ss Is the second (0 to 59)
| t Is the tenth of a second (0 to 9)
| xxxxx Low-order digits ignored by DBRC
| fqqs Time zone offset where:
| f Flag bits, normally zero for UTC representation
| qq Quarter hours (32/4=8)
| s Sign (D is negative, C is positive)
| You do not need to specify PARM if your installation uses the SCI Registration Exit
| (DSPSCIX0). See IMS Version 9: Customization Guide for more information about this
| exit.
Related Reading: See “Records in the RECON Data Set” on page 63 for a
description of the information available in the RECON data set, and “Fields
Present in a Listing of a RECON by Record Type” on page 532 for a description of
the individual fields present in each RECON record type.
In This Chapter:
v “Output from Query Requests”
v “Query Requests Reference” on page 362
The storage for these blocks is not preallocated by the calling application. DBRC
will acquire private storage for these blocks. It is the responsibility of the calling
application to free this storage using the Buffer Release request (DSPAPI
FUNC=RELBUF). For more information about freeing this storage, see Chapter 18,
“DBRC Release Buffer Request,” on page 423.
Figure 15 illustrates the general format of the output from a Query request. The
sample DSECT that follows Figure 15 describes in detail the fields of the storage
blocks and their relationship to each other.
|
| Figure 15. General Format of Query Output
|
Each storage block begins with a standard header mapped by DSPAPQHD, as
illustrated in Figure 16.
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 32 APQHD
0 (0) CHARACTER 8 APQHD_EYECATCHER Output area eyecatcher
8 (8) SIGNED 4 APQHD_LENGTH Block length, hdr + data
12 (C) SIGNED 2 APQHD_BLKTYPE Block type
14 (E) SIGNED 2 * Reserved
16 (10) ADDRESS 4 APQHD_DEPPTR Ptr to block dependent
20 (14) ADDRESS 4 APQHD_NEXTPTR Ptr to next block of the same type
24 (18) UNSIGNED 4 APQHD_BLKOFFSET Offset to block data
28 (1C) SIGNED 4 APQHD_VERSION Version of output block
In this section :
v “Backout Query” on page 363
v “Database Query” on page 367
v “Group Query” on page 390
v “Log Query” on page 399
v “OLDS Query” on page 408
v “RECON Status Query” on page 413
v “Subsystem Query” on page 417
Backout Query
The Backout query (DSPAPI FUNC=QUERY TYPE=BACKOUT) request is used to
retrieve backout information from RECON for a specific subsystem or all
subsystems.
| SSID=* MF=S
| OUTPUT=output
SSID=subsystem_ID MF=(S,list)
MF=(L,list)
,COMPLETE
MF=(M,list )
,NOCHECK
,COMPLETE
MF=(E,list )
,NOCHECK
VERSION=1.0
RETCODE=returncode RSNCODE=reasoncode VERSION=number
|
for freeing this storage by using the Buffer Release request (DSPAPI
FUNC=RELBUF), specifying the returned output address.
RETCODE=symbol | (2 - 12)
Optional parameter that specifies a place in storage to receive the return
code. If specified as a symbol, the symbol must be the label of a word of
storage. If specified as a register, the register must contain the address of a
word of storage. If not specified, the return code is placed in register 15.
RSNCODE=symbol | (2 - 12)
Optional parameter that specifies a place in storage to receive the reason
code. If specified as a symbol, the symbol must be the label of a word of
storage. If specified as a register, the register must contain the address of a
word of storage. If not specified, the reason code is placed in register 0.
VERSION=1.0 | number
Optional parameter that specifies the version number of the parameter list
to be generated by this request.
To use the parameters associated with a version, you must specify the
number of that version or a later version. If you specify an earlier version
level, the parameter is not accepted for processing and an error message is
issued at assembly time. If parameters have a version dependency, the
parameter descriptions with each request type identify the version number
required.
The default version is 1.0.
| Table 20. Return and Reason Codes for TYPE=BACKOUT Query Requests (continued)
| Return Codes Reason Codes Meaning
| Parameter Error
| X'00000030' X'C9000001' Parameter error. The function (FUNC) specified in
| the parameter list passed to the API is invalid.
| X'00000030' X'C9000002' Invalid TOKEN field address. The address of the
| field containing the API TOKEN failed validity
| checking. The address specifies storage not owned
| by the calling program.
| X'00000030' X'C9000003' Invalid RETCODE field address. The address of
| the field to contain the API RETCODE failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000004' Invalid RSNCODE field address. The address of
| the field to contain the API RSNCODE failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000005' Invalid OUTPUT field address. The address of the
| field to contain the OUTPUT address failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000010' Invalid SSID field address. The address of the
| field containing the SSID failed validity checking.
| The address specifies storage not owned by the
| calling program.
| X'00000030' X'D80000001' Parameter error. Missing or invalid OUTPUT
| parameter.
|
|
| Figure 17. Format for QUERY TYPE=BACKOUT Output
|
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 48 DSPAPQBO
0 (0) CHARACTER 8 APQBO_SSID Subsystem identifier
8 (8) UNSIGNED 4 APQBO_FIRSTUOR Offset of first UOR entry
12 (C) UNSIGNED 4 APQBO_LASTUOR Offset of last UOR entry
16 (10) CHARACTER 12 APQBO_TIMEFIRST Earliest UOR time
28 (1C) CHARACTER 12 APQBO_TIMELAST Latest UOR time
40 (28) BIT(8) 1 APQBO_FLAGS Backout flags
1... .... APQBO_SAVER SAVUOR call during restart
41 (29) CHARACTER 3 * Reserved
44 (2C) SIGNED 4 APQBO_UORCOUNT Number of UORs
==============================================================================
The following structure maps the unit of recovery entries.
There is one such entry for each unit of recovery (i.e. there
are apqbo_UORcount entries). Each unit of recovery entry
contains the offset within the backout block to the previous
and following entries. Field apqbo_PrevUOR is the offset of
the previous entry and apqbo_NextUOR is the offset of the
following entry. For the first unit of recovery (UOR) entry,
apqbo_PrevUOR will be zero. Similarly, apqbo_NextUOR will be
zero for the last entry. Addressability to the first UOR entry
is given by:
rfy apqbo_UORentry based(addr(DSPAPQBO) + apqbo_FirstUOR)
Addressability to the last UOR entry is given by:
rfy apqbo_UORentry based(addr(DSPAPQBO) + apqbo_LastUOR)
Addressability to the next UOR entry, if one exists (that is:
apqbo_NextUOR not equal to 0), is given by:
rfy apqbo_UORentry based(addr(DSPAPQBO) + apqbo_NextUOR)
Similarly, to address the previous entry (when apqbo_PrevUOR
not equal to 0):
rfy apqbo_UORentry based(addr(DSPAPQBO) + apqbo_PrevUOR)
Once addressability has been established to a UOR entry,
addressability to the ith database for this UOR is given by:
rfy apqbo_DBent
based(addr(apqbo_UORentry) + apqbo_DBoffset
+ (i-1) apqbo_DBLength)
==============================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 64 APQBO_UORENTRY Unit of Recovery entry
0 (0) CHARACTER 64 APQBO_PREFIX Prefix section
0 (0) UNSIGNED 4 APQBO_NEXTUOR Offset of next UOR entry
4 (4) UNSIGNED 4 APQBO_PREVUOR Offset of previous UOR entry
8 (8) UNSIGNED 4 APQBO_DBOFFSET Offset to DB entries
12 (C) CHARACTER 12 APQBO_UORTIME Time stamp for this UOR
24 (18) CHARACTER 8 APQBO_UORPSB PSB name
32 (20) BIT(16) 2 APQBO_UORFLAGS
1... .... APQBO_DEFBO Deferred backout - dynamic backout failure
.1.. .... APQBO_INFLT Inflight UOR
..1. .... APQBO_INDOU Indoubt UOR
...1 .... APQBO_BMP BMP UOR
.... 1... APQBO_BOCAN BBO identified candidate
.... .1.. APQBO_COLDN Cold start ended for UOR
.... ..1. APQBO_BBOK Backed out OK by BBO
.... ...1 APQBO_CMD UOR modified by command
33 (21) 1... .... APQBO_BATCH Batch IMS UOR
34 (22) CHARACTER 6 * Reserved
40 (28) CHARACTER 16 APQBO_RTOKN Recovery token
40 (28) CHARACTER 8 APQBO_RTSSID SSID for this token
48 (30) CHARACTER 8 APQBO_UORID Unique UOR ID
56 (38) SIGNED 4 APQBO_DBCOUNT Number of DBs for this UOR
60 (3C) UNSIGNED 2 APQBO_DBLENGTH Length of each DB entry
62 (3E) CHARACTER 2 * Reserved
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ================= ======== ============== ===============================
0 (0)STRUCTURE 16 APQBO_DBENT Database entry
0 (0)CHARACTER 8 APQBO_DBNAME Database name
8 (8)BIT(8) 1 APQBO_DBFLAGS Flags
1... .... APQBO_DBOUT UOR backed out for this DB
.1.. .... APQBO_DBDEF Dyn backout failure this DB
9 (9) CHARACTER 7 * Reserved
CONSTANTS
Database Query
The Database Query request (DSPAPI FUNC=QUERY TYPE=DB) is used to
retrieve information from the RECON concerning one or more registered
databases. This information includes the following database types:
v Full Function
v Fast Path DEDB
v HALDB (returns information about the HALDB master and all of its partitions)
Optionally, you can request data set and area information. If you do, you have the
option of requesting recovery-related information for the data set or area. This
includes allocation, image copy, recovery, and reorganization information.
LIST=NONE LOC=SPEC
DBNAME=dbname
, DBLIST=namelist LOC=FIRST
LOC=NEXT
LIST=( ALLOC )
IC
RECOV
REORG
LIST=ALL
MF=S
OUTPUT=output
MF=(S,list) RETCODE=returncode
MF=(L,list)
,COMPLETE
MF=(M,list )
,NOCHECK
,COMPLETE
MF=(E,list )
,NOCHECK
VERSION=1.0
RSNCODE=reasoncode VERSION=number
| Table 21. Return and Reason Codes for TYPE=DB Queries (continued)
| Return Codes Reason Codes Meaning
| X'00000028' X'D8210003' Error obtaining storage for RCVINFO block.
| X'00000028' X'D8210004' Error obtaining storage for ALLOC block.
| X'00000028' X'D8210005' Error obtaining storage for IC block.
| X'00000028' X'D8210006' Error obtaining storage for REORG block.
| X'00000028' X'D8210007' Error obtaining storage for RECOV block.
| X'00000028' X'D8220001' Error obtaining storage for PART block.
| X'00000028' X'D9100001' An error occurred processing the request. DBRC
| will release storage that was obtained up to this
| point. Another error was encountered, however,
| during the attempt to release storage.
| Internal Error
| X'0000002C' all DBRC internal error. Refer to “Database Recovery
| Control Service Aids” in the IMS Version 9:
| Diagnosis Guide and Reference for further
| information.
| Parameter Error
| X'00000030' X'C9000001' Parameter error. The function (FUNC) specified in
| the parameter list passed to the API is invalid.
| X'00000030' X'C9000002' Invalid TOKEN field address. The address of the
| field containing the API TOKEN failed validity
| checking. The address specifies storage not owned
| by the calling program.
| X'00000030' X'C9000003' Invalid RETCODE field address. The address of
| the field to contain the API RETCODE failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000004' Invalid RSNCODE field address. The address of
| the field to contain the API RSNCODE failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000005' Invalid OUTPUT field address. The address of the
| field to contain the OUTPUT address failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000008' Invalid DBNAME or DBLIST address. The
| address of the field containing the DBNAME or
| DBLIST failed validity checking. The address
| specifies storage not owned by the calling
| program.
| X'00000030' X'C9000009' Invalid DDN address. The address of the field
| containing the DDN failed validity checking. The
| address specifies storage not owned by the calling
| program.
| X'00000030' X'D8000001' Parameter error. Missing or invalid OUTPUT
| parameter.
| X'00000030' X'D8200001' Parameter error. LOC parameter is not allowed
| with DBLIST.
| X'00000030' X'D8200002' Parameter error. DBNAME parameter is not
| allowed with LOC=FIRST.
| Table 21. Return and Reason Codes for TYPE=DB Queries (continued)
| Return Codes Reason Codes Meaning
| X'00000030' X'D8200003' Parameter error. DBNAME parameter is required
| with LOC=NEXT.
| X'00000030' X'D8200004' Parameter error. DBNAME or DBLIST is required.
| X'00000030' X'D8200005' Parameter error. Count of databases in DBLIST is
| zero.
| X'00000030' X'D8200006' Parameter error. Database information is being
| requested for a HALDB partition. DBNAME or
| DBLIST contains a partition name.
|
Full Function Output: Figure 19 shows the fields of the DSPAPQDB block.
|
| Figure 19. Format of QUERY TYPE=DB (Full Function) Output
|
| The DBDS information is returned only if DDN is specified.
| Figure 20 on page 373 describes the fields contained in the DSPAPQDB block
| shown in Figure 19. Figure 21 on page 374 describes the fields contained in the SS
| data (DSPAPQSL). Refer to Figure 29 on page 383 for an illustration of the fields of
| the DBDS output.
|
| OFFSET OFFSET
| DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
| ======== ======== ========= ======== ============== ===============================
| 0 (0) STRUCTURE 96 DSPAPQDB
| 0 (0) CHARACTER 8 APQDB_DBNAME Database name
| 8 (8) UNSIGNED 4 APQDB_SSLIST Offset to SS list (DSPAPQSL), zero is no SS auth'd
| 12 (C) SIGNED 4 *(3) Reserved
| 24 (18) UNSIGNED 2 APQDB_IRCNT IC receive needed counter
| 26 (1A) BIT(8) 1 APQDB_AUFLAG Authorization flags
| 1... .... APQDB_BKFLG Backout needed flag
| .1.. .... APQDB_PAFLG Prohibit authorization
| ..1. .... APQDB_RDFLG Read only SS auth
| ...1 .... APQDB_NONRV Non-recoverable
| 27 (1B) CHARACTER 5 APQDB_IRLMAU IRLMID of auth SS
| 32 (20) SIGNED 2 APQDB_RCVCTR Recovery needed count
| 34 (22) SIGNED 2 APQDB_ICCTR IC needed count
| 36 (24) SIGNED 2 APQDB_ICRECCTR IC recommended counter
| 38 (26) UNSIGNED 1 APQDB_SHRLVL Share level of DB
| 39 (27) UNSIGNED 1 APQDB_HELDAU Held auth state
| 1... .... APQDB_HAUBIT High order bit flag
| 40 (28) UNSIGNED 2 APQDB_DMBNUM Global DMB number
| 42 (2A) SIGNED 2 APQDB_SSNUM # of SS auth DB
| 44 (2C) UNSIGNED 2 APQDB_SSENTLEN Length of each SS entry
| 46 (2E) UNSIGNED 1 APQDB_CACCSS Access state for chg auth
| 47 (2F) UNSIGNED 1 APQDB_CANCDD Encode state for chg auth
| 48 (30) UNSIGNED 1 APQDB_CAHELD Held state for chg auth
| 49 (31) CHARACTER 3 * Reserved
| 52 (34) UNSIGNED 2 APQDB_EQECNT Total EQE count
| 54 (36) BIT(16) 2 APQDB_RSRFLG Flags
| 1... .... APQDB_RCVTRK Recovery level tracking
| .1.. .... APQDB_TRKSPN Tracking is suspended
| ..1. .... APQDB_PURBIT Suspended by time
| ...1 .... APQDB_ICNDIS IC needed disabled option
| 56 (38) CHARACTER 8 APQDB_GSGNAME Global Service Group name
| 64 (40) UNSIGNED 4 APQDB_USID Last alloc USID
| 68 (44) UNSIGNED 4 APQDB_AUSID Last authorized USID
| 72 (48) UNSIGNED 4 APQDB_RUSID Last received USID
| 76 (4C) UNSIGNED 4 APQDB_HUSID Hardened by tracker USID
| 80 (50) UNSIGNED 4 APQDB_RNUSID Receive needed USID
| 84 (54) CHARACTER 8 APQDB_RECOVGRP Recovery Group name
| 92 (5C) CHARACTER 4 * Reserved
|
| CONSTANTS
|
| LEN TYPE VALUE NAME DESCRIPTION
| ===== ========= ================= =============== ===============================
| 8 CHARACTER DSPAPQDB APQDB_EYECATCHER
|
| Figure 20. DSECT of DSPAPQDB
|
DSPAPQSL
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 16 DSPAPQSL
0 (0) CHARACTER 16 APQSL_SSINFO Subsystem list entry
0 (0) CHARACTER 8 APQSL_SSNAME Subsystem ID
8 (8) UNSIGNED 1 APQSL_ACCESS Access intent
9 (9) UNSIGNED 1 APQSL_NCDDST Encoded state
10 (A) BIT(8) 1 APQSL_SSFLGS Flags
1... .... APQSL_SSROLE 0 - Active SS, 1 - Tracking SS
.1.. .... APQSL_SSXRFC 1 - XRF Capable
11 (B) BIT(8) 1 * Reserved
12 (C) CHARACTER 4 APQSL_BKINFO Backout information
12 (C) SIGNED 2 APQSL_BKCTR Backout needed count
14 (E) SIGNED 2 APQSL_BKNUM Backout done count
CONSTANTS
|
| Figure 22. Format of QUERY TYPE=DB (Fast Path DEDB) Output
|
The area information is returned only if DDN is specified. Recovery information
(RCVINFO) is only returned if the LIST parameter is specified.
Figure 23 on page 376, Figure 24 on page 377, and Figure 25 on page 379 describe
the fields contained in the DSPAPQFD and DSPAPQAR blocks shown in Figure 22.
Refer to Figure 31 on page 385 for an illustration of the Recovery Information
output fields.
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 38 DSPAPQFD
0 (0) CHARACTER 8 APQFD_DBNAME Database name
8 (8) SIGNED 4 *(4) Reserved
24 (18) SIGNED 2 APQFD_RCVCTR Recovery Needed Counter
26 (1A) SIGNED 2 APQFD_ICCTR IC Needed Counter
28 (1C) SIGNED 2 APQFD_ICRECCTR IC Recommended Counter
30 (1E) UNSIGNED 2 APQFD_DMBNUM Global DMB number
32 (20) UNSIGNED 2 APQFD_EQECNT Total EEQE count
34 (22) SIGNED 2 APQFD_AUTHDAREAS Number of Areas authorized
36 (24) UNSIGNED 1 APQFD_SHRLVL Share Level
37 (25) BIT(8) 1 APQFD_FLAGS Flags
1... .... APQFD_PAFLG Prohibit authorization
.1.. .... APQFD_NONRV Non-recoverable
..1. .... APQFD_ICNDIS IC needed disabled option
CONSTANTS
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 196 DSPAPQAR
0 (0) CHARACTER 8 APQAR_DBNAME Database name
8 (8) CHARACTER 8 APQAR_AREANAME Area name
16 (10) UNSIGNED 4 APQAR_EEQELIST Offset to EEQE list
(DSPAPQEL), zero if no EEQEs
20 (14) UNSIGNED 4 APQAR_SSLIST Offset to SS list (DSPAPQSL),
zero if no SS auth'd
24 (18) UNSIGNED 4 APQAR_ADSLIST Offset to ADS list, zero if
none registered
28 (1C) SIGNED 4 * Reserved
32 (20) UNSIGNED 1 APQAR_SHRLVL Share level of DB
33 (21) UNSIGNED 1 APQAR_HELDAU Held auth state
1... .... APQAR_HAUBIT High order bit flag
34 (22) UNSIGNED 2 APQAR_DMBNUM Global DMB number
36 (24) SIGNED 2 APQAR_SSNUM # subsytems authd to Area
38 (26) UNSIGNED 2 APQAR_SSENTLEN Length of each SS entry
40 (28) UNSIGNED 1 APQAR_CACCSS Access state for CHG AUTH
41 (29) UNSIGNED 1 APQAR_CANCDD Encoded state for CHG AUTH
42 (2A) UNSIGNED 1 APQAR_CAHELD Held state for CHG AUTH
43 (2B) CHARACTER 5 APQAR_IRLMAU IRLMID of auth SS
48 (30) BIT(16) 2 APQAR_FLAGS
1... .... APQAR_RECYC REUSE image copies
.1.. .... APQAR_ICREC Image Copy Recommended
..1. .... APQAR_IC Image Copy Needed
...1 .... APQAR_ICNDIS IC needed disabled option 1 =
IC Needed Disabled
.... 1... APQAR_RECOV Recovery needed
.... .1.. APQAR_INPRO HSSP CIC in progress
.... ..1. APQAR_GT240 M/C FP GT240 area DEDB
.... ...1 APQAR_VSO VSO flag
49 (31) 1... .... APQAR_PREOP PREOPEN flag
.1.. .... APQAR_PRELD PRELOAD flag
..1. .... APQAR_LKASD VSO CF buffer lookaside
...1 .... APQAR_MAS VSO area resides in multi-area
CF structure
.... 1... APQAR_RRGAL REORG since last ALLOC, only
set if RSR-covered
.... .1.. APQAR_TSRAL TS recov since last ALLOC, only
set if RSR-covered
50 (32) BIT(8) 1 APQAR_RSRFLAGS Remote Site Recovery flags
1... .... APQAR_RCVTRK Recovery Level Tracking
.1.. .... APQAR_TRKSPN Tracking was suspended
..1. .... APQAR_PURBIT Suspended by time
...1 .... APQAR_RCVRQ Receive Required
51 (33) BIT(8) 1 APQAR_AUFLAG Authorization flags
1... .... APQAR_PAFLG Prohibit authorization
.1.. .... APQAR_NONRV Non-recoverable
52 (34) BIT(8) 1 APQAR_DSORG Data set organization
1... .... APQAR_VSAM 1 = VSAM, 0 = NON-VSAM
.1.. .... APQAR_INDEX 0 = Non-indexed (OSAM or ESDS),
1 = Indexed(ISAM or KSDS)
..11 1111 * Reserved - zeroes
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 56 APQAR_ADSLT Area Data Set List
0 (0) CHARACTER 8 APQAR_ADSDD DDNAME of the ADS
8 (8) CHARACTER 44 APQAR_ADSDN DSN of the ADS
52 (34) BIT(8) 1 APQAR_ADSBT
1... .... APQAR_ADSAV Avail status of ADS
.1.. .... APQAR_ADSFM Format status of create util
..1. .... APQAR_ADSCP Copy status of create util
53 (35) CHARACTER 3 * Reserved
CONSTANTS
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 13 DSPAPQEL
0 (0) CHARACTER 13 APQEL_EEQEENTRY EEQE descriptor entry
0 (0) BIT(8) 1 APQEL_EQEFG EEQE flags
1... .... APQEL_ERTL Toleration error
.1.. .... APQEL_ERRD Read error
..1. .... APQEL_ERWT Write error
...1 .... APQEL_ERUS DBRC user modified
.... 1... APQEL_ERPM DBRC permanent error
.... .1.. APQEL_INDT Indoubt EEQE
.... ..1. APQEL_CIIND Index CI indicator
1 (1) CHARACTER 4 APQEL_EQE EEQE
5 (5) CHARACTER 8 APQEL_SSID SSID which owns the EEQE
|
| Figure 26. Format of QUERY TYPE=DB (HALDB Master and Partitions) Output
|
The DBDS information is returned only if DDN is specified.
Figure 27 on page 380, Figure 28 on page 381, and Figure 21 on page 374 describe
the fields contained in the DSPAPQHB and DSPAPQHP blocks shown in Figure 26.
Refer to Figure 29 on page 383 for an illustration of the fields of the DBDS output.
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 60 DSPAPQHB
0 (0) CHARACTER 8 APQHB_DBNAME HALDB name
8 (8) SIGNED 4 *(4) Reserved
24 (18) BIT(8) 1 APQHB_FLAGS Flags
1... .... APQHB_NONRV Non-recoverable
.1.. .... APQHB_ICNDIS IC needed disabled
..1. .... APQHB_OLRCAP HALDB is OLR capable
25 (19) BIT(8) 1 APQHB_ORG DB organization
1... .... APQHB_PSINDEX PSINDEX DB
.1.. .... APQHB_PHIDAM PHIDAM DB
..1. .... APQHB_PHDAM PHDAM DB
...1 .... APQHB_OSAM OSAM DB
.... 1111 * Reserved
26 (1A) UNSIGNED 1 APQHB_SHRLVL Share level
27 (1B) UNSIGNED 1 APQHB_DSGCNT # DS Group members
28 (1C) UNSIGNED 2 APQHB_DMBNUM Global DMB number
30 (1E) UNSIGNED 2 APQHB_PARTID Current Partition ID
32 (20) SIGNED 2 APQHB_PART# Number of parts in HALDB
34 (22) UNSIGNED 2 APQHB_VERSION# Version number
36 (24) CHARACTER 8 APQHB_PSNAME Name of Part Sel Routine
44 (2C) CHARACTER 8 APQHB_GSGNAME GSG name
52 (34) CHARACTER 8 APQHB_RECOVGRP Recovery Group name
CONSTANTS
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 192 DSPAPQHP
0 (0) CHARACTER 8 APQHP_HALDBNAME HALDB name
8 (8) CHARACTER 8 APQHP_PARTNAME Partition name
16 (10) UNSIGNED 4 APQHP_SSLIST Offset to SS list (DSPAPQSL),
zero if no SS auth'd
20 (14) UNSIGNED 4 APQHP_KEYSTRING Offset to KEYSTRING
(apqhp_PString), zero is no
key/string
24 (18) UNSIGNED 4 APQHP_DSGINFOOFFSET
Offset to data set group
information
28 (1C) SIGNED 4 * Reserved
32 (20) CHARACTER 44 *
32 (20) CHARACTER 37 APQHP_DSNBASE Base Partition DSN
76 (4C) CHARACTER 18 APQHP_HDAM PHDAM fields
76 (4C) CHARACTER 8 APQHP_RMNAME Randomizing module name
84 (54) SIGNED 4 APQHP_RBN Max relative block number
88 (58) SIGNED 4 APQHP_BYTES Max # of bytes
92 (5C) UNSIGNED 2 APQHP_ANCHR # of root anchor points
94 (5E) UNSIGNED 1 APQHP_FBFF Free block frequency factor
95 (5F) UNSIGNED 1 APQHP_FSPF Free space percentage factor
96 (60) UNSIGNED 2 APQHP_PARTID Partition ID
98 (62) SIGNED 2 APQHP_PSTLN Length of Part Key/String,
apqhp_PString
100 (64) UNSIGNED 2 APQHP_DSGINFOLEN
Length of each
apqhp_DSGinfo entry
102 (66) UNSIGNED 1 APQHP_DSGCNT DSG count
103 (67) BIT(8) 1 APQHP_FLAGS Flags
1... .... APQHP_PINIT Partition must be initialized
.1.. .... APQHP_ORDBDS 0=A-J/1=M-V DBDS active
..1. .... APQHP_OLRON OLR active
...1 .... APQHP_DISAB Partition Disabled
.... 1... APQHP_MVDBDS 1 = M-V DBDS exist
.... .1.. APQHP_OLRCAP Partition is OLR capable
============================================================================
If the Partitioned DB uses high keys, i.e. no Partition
Selection routine, the next two fields are used to sort the
partitions in key sequence.
============================================================================
104 (68) CHARACTER 8 APQHP_PREV DDN of previous partition
112 (70) CHARACTER 8 APQHP_NEXT DDN of next partition
120 (78) CHARACTER 8 APQHP_OLRIMS Owning IMS for OLR
128 (80) UNSIGNED 2 APQHP_IRCNT IC receive needed counter
130 (82) BIT(8) 1 APQHP_AUFLAG Authorization flags
1... .... APQHP_BKFLG Backout needed
.1.. .... APQHP_PAFLG Prohibit authorization
..1. .... APQHP_RDFLG Read only SS auth
...1 .... APQHP_NONRV Non-recoverable
DBDS Output:
|
| Figure 29. Format of QUERY TYPE=DB (DBDS) Output
|
Recovery information (RCVINFO) is returned only if the LIST parameter is
specified.
Figure 30 on page 384 and Figure 25 on page 379 describe the fields contained in
the DSPAPQDS block shown in Figure 29. Refer to Figure 31 on page 385 for an
illustration of the Recovery Information output fields.
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 160 DSPAPQDS
0 (0) CHARACTER 8 APQDS_DBNAME Database name
8 (8) CHARACTER 8 APQDS_DDNAME DD name
16 (10) UNSIGNED 4 APQDS_EEQELIST
Offset to EEQE list
(DSPAPQEL), zero if no EEQEs
20 (14) SIGNED 4 *(3) Reserved
32 (20) CHARACTER 44 APQDS_DSN Data set name
76 (4C) UNSIGNED 2 APQDS_RTPRD IC retention period
78 (4E) UNSIGNED 2 APQDS_DSID Data set ID number
80 (50) UNSIGNED 4 APQDS_DSSN Data set sequence number
84 (54) UNSIGNED 4 APQDS_RUSID Recovered-to USID(trkr)
88 (58) BIT(8) 1 APQDS_FLAGS BINARY ZEROS
1... .... APQDS_RECYC REUSE image copies
.1.. .... APQDS_ICREC Image Copy Recommended
..1. .... APQDS_RCVRQ Receive required
...1 .... APQDS_IC Image Copy Needed
.... 1... APQDS_RECOV Recovery Needed
.... .1.. APQDS_NONRV Non-recoverable
89 (59) BIT(8) 1 APQDS_DSORG Data set organization
1... .... APQDS_VSAM 1 = VSAM, 0 = NON-VSAM
.1.. .... APQDS_INDEX 0 = Non-indexed (OSAM or ESDS),
1 = Indexed(ISAM or KSDS)
..11 1111 * Reserved - zeroes
90 (5A) CHARACTER 1 APQDS_DBORG IMS DB organization
91 (5B) UNSIGNED 1 * Reserved
92 (5C) UNSIGNED 2 APQDS_GENMX Max number of ICs that may be
predefined for this area
94 (5E) UNSIGNED 2 APQDS_AVAILIC#
Number of available ICs for
this area
96 (60) UNSIGNED 2 APQDS_USEDIC# Number of ICs used
98 (62) SIGNED 2 APQDS_EEQECOUNT
EEQE count
100 (64) UNSIGNED 2 APQDS_EEQELENGTH
EEQE entry length
102 (66) BIT(8) 1 APQDS_FLG1 Flags
1... .... APQDS_RRGAL REORG since last ALLOC, only
set if RSR-covered
.1.. .... APQDS_TSRAL TS recov since last ALLOC, only
set if RSR-covered
103 (67) BIT(8) 1 APQDS_FLG2 DBDS type flags
1... .... APQDS_PART TYPEPART record
.1.. .... APQDS_PDATA TYPEPART subtype DATA
..1. .... APQDS_PILE TYPEPART subtype ILE
...1 .... APQDS_PINDX TYPEPART subtype Index
104 (68) CHARACTER 8 APQDS_CAGRPNAME
Change Accum group name
112 (70) CHARACTER 40 APQDS_JCL GENJCL members
112 (70) CHARACTER 8 APQDS_ICJCL Image copy member
120 (78) CHARACTER 8 APQDS_OIJCL Online IC member
128 (80) CHARACTER 8 APQDS_RCJCL Recovery member
136 (88) CHARACTER 8 APQDS_DFJCL DEFLTJCL member
144 (90) CHARACTER 8 APQDS_RVJCL Receive JCL member
152 (98) CHARACTER 8 APQDS_ODDN OLR partner DBDS
CONSTANTS
|
| Figure 31. Format of QUERY TYPE=DB (RCVINFO) Output
|
Recovery information (RCVINFO) is returned only if the LIST parameter is
specified. The pointers will be zero if either the specific information does not exist
or it wasn’t requested.
Figure 32 on page 386, Figure 33 on page 386, Figure 34 on page 387, Figure 35 on
page 388, and Figure 36 on page 389 describe the fields contained in the
DSPAPQRI block shown in Figure 31.
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 32 DSPAPQRI
0 (0) CHARACTER 8 APQRI_DBNAME Database name
8 (8) CHARACTER 8 *
8 (8) CHARACTER 8 APQRI_DDNAME DD name or
8 (8) CHARACTER 8 APQRI_AREANAME
Area name
16 (10) ADDRESS 4 APQRI_ALLOCPTR
ptr to ALLOC chain
20 (14) ADDRESS 4 APQRI_ICPTR ptr to IC chain
24 (18) ADDRESS 4 APQRI_RECOVPTR
ptr to RECOV chain
28 (1C) ADDRESS 4 APQRI_REORGPTR
ptr to REORG chain
CONSTANTS
| OFFSET OFFSET
| DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
| ======== ======== ========= ======== ============== ===============================
| 0 (0) STRUCTURE 88 DSPAPQAL
| 0 (0) CHARACTER 8 APQAL_DBNAME Database name
| 8 (8) CHARACTER 8 *
| 8 (8) CHARACTER 8 APQAL_DDNAME DD name or
| 8 (8) CHARACTER 8 APQAL_AREANAME Area name
| 16 (10) CHARACTER 12 APQAL_ALLOCTM Allocation time
| 28 (1C) CHARACTER 12 APQAL_DALTM Deallocation time
| 40 (28) CHARACTER 12 APQAL_STRTM Log start time
| 52 (34) UNSIGNED 4 APQAL_DSSN Field for DSSN value
| 56 (38) UNSIGNED 4 APQAL_USID Update set identifier
| 60 (3C) CHARACTER 8 APQAL_ALRID LRID of begin-upd rec
| 68 (44) CHARACTER 8 APQAL_DLRID LRID of end-upd rec
| 76 (4C) CHARACTER 8 APQAL_SLRID Last LRID applied if suspended
| 84 (54) BIT(8) 1 APQAL_FLAGS Flags
| 1... .... APQAL_TSUSP Tracking is suspended
| .1.. .... APQAL_NAPPL No records applied
| ..1. .... APQAL_CICPT Fuzzy ic purge time
| 85 (55) CHARACTER 3 * Reserved
| CONSTANTS
|
| LEN TYPE VALUE NAME DESCRIPTION
| ===== ========= ================= =============== ===============================
| 8 CHARACTER DSPAPQAL APQAL_EYECATCHER
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 64 DSPAPQIC
0 (0) CHARACTER 8 APQIC_DBNAME Database name
8 (8) CHARACTER 8 *
8 (8) CHARACTER 8 APQIC_DDNAME DD name or
8 (8) CHARACTER 8 APQIC_AREANAME
Area name
16 (10) CHARACTER 12 APQIC_STARTIME
IC start time, packed decimal
28 (1C) CHARACTER 12 APQIC_STOPTIME
IC stop time, packed decimal
40 (28) BIT(8) 1 APQIC_TYPE IMAGE COPY TYPE
1... .... APQIC_BATCH BATCH
.1.. .... APQIC_CIC CONCURRENT
..1. .... APQIC_USERIC USER IMAGE COPY
...1 .... APQIC_ONLINE ONLINE
.... 1... APQIC_SMSIC SMS IC w/ DB exclusive
.... .1.. APQIC_SMSCC SMS IC w/ DB shared
41 (29) BIT(8) 1 APQIC_STATUS IC status flags
1... .... APQIC_AVAIL Available IC
.1.. .... APQIC_IC1 Image Copy 1 exists
..1. .... APQIC_IC2 Image Copy 2 exists
...1 .... APQIC_ERR1 Error on image 1
.... 1... APQIC_ERR2 Error on image 2
.... .1.. APQIC_EMP2 Image 2 defined and unused
42 (2A) BIT(8) 1 APQIC_FLAGS
1... .... APQIC_HSINP HSSP CIC in progress
.1.. .... APQIC_CAT Catalogued IC (HSSP)
43 (2B) CHARACTER 1 * Reserved
44 (2C) CHARACTER 2 *
44 (2C) UNSIGNED 2 APQIC_OFF1 Offset to image 1 data
44 (2C) UNSIGNED 2 APQIC_OFFU Offset to user IC data
46 (2E) UNSIGNED 2 APQIC_OFF2 Offset to image 2 data
48 (30) UNSIGNED 4 APQIC_CNT12 Record count
52 (34) UNSIGNED 4 APQIC_USID Update set ID
56 (38) CHARACTER 2 *
56 (38) UNSIGNED 2 APQIC_LEN12 Length of image 1/2 data
56 (38) UNSIGNED 2 APQIC_LENU Length of user IC data
58 (3A) CHARACTER 6 * Reserved
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 64 APQIC_IC12 Data for image 1 or 2
0 (0) CHARACTER 44 APQIC_DSN12 Data set name
44 (2C) UNSIGNED 2 APQIC_FILE File sequence number
46 (2E) CHARACTER 8 APQIC_RUT12 Unit device type
54 (36) UNSIGNED 2 APQIC_VOLCT # of volumes predefined
56 (38) UNSIGNED 2 APQIC_VOLUS # of volumes used
58 (3A) UNSIGNED 2 APQIC_VOLLISTLEN
Length of each volume list
entry in apqic_VOLS
60 (3C) UNSIGNED 4 APQIC_VOLLISTOFFSET
Offset to volume list
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) CHARACTER 6 APQIC_VOLS List of VOLSERs
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 80 APQIC_USER Data for user IC
0 (0) CHARACTER 80 APQIC_UDATA User supplied data
CONSTANTS
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 49 DSPAPQRV
0 (0) CHARACTER 8 APQRV_DBNAME Database name
8 (8) CHARACTER 8 *
8 (8) CHARACTER 8 APQRV_DDNAME DD name or
8 (8) CHARACTER 8 APQRV_AREANAME
Area name
16 (10) CHARACTER 12 APQRV_RUNTIME The time at which the DBDS was
recovered.
28 (1C) CHARACTER 12 APQRV_ENDTIME Partial recovery only, the time
to which the DBDS was restored
40 (28) UNSIGNED 4 APQRV_FUSID First undone USID
44 (2C) UNSIGNED 4 APQRV_LUSID Last undone USID
48 (30) BIT(8) 1 APQRV_FLAGS Flags
1... .... APQRV_PITR Point In Time Recovery
CONSTANTS
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 60 DSPAPQRR
0 (0) CHARACTER 8 APQRR_DBNAME Database name
8 (8) CHARACTER 8 *
8 (8) CHARACTER 8 APQRR_DDNAME DD name or
8 (8) CHARACTER 8 APQRR_AREANAME
Area name
16 (10) CHARACTER 12 APQRR_RUNTIME The time at which the DBDS was
reorganized.
28 (1C) CHARACTER 12 APQRR_STOPTIME
Stoptime of online reorg
40 (28) BIT(8) 1 APQRR_FLAGS
1... .... APQRR_ONL 1=ONLINE/0=OFFLINE reorg
.1.. .... APQRR_RECOV 1=May be used for recovery
41 (29) CHARACTER 3 * Reserved
44 (2C) UNSIGNED 4 APQRR_USID Associated USID
48 (30) CHARACTER 12 APQRR_PITR Stoptime moved - PITR
CONSTANTS
|
| Figure 37. Format of QUERY TYPE=DB (Database Not Found) Output
|
| This output block is returned when some of the databases specified in the DBLIST
| block could not be found in the RECON. One block is returned for each database
| that could not be found. The database name is included in the data area of this
| block.
| When a database is not found, the macro call receives a return code of four
| (RC=4). If none of the databases in the list are found (RC=8), no output blocks are
| returned.
| Figure 38 on page 390 describes the fields contained in the DSPAPQNF block
| shown in Figure 37.
|
| OFFSET OFFSET
| DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
| ======== ======== ========= ======== ============== ===============================
| 0 (0) STRUCTURE 8 DSPAPQNF
| 0 (0) CHARACTER 8 APQNF_DBNAME DB name
|
| Figure 38. DSECT of DSPAPQNF
|
Group Query
The Group query (DSPAPI FUNC=QUERY TYPE=xxxxGROUP) request is used to
retrieve group and member information for one of the following types of groups
registered in RECON:
v DBDS group (TYPE=DBDSGROUP)
v DB group (TYPE=DBGROUP)
v Recovery group (TYPE=RECOVGROUP)
v CA group (TYPE=CAGROUP)
v Global service group (TYPE=GSGROUP)
| NAME=* MF=S
| TOKEN=address OUTPUT=output
NAME=name MF=(S,list)
MF=(L,list)
,COMPLETE
MF=(M,list )
,NOCHECK
,COMPLETE
MF=(E,list )
,NOCHECK
VERSION=1.0
RETCODE=returncode RSNCODE=reasoncode VERSION=number
|
| Table 22. Return and Reason Codes for TYPE=xxxxGROUP Query Requests (continued)
| Return Codes Reason Codes Meaning
| X'00000030' X'C9000008' Invalid NAME field address. The address of the
| field containing the NAME failed validity
| checking. The address specifies storage not owned
| by the calling program.
| X'00000030' X'D8000001' Parameter error. Missing or invalid OUTPUT
| parameter.
| X'00000030' X'D8300001' Parameter error. CAINFO=YES is only allowed
| with TYPE=CAGROUP.
|
|
| Figure 39. Format for QUERY TYPE=DBDSGROUP, DBGROUP, RECOVGROUP Output
|
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 32 DSPAPQDG
0 (0) CHARACTER 8 APQDG_GROUPNAME
Group name
8 (8) UNSIGNED 4 APQDG_MEMBERINFO
Offset to group member list
12 (C) UNSIGNED 2 APQDG_MEMBERLEN
Length of group member entry
14 (E) SIGNED 2 APQDG_MEMBERCOUNT
Number of group members
16 (10) SIGNED 4 *(3) Reserved
28 (1C) CHARACTER 4 * Reserved
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 16 APQDG_MEMBER List of group members
0 (0) CHARACTER 16 *
0 (0) CHARACTER 16 APQDG_DBDSG DBDS group
0 (0) CHARACTER 8 APQDG_DBDSG_DBNAME
Database name
8 (8) CHARACTER 8 *
8 (8) CHARACTER 8 APQDG_DBDSG_DDNAME
DD name or
8 (8) CHARACTER 8 APQDG_DBDSG_AREANAME
AREA name
0 (0) CHARACTER 16 APQDG_DBG DB group
0 (0) CHARACTER 8 *
0 (0) CHARACTER 8 APQDG_DBG_DBNAME
Database name or
0 (0) CHARACTER 8 APQDG_DBG_AREANAME
AREA name
8 (8) CHARACTER 8 * Not used
0 (0) CHARACTER 16 APQDG_RECOVG Recovery group
0 (0) CHARACTER 8 APQDG_RECOVG_DBNAME
Database name
8 (8) CHARACTER 8 APQDG_RECOVG_AREANAME
AREA name, null if
not Fast Path
CONSTANTS
|
| Figure 41. Format for QUERY TYPE=CAGROUP Output
|
The CA block is only returned when CAINFO=YES is specified and records of a
change accumulation exist in the RECON.
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 48 DSPAPQCG
0 (0) CHARACTER 8 APQCG_GROUPNAME
Group name
8 (8) UNSIGNED 4 APQCG_MEMBERINFO
Offset to group member list
12 (C) UNSIGNED 2 APQCG_MEMBERLEN
Length of group member entry
14 (E) SIGNED 2 APQCG_MEMBERCOUNT
Number of group members
16 (10) SIGNED 4 *(2) Reserved
24 (18) SIGNED 2 APQCG_GRPMAX Maximum number of CAs that may
be predefined for this CA group
26 (1A) SIGNED 2 APQCG_AVAILCA#
Number of available CA data
sets for this group
28 (1C) SIGNED 2 APQCG_USEDCA# Number of used CA data sets
30 (1E) BIT(8) 1 APQCG_FLAGS Flags
1... .... APQCG_REUSE Reuse CA data sets
31 (1F) CHARACTER 1 * Reserved
32 (20) CHARACTER 8 APQCG_CAJCL GENJCL CAJCL member name
40 (28) CHARACTER 8 APQCG_DFJCL DEFLTJCL member name
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 16 APQCG_MEMBER List of group members
0 (0) CHARACTER 8 APQCG_DBNAME Database name
8 (8) CHARACTER 8 *
8 (8) CHARACTER 8 APQCG_DDNAME DD name or
8 (8) CHARACTER 8 APQCG_AREANAME
AREA name
CONSTANTS
| OFFSET OFFSET
| DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
| ======== ======== ========= ======== ============== ===============================
| 0 (0) STRUCTURE 96 DSPAPQCA
| 0 (0) CHARACTER 8 APQCA_GROUPNAME
| Group name
| 8 (8) UNSIGNED 4 APQCA_MEMBERINFO
| Offset to group member list
| 12 (C) UNSIGNED 2 APQCA_MEMBERLEN
| Length of each member entry
| 14 (E) SIGNED 2 APQCA_MEMBERCOUNT
| Number of group members
| 16 (10) UNSIGNED 4 APQCA_VOLINFO Offset to volume information
| 20 (14) SIGNED 4 * Reserved
| 24 (18) CHARACTER 44 APQCA_DSN Data set name
| 68 (44) CHARACTER 12 APQCA_STOPTIME
| Packed decimal date/time - for
| predefined datasets, represents
| record creation time.
| Otherwise, it is the stoptime
| of the last logtape volume used
| as input to the Change
| Accumulation utility that
| produced this CA as output. If
| the CA run included an
| 'incomplete log subset' it is
| the start time of the first
| truncated log volume.
| 80 (50) CHARACTER 12 APQCA_RUNTIME CA run time
| 92 (5C) BIT(8) 1 APQCA_FLAGS Flags
| 1... .... APQCA_ERROR Error on data set
| .1.. .... APQCA_SUBSET Subset of logs used for CA
| ..1. .... APQCA_COMMAND
| SUBSET/COMP has been set or
| reset with an external cmd
| 93 (5D) CHARACTER 3 * Reserved
|
| OFFSET OFFSET
| DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
| ======== ======== ========= ======== ============== ===============================
| 0 (0) STRUCTURE 56 APQCA_MEMBER List of group members
| 0 (0) CHARACTER 8 APQCA_MEM_DBNAME
| Database name
| 8 (8) CHARACTER 8 *
| 8 (8) CHARACTER 8 APQCA_MEM_DDNAME
| DD name or
| 8 (8) CHARACTER 8 APQCA_MEM_AREANAME
| AREA name
| 16 (10) UNSIGNED 4 APQCA_MEM_DSSN
| Data Set sequence number
| 20 (14) UNSIGNED 4 APQCA_MEM_USID
| USID of last change
| accumulated
| 24 (18) CHARACTER 8 APQCA_MEM_LRID
| LRID of last change accumulated
| 32 (20) CHARACTER 12 APQCA_MEM_PURGETIME
| Purge time
| 44 (2C) CHARACTER 6 APQCA_MEM_LSN Lock sequence number
| 50 (32) BIT(8) 1 APQCA_MEM_FLAGS
| Member flags
| 1... .... APQCA_MEM_NOCHG
| No changes accumulated
| .1.. .... APQCA_MEM_INDOUBT
| Indoubt EEQEs accumulated
| ..1. .... APQCA_MEM_INCOMP
| Incomplete CA
| 51 (33) CHARACTER 5 * Reserved
|
| Figure 43. DSECT of DSPAPQCA (Part 1 of 2)
| Chapter 17. DBRC Query Request 397
QUERY TYPE=xxxxGROUP
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 24 APQCA_VOL_DATA Volume data
0 (0) UNSIGNED 2 APQCA_VOL_FILESEQ
File sequence number
2 (2) CHARACTER 8 APQCA_VOL_UNIT
Unit type
10 (A) UNSIGNED 2 APQCA_VOL_COUNT
Number of VOLSERs defined
12 (C) UNSIGNED 2 APQCA_VOL_USED
Number of VOLSERs used
14 (E) SIGNED 2 APQCA_VOL_LENGTH
Length of each VOLSER
16 (10) UNSIGNED 4 APQCA_VOL_OFFSET
Offset to VOLSER
information
20 (14) CHARACTER 4 * Reserved
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 6 APQCA_VOLSER List of VOLSERs
CONSTANTS
|
| Figure 44. Format for QUERY TYPE=GSGROUP Output
|
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 80 DSPAPQGG
0 (0) CHARACTER 8 APQGG_GROUPNAME
Group name
8 (8) UNSIGNED 4 APQGG_MEMBERINFO
Offset to group member list
12 (C) UNSIGNED 2 APQGG_MEMBERLEN
Length of group member entry
14 (E) SIGNED 2 APQGG_MEMBERCOUNT
Number of group members
16 (10) SIGNED 4 *(2) Reserved
24 (18) UNSIGNED 4 APQGG_SDSN# SLDS DSN sequence number
28 (1C) UNSIGNED 4 APQGG_PTOKEN Current PRILOG token
32 (20) UNSIGNED 4 APQGG_MPTOK Min required PRILOG token
36 (24) UNSIGNED 4 APQGG_TTOKN Planned takeover token
40 (28) CHARACTER 12 APQGG_LOGTIME Current log start time
52 (34) CHARACTER 12 APQGG_HITIME Highest time ever received from
the active site
64 (40) CHARACTER 8 APQGG_TSNAME Tracking subsystem ID
72 (48) BIT(8) 1 APQGG_FLAGS
1... .... APQGG_ACTTKO Active takeover in progress
.1.. .... APQGG_1STSIGNON
Indicates the first signon of
an active subsystem after an
RSR takeover
..1. .... APQGG_TRKTKO Tracker takeover in progress
...1 .... APQGG_RESET RESET.GSG issued
73 (49) CHARACTER 7 * Reserved
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 16 APQGG_MEMBER List of group members
0 (0) CHARACTER 8 APQGG_SGNAME Service group name
8 (8) CHARACTER 1 APQGG_SGROLE Role 'A' OR 'T'
9 (9) BIT(8) 1 APQGG_SGFLAGS Flags
1... .... APQGG_SGLOCAL
1 = local SG
10 (A) CHARACTER 6 * Reserved
CONSTANTS
Log Query
The Log query (DSPAPI FUNC=QUERY TYPE=LOG) request is used to retrieve log
information from RECON for a specific instance of a subsystem.
If the request is for non-RSR logs or RSR active subsystem logs, information from
the following RECON records is returned:
v PRILOG
v LOGALL
v SECLOG (if applicable)
v PRISLDS (if applicable)
v SECSLDS (if applicable)
If the request is for RSR tracking subsystem logs, information from the following
RECON records is returned:
v PRITSLDS
v SECTSLDS (if applicable)
| LOC=SPEC TRACKER=NO
LOC=PREV TRACKER=YES SSID=subsystem
LOC=NEXT SSID=subsystem_ID
OUTPUT=output
RETCODE=returncode RSNCODE=reasoncode
| MF=S VERSION=1.0
MF=(S,list) VERSION=number
MF=(L,list)
,COMPLETE
MF=(M,list )
,NOCHECK
,COMPLETE
MF=(E,list )
,NOCHECK
| queries (TRACKER=YES). For other queries, you can only specify the SSID
| parameter when you request the previous or next log of a specific
| subsystem, that is, you specify LOC=PREV or LOC=NEXT.
TRACKER=YES |NO
Optional parameter that specifies whether log information is being
requested for an RSR tracking subsystem or not. Specify TRACKER=YES to
request the RSR tracker’s log information. Specify TRACKER=NO to
request log information from a non-RSR subsystem or an active subsystem
of an RSR system. TRACKER=NO is the default.
MF=S | L | M | E
Optional parameter that specifies the macro form of the request. See
“Macro Forms of the DSPAPI Macro” on page 356 for the details of the
parameter values.
OUTPUT=symbol | (2 - 12)
Required parameter that specifies a field to receive a pointer to the first
block of a possible chain of log information blocks. See “Output for the
TYPE=LOG Query Request” on page 403 for a detailed description of the
information blocks returned.
The output address is zero if no output was built. This can occur if nothing
in the RECON satisfies the request or if an error occurs before any output
could be built.
The storage for the output blocks is not preallocated. DBRC acquires
private storage for these blocks. The requesting application is responsible
for freeing this storage by using the Buffer Release request (DSPAPI
FUNC=RELBUF), specifying the returned output address.
RETCODE=symbol | (2 - 12)
Optional parameter that specifies a place in storage to receive the return
code. If specified as a symbol, the symbol must be the label of a word of
storage. If specified as a register, the register must contain the address of a
word of storage. If not specified, the return code is placed in register 15.
RSNCODE=symbol | (2 - 12)
Optional parameter that specifies a place in storage to receive the reason
code. If specified as a symbol, the symbol must be the label of a word of
storage. If specified as a register, the register must contain the address of a
word of storage. If not specified, the reason code is placed in register 0.
VERSION=1.0 | number
Optional parameter that specifies the version number of the parameter list
to be generated by this request.
To use the parameters associated with a version, you must specify the
number of that version or a later version. If you specify an earlier version
level, the parameter is not accepted for processing and an error message is
issued at assembly time. If parameters have a version dependency, the
parameter descriptions with each request type identify the version number
required.
The default version is 1.0.
| SSID=symbol | (2-12)
| Optional parameter that specifies the subsystem name for the log being
| queried. The SSID parameter is required for RSR tracking subsystem log
| queries (TRACKER=YES). Otherwise, you can only specify the SSID
| Table 23. Return and Reason Codes for TYPE=LOG Query Requests (continued)
| Return Codes Reason Codes Meaning
| X'00000030' X'C9000001' Invalid OUTPUT field address. The address of the
| field to contain the OUTPUT address failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000001' Invalid SSID field address. The address of the
| field containing the SSID failed validity checking.
| The address specifies storage not owned by the
| calling program.
| X'00000030' X'C9000001' Invalid STARTIME field address. The address of
| the field containing the STARTIME failed validity
| checking. The address specifies storage not owned
| by the calling program.
| X'00000030' X'D8000001' Parameter error. Missing or invalid OUTPUT
| parameter.
| X'00000030' X'D8400001' Parameter error. STARTIME parameter is
| required.
| X'00000030' X'D8400002' Parameter error. SSID is required with
| TRACKER=YES.
| X'00000030' X'D8400003' Parameter error. SSID parameter is not allowed
| for active logs (TRACKER=NO) unless specified
| with LOC=PREV or NEXT.
|
|
dep next block
DSPAPQLI length LOGINFO version
ptr ptr offset
...
0
SECTSLDS block
PRITSLDS block
SECSLDS block
PRISLDS block
SECLOG block
LOGALL block
PRILOG block
|
| Figure 46. Format for QUERY TYPE=LOG Log Information Output
|
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 48 DSPAPQLI
0 (0) CHARACTER 8 APQLI_SSID Log SSID
8 (8) CHARACTER 12 APQLI_STARTTIME
Log start time
20 (14) ADDRESS 4 APQLI_PRILOGPTR
ptr to PRILOG block
24 (18) ADDRESS 4 APQLI_LOGALLPTR
ptr to LOGALL block
28 (1C) ADDRESS 4 APQLI_SECLOGPTR
ptr to SECLOG block
32 (20) ADDRESS 4 APQLI_PRISLDSPTR
ptr to PRISLDS block
36 (24) ADDRESS 4 APQLI_SECSLDSPTR
ptr to SECSLDS block
40 (28) ADDRESS 4 APQLI_PRITSLDSPTR
ptr to PRITSLDS block
44 (2C) ADDRESS 4 APQLI_SECTSLDSPTR
ptr to SECTSLDS block
CONSTANTS
|
| Figure 48. Format for QUERY TYPE=LOG Output for PRILOG, SECLOG, PRISLDS, SECSLDS, PRITSLDS, and
| SECTSLDS
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 96 DSPAPQLG
0 (0) UNSIGNED 4 APQLG_FIRSTLOGDS Offset to first log DS entry
4 (4) UNSIGNED 4 APQLG_LASTLOGDS Offset to last log DS entry
8 (8) SIGNED 4 *(2) Reserved
16 (10) CHARACTER 8 APQLG_SSID Subsystem ID
24 (18) CHARACTER 12 APQLG_STARTTIME Log start time
36 (24) CHARACTER 12 APQLG_ENDTIME Log end time
48 (30) SIGNED 4 APQLG_DSNCOUNT Number of data sets
52 (34) UNSIGNED 1 APQLG_RELVL Log Release Level
53 (35) BIT(8) 1 APQLG_FLAGS1 Flags
1... .... APQLG_ONLINE Online log
.1.. .... APQLG_LSTAR Last OLDS has been archived
..1. .... APQLG_LSTNA Last OLDS has not been archived
...1 .... APQLG_GAP There is a gap in this log
.... 1... APQLG_PRGAP There is a gap in a prev log
54 (36) BIT(8) 1 APQLG_FLAGS2 Flags
1... .... APQLG_TRKNG Tracking log data set
.1.. .... APQLG_NTERM IMS subsystem has terminated normally
..1. .... APQLG_BKLOG Batch backout log
55 (37) CHARACTER 1 * Reserved
56 (38) CHARACTER 8 APQLG_FIRSTLRID Id of first log record
64 (40) UNSIGNED 4 APQLG_PTOKEN PRILOG token
68 (44) CHARACTER 8 APQLG_GSGNAME GSG name
76 (4C) CHARACTER 12 APQLG_CHKPT0 Checkpoint 0 time
88 (58) CHARACTER 8 * Reserved
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 120 APQLG_DS_ENTRY Data set entry
0 (0) UNSIGNED 4 APQLG_DS_NEXT Offset to next log DS entry
4 (4) UNSIGNED 4 APQLG_DS_PREV Offset to prev log DS entry
8 (8) UNSIGNED 4 APQLG_DS_VOLINFO Offset to DS volume info
12 (C) CHARACTER 44 APQLG_DS_DSNAME Data set name
56 (38) CHARACTER 12 APQLG_DS_STARTTIME DS start time
68 (44) CHARACTER 12 APQLG_DS_ENDTIME DS end time
80 (50) BIT(8) 1 APQLG_DS_FLAGS1 Flags
1... .... APQLG_DS_ERR I/O Error
.1.. .... APQLG_DS_DUMMY Log compressed, 1st DS dummy
..1. .... APQLG_DS_RSTBG Restart begin
...1 .... APQLG_DS_RSTEN Restart end
.... 1... APQLG_DS_COLD Cold start
.... .1.. APQLG_DS_NOBMP ERE NOBMP
.... ..1. APQLG_DS_SAVER Backout UORs saved
.... ...1 APQLG_DS_NOID Backouts not identified
81 (51) BIT(8) 1 APQLG_DS_FLAGS2 Flags
1... .... APQLG_DS_TRKARCH Tracking log DS archived
.1.. .... APQLG_DS_TRKFEOV Tracking log closed FEOV
82 (52) CHARACTER 2 APQLG_DS_DFLG3 Reserved
84 (54) CHARACTER 8 APQLG_DS_FLRID First log record ID
92 (5C) CHARACTER 8 APQLG_DS_LLRID Last log record ID
100 (64) UNSIGNED 4 APQLG_DS_LASTBLKSEQNO Last block seq number
104 (68) CHARACTER 8 APQLG_DS_UNITTYPE Unit type name
112 (70) UNSIGNED 2 APQLG_DS_FILESEQ File sequence no
114 (72) UNSIGNED 2 APQLG_DS_VOLCOUNT Number of volumes
116 (74) UNSIGNED 1 APQLG_DS_CKPTCOUNT Number of chkpts on DSN
117 (75) BIT(8) 1 APQLG_DS_CHKPTTYPES CHKPT types.
1... .... APQLG_DS_SIMPL SIMPLE checkpoint
.1.. .... APQLG_DS_SNAPQ SNAPQ checkpoint
..1. .... APQLG_DS_DUMPQ DUMPQ checkpoint
...1 .... APQLG_DS_PURGE PURGE checkpoint
.... 1... APQLG_DS_FREEZ FREEZE checkpoint
118 (76) UNSIGNED 2 * Reserved
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 48 APQLG_DSVOLUME Volume information
0 (0) UNSIGNED 4 APQLG_DSVOL_NEXT Offset to next volume
4 (4) CHARACTER 6 APQLG_DSVOL_SER VOLSER
10 (A) UNSIGNED 1 APQLG_DSVOL_CKPTCT Volume chkpt count
11 (B) CHARACTER 1 * Reserved
12 (C) CHARACTER 12 APQLG_DSVOL_ENDTIME Volume end time
24 (18) CHARACTER 12 APQLG_DSVOL_CPTID Checkpoint ID
36 (24) CHARACTER 6 APQLG_DSVOL_LOCKSN Lock Sequence Number
42 (2A) CHARACTER 6 * Reserved
CONSTANTS
|
| Figure 50. Format for QUERY TYPE=LOG Output for LOGALL
|
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 48 DSPAPQLA
0 (0) UNSIGNED 4 APQLA_DBDSAREAINFO
Offset to allocated
DBDS/Area list
4 (4) SIGNED 4 *(3) Reserved
16 (10) CHARACTER 12 APQLA_PRILOGTIME
PRILOG time
28 (1C) BIT(8) 1 APQLA_FLAGS Flags
1... .... APQLA_NONREGD
Non-registered DB updated
29 (1D) UNSIGNED 3 APQLA_DBDSAREACOUNT
Number of DBDS/Areas
allocated on this log
32 (20) UNSIGNED 4 APQLA_DBDSAREALEN
Length of DBDS/Area entry
36 (24) CHARACTER 12 APQLA_EARLIESTALLOC
Earliest ALLOC time for
this log
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 32 APQLA_DBDSAREA List of allocated DBDSs and
Areas
0 (0) CHARACTER 8 APQLA_DBNAME Database name
8 (8) CHARACTER 8 *
8 (8) CHARACTER 8 APQLA_DDNAME DD name or
8 (8) CHARACTER 8 APQLA_AREANAME
AREA name
16 (10) CHARACTER 12 APQLA_FIRSTALLOC
Earliest ALLOC time for this
DBDS/Area on this log
28 (1C) SIGNED 2 APQLA_ALLNO Number of ALLOCs for this
DBDS/Area on this log
30 (1E) CHARACTER 2 * Reserved
CONSTANTS
OLDS Query
The OLDS query (DSPAPI FUNC=QUERY TYPE=OLDS) request is used to retrieve
online log data set information from the RECON for a specific subsystem or all
subsystems.
| SSID=* MF=S
| OUTPUT=output
SSID=subsystem_ID MF=(S,list)
MF=(L,list)
,COMPLETE
MF=(M,list )
,NOCHECK
,COMPLETE
MF=(E,list )
,NOCHECK
VERSION=1.0
RETCODE=returncode RSNCODE=reasoncode VERSION=number
|
for freeing this storage by using the Buffer Release request (DSPAPI
FUNC=RELBUF), specifying the returned output address.
RETCODE=symbol | (2 - 12)
Optional parameter that specifies a place in storage to receive the return
code. If specified as a symbol, the symbol must be the label of a word of
storage. If specified as a register, the register must contain the address of a
word of storage. If not specified, the return code is placed in register 15.
RSNCODE=symbol | (2 - 12)
Optional parameter that specifies a place in storage to receive the reason
code. If specified as a symbol, the symbol must be the label of a word of
storage. If specified as a register, the register must contain the address of a
word of storage. If not specified, the reason code is placed in register 0.
VERSION=1.0 | number
Optional parameter that specifies the version number of the parameter list
to be generated by this request.
To use the parameters associated with a version, you must specify the
number of that version or a later version. If you specify an earlier version
level, the parameter is not accepted for processing and an error message is
issued at assembly time. If parameters have a version dependency, the
parameter descriptions with each request type identify the version number
required.
The default version is 1.0.
| Table 24. Return and Reason Codes for TYPE=OLDS Query Requests (continued)
| Return Codes Reason Codes Meaning
| X'00000030' X'C9000001' Parameter error. The function (FUNC) specified in
| the parameter list passed to the API is invalid.
| X'00000030' X'C9000002' Invalid TOKEN field address. The address of the
| field containing the API TOKEN failed validity
| checking. The address specifies storage not owned
| by the calling program.
| X'00000030' X'C9000003' Invalid RETCODE field address. The address of
| the field to contain the API RETCODE failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000004' Invalid RSNCODE field address. The address of
| the field to contain the API RSNCODE failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000005' Invalid OUTPUT field address. The address of the
| field to contain the OUTPUT address failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000010' Invalid SSID field address. The address of the
| field containing the SSID failed validity checking.
| The address specifies storage not owned by the
| calling program.
| X'00000030' X'D8000001' Parameter error. Missing or invalid OUTPUT
| parameter.
|
|
| Figure 52. Format for QUERY TYPE=OLDS Output
|
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 48 DSPAPQOL
0 (0) UNSIGNED 4 APQOL_OLDSINFO
Offset to OLDS list
4 (4) SIGNED 4 *(3) Reserved
16 (10) CHARACTER 8 APQOL_SSID Subsystem ID
24 (18) UNSIGNED 2 APQOL_OLDSLEN Length of OLDS entry
26 (1A) SIGNED 2 APQOL_OLDSCOUNT
Number of OLDS entries
28 (1C) CHARACTER 12 APQOL_CHKPT0 Checkpoint 0 time
40 (28) CHARACTER 8 * Reserved
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 128 APQOL_OLDSENTRY
OLDS entry
0 (0) CHARACTER 8 APQOL_DDNAME the OLDS DD name
8 (8) CHARACTER 44 APQOL_DSNAM OLDS data set name
52 (34) CHARACTER 12 APQOL_OPENTIME
OLDS open time
64 (40) CHARACTER 12 APQOL_CLOSETIME
Close time
76 (4C) CHARACTER 12 APQOL_PRILOGTIME
Start time of associated
PRILOG
88 (58) CHARACTER 8 APQOL_FLSN LSN of first record in OLDS
96 (60) CHARACTER 8 APQOL_LLSN LSN of last record in OLDS
104 (68) BIT(8) 1 APQOL_FLAG1
1... .... APQOL_RSTBG Restart begin
.1.. .... APQOL_RSTEN Restart end
..1. .... APQOL_COLD Cold start
...1 .... APQOL_NOBMP ERE NOBMP
.... 1... APQOL_SAVER Backout UORs saved
.... .1.. APQOL_NOID Backouts not identified
.... ..1. APQOL_TRKNG OLDS created by tracking SS
105 (69) BIT(8) 1 APQOL_FLAG2 OLDS flags
1111 .... APQOL_STAT OLDS status
1... .... APQOL_INUSE OLDS is in use
.1.. .... APQOL_ARNED Archive needed
..1. .... APQOL_ARSCH Archive scheduled (GENJCL)
...1 .... APQOL_ARSTD Archive job started
.... 1... APQOL_CLERR Close error on OLDS
.... .1.. APQOL_FEOV Force EOV at archive
.... ..1. APQOL_DUMMY OLDS not used due to I/O err
.... ...1 APQOL_PRVCE Close error on previous OLDS
106 (6A) UNSIGNED 1 APQOL_RELVL Log release level
107 (6B) UNSIGNED 1 APQOL_GAVER GENJCL.ARCHIVE version
108 (6C) BIT(32) 4 APQOL_BLOCKSEQNO
Block sequence number
112 (70) CHARACTER 8 APQOL_ARJOB Name of the archive job
Generated by GENJCL.ARCHIVE
120 (78) CHARACTER 6 APQOL_LOCKSEQNO
Lock sequence number
126 (7E) CHARACTER 2 * Reserved
CONSTANTS
| MF=S
| OUTPUT=output
MF=(S,list) RETCODE=returncode
MF=(L,list)
,COMPLETE
MF=(M,list )
,NOCHECK
,COMPLETE
MF=(E,list )
,NOCHECK
VERSION=1.0
RSNCODE=reasoncode VERSION=number
|
| Table 25. Return and Reason Codes for TYPE=RECON Queries (continued)
| Return Codes Reason Codes Meaning
| X'00000030' X'C9000001' Invalid RSNCODE field address. The address of
| the field to contain the API RSNCODE failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000001' Invalid OUTPUT field address. The address of the
| field to contain the OUTPUT address failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'D8000001' Parameter error. Missing or invalid OUTPUT
| parameter.
|
|
| Figure 54. Format for QUERY TYPE=RECON Output
|
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 560 DSPAPQRC
0 (0) CHARACTER 44 APQRC_DATA Initialized with "RECOVERY
CONTROL DATASET"
44 (2C) UNSIGNED 4 APQRC_RECONINFO Offset to RECON data set
info
48 (30) SIGNED 4 *(2) Reserved
56 (38) UNSIGNED 2 APQAR_RECONINFOLEN Length of each RECON dataset info element
58 (3A) UNSIGNED 1 APQRC_RECONCOUNT # of RECON dataset elements
59 (3B) CHARACTER 1 * Reserved
60 (3C) BIT(8) 1 APQRC_FLAGS Process flags...
1... .... APQRC_NOCHK 1= NOCHECK log tape dsn check
.1.. .... APQRC_CHK17 1= CHECK17 log tape dsn check
..1. .... APQRC_CHK44 1= CHECK44 log tape dsn check
...1 .... APQRC_LSTLG 1= list log DSN
.... 1... APQRC_INUPG Upgrade in progress.
61 (3D) BIT(8) 1 APQRC_FLAG2 More flags...
1... .... APQRC_FORCE 1 = FORCER, 0 = NOFORCER
.1.. .... APQRC_CATDS 1=CA|IC|LOGS cataloged
..1. .... APQRC_TRACE 1 = ext. GTF trace on
...1 .... APQRC_CMDSAF SAF enabled
.... 1... APQRC_CMDEXIT Cmd auth exit enabled
62 (3E) CHARACTER 2 * Reserved
64 (40) CHARACTER 136 APQRC_CLEAN Fields needed for cleanup
64 (40) SIGNED 4 APQRC_CSET 0 = updates not in progress,
>0 = update in progress
68 (44) SIGNED 4 APQRC_TYPE Type of update
72 (48) CHARACTER 32 APQRC_OKEY Key of original record
104 (68) CHARACTER 32 APQRC_BKEY Key of base record that is in
the process of being changed
136 (88) CHARACTER 32 APQRC_NKEY Key of new record
168 (A8) CHARACTER 16 APQRC_DBID DBID of DBDS
168 (A8) CHARACTER 8 APQRC_DBD DBD name
176 (B0) CHARACTER 8 APQRC_DDN DD name
184 (B8) CHARACTER 8 APQRC_CAGRP CA group name
192 (C0) CHARACTER 8 APQRC_DDNEW New DBDS DD name
200 (C8) UNSIGNED 2 APQRC_DMBNO DMB sequence number
202 (CA) UNSIGNED 2 APQRC_LASTREUSEDDMB# Last reused DMB number, valid
only when apqrc_DMBNO is 32767
204 (CC) CHARACTER 7 APQRC_INITTOKEN Recon init. token
211 (D3) CHARACTER 8 APQRC_CMDHLQ Cmd auth high lvl qual
219 (DB) UNSIGNED 1 APQRC_MVERS Minimum IMS version
220 (DC) BIT(8) 1 APQRC_NWFLG Fields needed for RECON I/O
error(s)
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 53 APQRC_RECONDS_INFO
0 (0) CHARACTER 8 APQRC_RECONDS_DDNAME RECON DD name
8 (8) CHARACTER 44 APQRC_RECONDS_DSNAME RECON DS name
52 (34) BIT(8) 1 APQRC_RECONDS_STATUS RECON DS status
1... .... APQRC_RECONDS_COPY1 COPY 1
.1.. .... APQRC_RECONDS_COPY2 COPY 2
..1. .... APQRC_RECONDS_SPARE Spare
...1 .... APQRC_RECONDS_DISCARDED Discarded
.... 1... APQRC_RECONDS_UNAVAIL Unavailable
CONSTANTS
Subsystem Query
The Subsystem query (DSPAPI FUNC=QUERY TYPE=SUBSYS) request is used to
retrieve subsystem information from the RECON for a specific subsystem or all
subsystems.
| SSTYPE=ALL
TRACKER=NO
SSTYPE=ONLINE
SSTYPE=BATCH
SSID=*
TRACKER=YES
TRACKER=NO
SSID=subsystem_ID
TRACKER=YES
| MF=S
OUTPUT=output
MF=(S,list) RETCODE=returncode
MF=(L,list)
,COMPLETE
MF=(M,list )
,NOCHECK
,COMPLETE
MF=(E,list )
,NOCHECK
VERSION=1.0
RSNCODE=reasoncode VERSION=number
| Table 26. Return and Reason Codes for TYPE=SUBSYS Query Requests (continued)
| Return Codes Reason Codes Meaning
| Warning
| X'00000008' X'D8600001' No subsystem record of the requested type, active
| or tracker, exists.
| X'00000008' X'D8600002' No batch or online subsystem records exist.
| Severe Error
| X'0000000C' X'C9000001' Invalid TOKEN. The TOKEN block passed to the
| API is not recognized as a TOKEN created by a
| FUNC=STARTDBRC call.
| Storage Error
| X'00000028' X'D8600001' Error obtaining storage for SUBSYS block.
| X'00000028' X'D9100001' An error occurred processing the request. DBRC
| will release storage that was obtained up to this
| point. However, another error was encountered
| during the attempt to release storage.
| Internal Error
| X'0000002C' all DBRC internal error. Refer to “Database Recovery
| Control Service Aids” in the IMS Version 9:
| Diagnosis Guide and Reference for further
| information.
| Parameter Error
| X'00000030' X'C9000001' Parameter error. The function (FUNC) specified in
| the parameter list passed to the API is invalid.
| X'00000030' X'C9000002' Invalid TOKEN field address. The address of the
| field containing the API TOKEN failed validity
| checking. The address specifies storage not owned
| by the calling program.
| X'00000030' X'C9000003' Invalid RETCODE field address. The address of
| the field to contain the API RETCODE failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000004' Invalid RSNCODE field address. The address of
| the field to contain the API RSNCODE failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000005' Invalid OUTPUT field address. The address of the
| field to contain the OUTPUT address failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000010' Invalid SSID field address. The address of the
| field containing the SSID failed validity checking.
| The address specifies storage not owned by the
| calling program.
| X'00000030' X'D8000001' Parameter error. Missing or invalid OUTPUT
| parameter.
| X'00000030' X'D8600001' Parameter error. SSTYPE=ONLINE or BATCH can
| not be specified on requests for a specific SSID or
| for a tracking subsystem request
| (TRACKER=YES).
|
|
| Figure 56. Format for QUERY TYPE=SUBSYS Output
|
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 64 DSPAPQSS
0 (0) CHARACTER 8 APQSS_SSID Subsystem identifier
8 (8) UNSIGNED 4 APQSS_AUTHLIST Offset to authd DB/Area list
12 (C) SIGNED 4 APQSS_AUTHCOUNT Number of authorized DB/Areas
16 (10) UNSIGNED 2 APQSS_AUTHLEN Length of auth entry
18 (12) CHARACTER 6 * Reserved
24 (18) CHARACTER 12 APQSS_LOGTIME Start time of log
36 (24) UNSIGNED 1 APQSS_RELLVL Subsystem release level
'71'X=V7R1,'81'X=V8R1
'91'X=V9R1, etc.
37 (25) CHARACTER 1 APQSS_COEXLVL Coexistence level
38 (26) UNSIGNED 1 APQSS_IRLMCT IRLM status count
39 (27) CHARACTER 1 * Reserved
40 (28) CHARACTER 8 APQSS_GSGNAME Global Service Group name
48 (30) CHARACTER 5 APQSS_IRLMID IRLM ID of SS
53 (35) CHARACTER 5 APQSS_IRLMBK IRLM ID of backup SS
58 (3A) BIT(8) 1 APQSS_FLAGS Flags
1... .... APQSS_TYPE 1=Online | 0=batch
.1.. .... APQSS_ABTERM Abnormal termination
..1. .... APQSS_RCVPRC Recovery processing started
...1 .... APQSS_BKSIGN Backup SS signed on
.... 1... APQSS_IRLMFL IRLM failure
.... .1.. APQSS_COMMFL COMM failure
.... ..1. APQSS_SYSFL SYS failure
.... ...1 APQSS_ACTVST Status of active SS when backup exists, 1=abterm
59 (3B) BIT(8) 1 APQSS_FLAGS2 FLAGS 2
1... .... APQSS_SHRING Sharing covered DBs
.1.. .... APQSS_TRKER Subsystem is a Tracker
..1. .... APQSS_TRKTRM TRACKER has terminated
...1 .... APQSS_TRCKED SSID is tracked
.... 1... APQSS_FRSTSO 1ST signon after RSR takeover is in progress
.... .1.. APQSS_XRFCAP SS is XRF capable
.... ..11 * Reserved
60 (3C) SIGNED 2 APQSS_BCKTKN Backup recovery token
62 (3E) CHARACTER 2 * Reserved
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 32 APQSS_AUTHNAME Names of authd DB/Areas
0 (0) CHARACTER 8 APQSS_DBNAME DB name
8 (8) CHARACTER 8 APQSS_AREANM If FP, Area name
16 (10) UNSIGNED 1 APQSS_SHRLVL Share level
17 (11) UNSIGNED 1 APQSS_DBACCS Access intent
18 (12) UNSIGNED 1 APQSS_DBNCOD Encoded state
19 (13) UNSIGNED 1 APQSS_DBSTAT DB status flags
20 (14) UNSIGNED 2 APQSS_DBEQCT DB EQE count
22 (16) SIGNED 2 APQSS_GLBDMB Global DMB number
24 (18) BIT(8) 1 APQSS_AUTHFLAGS Flags
1... .... APQSS_NRDBUP Nonrecov DB/Area updated
.1.. .... APQSS_COVRD DB covered by GSG
..1. .... APQSS_NRECV Non-recoverable DB/Area
...1 .... APQSS_ORDBDS 0=A-J/1=M-V ACTIVE
.... 1... APQSS_OLRON 0 = no OLR active
.... .1.. APQSS_OLROWR 0 = no OLR owner
.... ..1. APQSS_OLROWD 0 OLR not owned by SS
25 (19) CHARACTER 7 * Reserved
CONSTANTS
| In This Chapter:
| v “RELBUF Request”
|
| RELBUF Request
| “RELBUF Usage” contains the details for the release buffer request.
| RELBUF Usage
| Syntax for the RELBUF Request
| DSPAPI FUNC=RELBUF TOKEN=address BUFFER=buffer
| name
| MF=S
|
MF=(S,list) RETCODE=returncode
MF=(L,list)
,COMPLETE
MF=(M,list )
,NOCHECK
,COMPLETE
MF=(E,list )
,NOCHECK
| VERSION=1.0
|
RSNCODE=reasoncode VERSION=number
|
| In This Chapter:
| v “STARTDBRC Request”
|
| STARTDBRC Request
| “STARTDBRC Usage” contains the details for the DBRC start request.
| STARTDBRC Usage
| Syntax for the STARTDBRC Request
| DSPAPI FUNC=STARTDBRC
| name SYSPRINT=ddname
| MF=S
|
MF=(S,list) RETCODE=returncode
MF=(L,list)
,COMPLETE
MF=(M,list )
,NOCHECK
,COMPLETE
MF=(E,list )
,NOCHECK
| VERSION=1.0
|
RSNCODE=reasoncode VERSION=number
|
| RSNCODE=symbol | (2 - 12)
| Optional parameter that specifies a place in storage to receive the reason
| code. If specified as a symbol, the symbol must be the label of a word of
| storage. If specified as a register, the register must contain the address of a
| word of storage. If not specified, the reason code is placed in register 0.
| MF=S | L | M | E
| Optional parameter that specifies the macro form of the request. See
| “Macro Forms of the DSPAPI Macro” on page 356 for the details of the
| parameter values.
| VERSION=1.0 | number
| Optional parameter that specifies the version number of the parameter list
| to be generated by this request.
| To use the parameters associated with a version, you must specify the
| number of that version or a later version. If you specify an earlier version
| level, the parameter is not accepted for processing and an error message is
| issued at assembly time. If parameters have a version dependency, the
| parameter descriptions with each request type identify the version number
| required.
| The default version is 1.0.
| Table 28. Return and Reason Codes for the STARTDBRC Request (continued)
| Return Codes Reason Codes Meaning
| X'00000030' X'C9000004' Invalid RSNCODE field address. The address of
| the field to contain the API RSNCODE failed
| validity checking. The address specifies storage
| not owned by the calling program.
| X'00000030' X'C9000006' Invalid SYSPRINT field address. The address of
| the field containing the SYSPRINT DD name
| failed validity checking. The address specifies
| storage not owned by the calling program.
|
In This Chapter:
v “STOPDBRC Request”
STOPDBRC Request
“STOPDBRC Usage” contains the details for the release buffer request.
STOPDBRC Usage
Syntax for the STOPDBRC Request
DSPAPI FUNC=STOPDBRC TOKEN=address
name
| MF=S
MF=(S,list) RETCODE=returncode
MF=(L,list)
,COMPLETE
MF=(M,list )
,NOCHECK
,COMPLETE
MF=(E,list )
,NOCHECK
VERSION=1.0
RSNCODE=reasoncode VERSION=number
MF=S | L | M | E
Optional parameter that specifies the macro form of the request. See
“Macro Forms of the DSPAPI Macro” on page 356 for the details of the
parameter values.
VERSION=1.0 | number
Optional parameter that specifies the version number of the parameter list
to be generated by this request.
To use the parameters associated with a version, you must specify the
number of that version or a later version. If you specify an earlier version
level, the parameter is not accepted for processing and an error message is
issued at assembly time. If parameters have a version dependency, the
parameter descriptions with each request type identify the version number
required.
The default version is 1.0.
Table 31 on page 436 through Table 36 on page 442 show the keywords that each
individual utility recognizes.
These tables and the figures in “IBM-Supplied Skeletal JCL Execution Members” on
page 443 are presented in alphabetical order of the GENJCL commands:
v GENJCL.ARCHIVE, which generates JCL for the Log Archive utility. See “Log
Archive Utility (ARCHJCL)” on page 436 for a list of the symbolic keywords
supported by the utility and see “GENJCL.ARCHIVE” on page 221 for details
using the command.
v GENJCL.CA, which generates JCL for the Database Change Accumulation utility.
See “Database Change Accumulation Utility (CAJCL)” on page 437 for a list of
the symbolic keywords supported by the utility and see “GENJCL.CA” on page
225 for details of the command usage.
v GENJCL.CLOSE, which generates JCL for the Log Recovery utility. See “Log
Recovery Utility (LOGCLJCL)” on page 438 for a list of the symbolic keywords
supported by the utility and see “GENJCL.CLOSE” on page 229 for details of
the command usage.
v GENJCL.IC and GENJCL.OIC, which generates JCL for the Database Image Copy
utilities. See “Database Image Copy Utility, Database Image Copy Utility 2, and
Online Database Image Copy Utility (ICJCL and OICJCL)” on page 438 for a list
of the symbolic keywords supported by the utilities and see “GENJCL.IC” on
page 233 and “GENJCL.OIC” on page 242 for details of the commands usage.
v GENJCL.RECEIVE, which generates JCL for the Database Recovery utility. See
“Database Recovery Utility- Receive (ICRCVJCL)” on page 440 for a list of the
symbolic keywords supported by the utility and see “GENJCL.RECEIVE” on
page 247 for details of the command usage.)
v GENJCL.RECOV, which also generates JCL for the Database Recovery utility. See
“Database Recovery Utility-Recovery (RECOVJCL)” on page 442 for a list of the
symbolic keywords supported by the utility and see “GENJCL.RECOV” on page
251 for details of the command usage.)
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.
where cagrpname is the CA group name, and hhmmss is the current time of day.
%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.
Table 32. Symbolic Keywords for Database Change Accumulation Utility (continued)
Keyword Description
%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.
Note: %CADB0 always generates DB0 control statements with the time stamps in UTC format
(indicated by an offset of zeroes).
Table 34. Symbolic Keywords for Database Image Copy Utilities (continued)
Keyword Description
%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.
%ICDDN1, The DD name of the first image copy data set. If multiple image copy data sets are produced,
%ICDDN2, %ICDDN2, %ICDDN3, and %ICDDN4 are similarly set.
%ICDDN3,
%ICDDN4
%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.
%ICDSN1, The data set name of the image copy data set is %ICDSN1.
%ICDSN2,
%ICDSN3, If NOREUSE is specified for the DBDS, DBRC generates the following data set name:
%ICDSN4 IMS.dbname.ddname.IC.IChhmmss
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 Sameds is specified for a group of DBDSs, DBRC generates the following data set name:
IMSVS.GROUP.grpname.IC.IChhmmss
where :
v grpname is the name specified in the GROUP or DBD parameter
v hhmmss is the current time of day
If multiple image copy data sets are to be produced, %ICDSN3, or %ICDSN4 are set similarly.
Table 34. Symbolic Keywords for Database Image Copy Utilities (continued)
Keyword Description
%ICUNIT1, The unit type of the image copy data set. If NOREUSE is specified for the DBDS, %ICUNIT1 is set from
%ICUNIT2, the UNIT parameter on the command. If multiple image copy data sets are to be produced, %ICUNIT2,
%ICUNIT3, %ICUNIT3, or %ICUNIT4 are set similarly.
%ICUNIT4
%ICFSEQ1, The file sequence number of the image copy data set. If NOREUSE is specified for the DBDS, %ICFSEQ1 is
%ICFSEQ2, set to 1. If multiple image copy data sets are to be produced, %ICFSEQ2, %ICFSEQ3, or %ICFSEQ4 are
%ICFSEQ3, set similarly.
%ICFSEQ4
%ICVOLS1, The volume serial number of the image copy data set. If NOREUSE is specified for the DBDS, %ICVOLS1
%ICVOLS2, is set from the VOLLIST parameter on the command. If multiple image copy data sets are to be
%ICVOLS3, produced, %ICVOLS2, %ICVOLS3, or %ICVOLS4 are set similarly.
%ICVOLS4
%ICVCNT1, The number of volumes of the image copy data set. If NOREUSE is specified for the DBDS, %ICVCNT1 is
%ICVCNT2, set to the number of volumes specified on the VOLLIST parameter on the command. If multiple image
%ICVCNT3, copy data sets are to be produced, %ICVCNT2, %ICVCNT3, or %ICVCNT4 is set similarly.
%ICVCNT4
%SMSGRP A numeric value indicating the status of group processing:
Column Setting
0 One job step is being generated for each DBDS and/or area.
Otherwise a single job is being generated to copy multiple DBDSs and/or areas
(Image Copy 2, GROUP or DB without DDN, and ONEJOB were specified). This
means that the skeletal JCL member will be processed more than once per job step
generated.
1 Processing the only member of the group
2 Processing the first of multiple members
3 Processing an intermediate member
4 Processing the last member
%SMS1DS A numeric value indicating whether Sameds was specified:
Column Setting
0 Sameds was not specified
1 Sameds was specified
%GROUP A character value containing the value of the GROUP parameter, or the value of the DBD parameter
if DDn was omitted (an implied group)--otherwise null.
Table 35. Symbolic Keywords for Database Recovery (Receive) Utility (continued)
Keyword Description
%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.
%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.
%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.
Table 35. Symbolic Keywords for Database Recovery (Receive) Utility (continued)
Keyword Description
%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.
Table 36. Symbolic Keywords for Database Recovery Utility - Recovery (RECOVJCL) (continued)
Keyword Description
%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.
Related Reading: Instructions on what you must do before using the skeletal JCL
execution members are in “Using IBM-Supplied Skeletal JCL” on page 84.
| 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) that the JCL was generated.
Figure 58. IBM-Supplied Skeletal JCL for the Log Archive Utility (Part 1 of 3)
Figure 58. IBM-Supplied Skeletal JCL for the Log Archive Utility (Part 2 of 3)
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 58. 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.
Restrictions:
v The %ARVERS keyword is not supported for the SLDS archive process and must
not be used.
| v Do not use the FREE=CLOSE JCL parameter on the DFSSLOGP DD statement.
| The data set is dynamically deallocated and using FREE=CLOSE will produce
| unpredictable results.
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.
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.
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.
Figure 59. 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
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
%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.
For a detailed description of the DB0 control statement, see “DB0 Statement”
under “Database Change Accumulation Utility (DFSUCUM0)” in the IMS
Version 9: Utilities Reference: Database and Transaction Manager.
Figure 60. 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.
ICJCL is used when the GENJCL.IC command is issued. The ICJCL may be
processed more than once for each job step in the output JCL. You can specify an
execution member other than ICJCL by using the ICJCL parameter on the
INIT.DBDS or CHANGE.DBDS commands.
First part (from the EXEC statement through the IMS DD statement)
Contained in delete groups controlled by keyword %SMSGRP so that they
are processed only once per job.
Second part (from the %DBADDN DD statement through the %ICDDN4 DD
statement)
Processed once for each DBDS or area to be copied in a job step. The
second set of %ICDDNn DD statements are deleted if Sameds was
specified on the GENJCL command.
Third part (SYSIN DD statement and the %ICSYSIN statement)
Contained in a delete group controlled by keyword %SMSGRP so that they
are processed only for the last (or only) DBDS or area to be copied in a job
step.
Figure 61. IBM-Supplied Skeletal JCL for the Database Image Copy Utility and the Database
Image Copy 2 Utility (Part 1 of 3)
//*-----------------------------------------------------------------
//*-----| Single output data set if SMS and ONEDS
//*-----------------------------------------------------------------
%ENDDEL
%DELETE (%SMSGRP GT '2' | %SMS1DS NE '1')
//%ICDDN1 DD DSN=%ICDSN1,UNIT=%ICUNIT1,
// VOL=(PRIVATE,,,%ICVCNT1,SER=(%ICVOLS1)),
// LABEL=(%ICFSEQ1,SL),
// DISP=(NEW,KEEP)
%ENDDEL
%DELETE (%COPIES LT '2' | %SMSGRP GT '2' | %SMS1DS NE '1')
//%ICDDN2 DD DSN=%ICDSN2,UNIT=%ICUNIT2,
// VOL=(PRIVATE,,,%ICVCNT2,SER=(%ICVOLS2)),
// LABEL=(%ICFSEQ2,SL),
// DISP=(NEW,KEEP)
%ENDDEL
%DELETE (%COPIES LT '3' |%SMSGRP GT '2' | %SMS1DS NE '1')
//%ICDDN3 DD DSN=%ICDSN3,UNIT=%ICUNIT3,
// VOL=(PRIVATE,,,%ICVCNT3,SER=(%ICVOLS3)),
// LABEL=(%ICFSEQ3,SL),
// DISP=(NEW,KEEP)
%ENDDEL
%DELETE (%COPIES LT '4' |%SMSGRP GT '2' | %SMS1DS NE '1')
//%ICDDN4 DD DSN=%ICDSN4,UNIT=%ICUNIT4,
// VOL=(PRIVATE,,,%ICVCNT4,SER=(%ICVOLS4)),
// LABEL=(%ICFSEQ4,SL),
// DISP=(NEW,KEEP)
%ENDDEL
%DELETE (%SMSGRP NE '')
//*-----------------------------------------------------------------
//*-----| Section 2 is used once per DBDS (any value of %SMSGRP)
//*-----------------------------------------------------------------
%ENDDEL
%SELECT DBDS((%DBNAME,%DBDDN))
%DELETE (%DBADSAV NE 'AVAIL')
//%DBADDN DD DSN=%DBDSN,DISP=%CICDISP
%ENDDEL
%DELETE (%DBADSAV NE '' | %MDBNAME NE'')
//%DBDDN DD DSN=%DBDSN,DISP=%CICDISP
%ENDDEL
%ENDSEL
%DELETE (%SMSGRP NE '')
//*-----------------------------------------------------------------
//*-----| Output data sets not included if SMS + Group + ONEDS
//*-----------------------------------------------------------------
%ENDDEL
%DELETE (%SMS1DS EQ '1')
//%ICDDN1 DD DSN=%ICDSN1,UNIT=%ICUNIT1,
// VOL=(PRIVATE,,,%ICVCNT1,SER=(%ICVOLS1)),
// LABEL=(%ICFSEQ1,SL),
%ENDDEL
%DELETE (%SMS EQ '1' | %SMS1DS EQ '1')
// DISP=(NEW,KEEP),DCB=BUFNO=10
%ENDDEL
%DELETE (%SMS NE '1' | %SMS1DS EQ '1')
// DISP=(NEW,KEEP)
%ENDDEL
Figure 61. IBM-Supplied Skeletal JCL for the Database Image Copy Utility and the Database
Image Copy 2 Utility (Part 2 of 3)
Figure 61. IBM-Supplied Skeletal JCL for the Database Image Copy Utility and the Database
Image Copy 2 Utility (Part 3 of 3)
v This member may be processed more than once for each job step in the output
JCL.
v All statements in the first part of the JCL, from the EXEC statement through the
IMS DD statement, are in delete groups controlled by keyword %SMSGRP so
that they are processed only once per job step.
v The first set of %ICDDn DD statements identify the single output data set for a
group of image copies. It is in a delete group controlled by the %SMS1DS
keyword so that it is output only when Sameds was specified in the GENJCL
command.
v The second part of the JCL, from the %DBADDN DD statement through the
%ICDDN4 DD statement, is processed once for each DBDS or area to be copied
in a job step. The %ICDDNn DD statements are deleted if Sameds was specified
on the GENJCL command.
v The third part of the JCL, the SYSIN DD statement and the %ICSYSIN
statement, are in a delete group controlled by keyword %SMSGRP so that they
are processed only for the last (or only) DBDS or area to be copied in a job step.
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.
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.
%ICDDN1 DD Statement
These statements identify 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
%ICDDN2 | 3 | 4 DD Statement
These statements identify 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.
Figure 62. 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
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.
Figure 63. IBM-Supplied Skeletal JCL for the Database Recovery Utility - Tracking Site
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.
RECONn DD Statements
The RECON DD statements identify the RECONs.
Figure 64. IBM-Supplied Skeletal JCL for the Database Recovery Utility (Part 1 of 2)
Figure 64. IBM-Supplied Skeletal JCL for the Database Recovery 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. 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.
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.
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
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
The Database Recovery utility and the image copy utilities cannot be used on ILDS
and prime index data sets. The GENJCL.RECOV, GENJCL.RECEIVE, GENJCL.IC, and
GENJCL.OIC commands fail when attempted specifically for ILDS and prime index
data sets. 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 data sets. These data sets are ignored. GENJCL.USER can
specify ILDS and prime index data sets. The ILDS and prime index data sets are
not ignored for this command.
After a time-stamp recovery of a HALDB partition (the data DBDSs of the HALDB
partition), the applicable ILDS or prime index data sets (or both) must be rebuilt.
There is no specific GENJCL support for these data sets, but the GENJCL.USER
command 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')
Figure 65. 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.
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 9: 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 9: Utilities Reference: Database and Transaction Manager.
In This Appendix:
v “Sample Listing of LIST.HISTORY Output” on page 474
v “Sample Listing of a RECON at the Active Site” on page 479
v “Sample Listing of a RECON at the Tracking Site” on page 508
v “Fields Present in a Listing of a RECON by Record Type” on page 532
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:
Member Name
RECON Record DSECTS
DSPALLRC ALLOC record
DSPBKORC BACKOUT record
DSPCAGRC CAGRP record
DSPCHGRC CA record
DSPDBHRC DB record
DSPDGRC DBDSGRP record
DSPDSHRC DBDS record
DSPGSGRC Global Service Group record
© Copyright IBM Corp. 1974, 2007 473
Sample RECON Listing Active Site
DSPIMGRC IC record
DSPLGARC LOGALL record
| DSPLOGRC PRILOG / SECLOG/PRISLD / SECSLD / PRITSLDS / SECTSLDS
| record
DSPOLDRC PRIOLD / SECOLD record
DSPPTNRC HALDB Partition record
DSPRCNRC HEADER record
DSPRCR1 HEADEREXT record
DSPRCVRC RECOV record
DSPRRGRC REORG record
| DSPRDTRC RECON DMB Table record
DSPSSRC SUBSYS record
DSN=IMSVS.RLDSP.IMS1.D04194.T1249237.V00 UNIT=SYSDA
START = 04.194 12:49:23.7 FIRST DS LSN= 0000000000000001
STOP = 04.194 12:50:20.0 LAST DS LSN= 0000000000000535
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.IMS1.D04194.T1250200.V00 UNIT=SYSDA
START = 04.194 12:50:20.0 FIRST DS LSN= 0000000000000536
STOP = 04.194 12:51:31.0 LAST DS LSN= 0000000000000BDD
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.IMS1.D04194.T1251310.V00 UNIT=SYSDA
START = 04.194 12:51:31.0 FIRST DS LSN= 0000000000000BDE
STOP = 04.194 12:52:27.6 LAST DS LSN= 0000000000000D11
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.IMS1.D04194.T1252276.V00 UNIT=SYSDA
START = 04.194 12:52:27.6 FIRST DS LSN= 0000000000000D12
STOP = 04.194 12:53:53.6 LAST DS LSN= 0000000000000EC6
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.IMS1.D04194.T1252276.V01 UNIT=SYSDA
START = 04.194 12:53:53.6 FIRST DS LSN= 0000000000000EC7
STOP = 04.194 12:53:54.0 LAST DS LSN= 0000000000000F3E
FILE SEQ=0001 #VOLUMES=0001
DSN=PRILOG1.DSN1 UNIT=3400
START = 01.111 12:00:00.0 FIRST DS LSN= 0000000000000001
STOP = 01.111 13:00:00.0 LAST DS LSN= 0000000000000100
FILE SEQ=0001 #VOLUMES=0001
DSN=PRILOG1.DSN2 UNIT=3400
START = 01.111 13:00:00.0 FIRST DS LSN= 0000000000000101
STOP = 01.111 14:00:00.0 LAST DS LSN= 0000000000000200
FILE SEQ=0001 #VOLUMES=0001
DSN=PRILOG2.DSN1 UNIT=3400
START = 01.112 12:00:00.0 FIRST DS LSN= 0000000000000201
STOP = 01.112 13:00:00.0 LAST DS LSN= 0000000000000300
FILE SEQ=0001 #VOLUMES=0001
DSN=PRILOG2.DSN2 UNIT=3400
START = 01.112 13:00:00.0 FIRST DS LSN= 0000000000000301
STOP = 01.112 14:00:00.0 LAST DS LSN= 0000000000000400
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.IMS2.D04194.T1249343.V00 UNIT=SYSDA
START = 04.194 12:49:34.3 FIRST DS LSN= 0000000000000001
STOP = 04.194 12:50:19.7 LAST DS LSN= 000000000000010C
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.IMS2.D04194.T1250197.V00 UNIT=SYSDA
START = 04.194 12:50:19.7 FIRST DS LSN= 000000000000010D
STOP = 04.194 12:51:30.5 LAST DS LSN= 000000000000025E
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.IMS2.D04194.T1251305.V00 UNIT=SYSDA
START = 04.194 12:51:30.5 FIRST DS LSN= 000000000000025F
STOP = 04.194 12:52:28.2 LAST DS LSN= 0000000000000551
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.IMS2.D04194.T1252282.V00 UNIT=SYSDA
START = 04.194 12:52:28.2 FIRST DS LSN= 0000000000000552
STOP = 04.194 12:54:27.5 LAST DS LSN= 0000000000000AA7
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.IMS2.D04194.T1252282.V01 UNIT=SYSDA
START = 04.194 12:54:27.5 FIRST DS LSN= 0000000000000AA8
STOP = 04.194 12:54:28.1 LAST DS LSN= 0000000000000B58
FILE SEQ=0001 #VOLUMES=0001
Related Reading: See “LIST.HISTORY” on page 298 for more information about
the LIST.HISTORY command.
In This Section:
v “RECON Status Record” on page 480
v “Log Records” on page 481
v “GSG Record” on page 490
v “SSYS Record” on page 491
v “BACKOUT Record” on page 491
v “CAGRP and CA Records” on page 492
v “DBGRP, DBDSGRP, and RECOVGRP Records” on page 493
v “DB (IMS) and Related Records” on page 494
Figure 67. Sample Listing of a RECON at the Active Site - RECON Status
Log Records
| LIST.LOG
| 04.197 11:04:43.8 LISTING OF RECON PAGE 0002
| -------------------------------------------------------------------------------
| PRILOG RECORD SIZE= 464
| START = 04.196 09:21:02.7 * SSID=SYS3 VERSION=9.1
| STOP = 04.196 09:28:46.7 #DSN=2
| GSGNAME=IMSGSG1
| FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 1
| EARLIEST CHECKPOINT = 04.196 09:21:04.5
|
| DSN=IMSVS.RLDSP.SYS3.D04196.T0921027.V00 UNIT=SYSDA
| START = 04.196 09:21:02.7 FIRST DS LSN= 0000000000000001
| STOP = 04.196 09:24:54.6 LAST DS LSN= 000000000000044C
| FILE SEQ=0001 #VOLUMES=0001
|
| VOLSER=000000 STOPTIME = 04.196 09:24:54.6
| CKPTCT=1 CHKPT ID = 04.196 09:21:04.5
| LOCK SEQUENCE#= 000000000000
|
| DSN=IMSVS.RLDSP.SYS3.D04196.T0924546.V00 UNIT=SYSDA
| START = 04.196 09:24:54.6 FIRST DS LSN= 000000000000044D
| STOP = 04.196 09:28:46.7 LAST DS LSN= 0000000000000689
| FILE SEQ=0001 #VOLUMES=0001
|
| VOLSER=000000 STOPTIME = 04.196 09:28:46.7
| CKPTCT=2 CHKPT ID = 04.196 09:28:46.3
| LOCK SEQUENCE#= 000000000000
|
| LOGALL
| START = 04.196 09:21:02.7 *
| EARLIEST ALLOC TIME = 04.196 09:22:45.2
| DBDS ALLOC=11 -DBD- -DDN- -ALLOC-
| DEDBJN21 DB21AR1 1
| DEDBJN21 DB21AR2 1
| DEDBJN21 DB21AR3 1
| DEDBJN21 DB21AR4 1
| DEDBJN21 DB21AR5 1
| DEDBJN21 DB21AR6 1
| DEDBJN21 DB21AR7 1
| DEDBJN21 DB21AR8 1
| DEDBJN21 DB21AR9 1
| DEDBJN21 DB21AR10 1
| DEDBJN21 DB21AR11 1
|
| Figure 68. Sample Listing of a RECON at the Active Site - Log Records (Part 1 of 10)
|
DSN=IMSVS.SLDSP.SYS3.D04196.T0921027.V00 UNIT=SYSDA
START = 04.196 09:21:02.7 FIRST DS LSN= 0000000000000001
STOP = 04.196 09:24:54.6 LAST DS LSN= 000000000000044C
FILE SEQ=0001 #VOLUMES=0001
CHECKPOINT TYPES=80: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=N
DSN=IMSVS.SLDSP.SYS3.D04196.T0924546.V00 UNIT=SYSDA
START = 04.196 09:24:54.6 FIRST DS LSN= 000000000000044D
STOP = 04.196 09:28:46.7 LAST DS LSN= 0000000000000689
FILE SEQ=0001 #VOLUMES=0001
CHECKPOINT TYPES=88: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=Y
Figure 68. Sample Listing of a RECON at the Active Site - Log Records (Part 2 of 10)
DSN=IMSVS.RLDSP.SYS3.D04196.T0930286.V01 UNIT=SYSDA
START = 04.196 09:30:28.6 FIRST DS LSN= 000000000000030B
STOP = 04.196 09:31:00.8 LAST DS LSN= 00000000000004D9
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.SYS3.D04196.T0931008.V00 UNIT=SYSDA
START = 04.196 09:31:00.8 FIRST DS LSN= 00000000000004DA
STOP = 04.196 09:31:21.2 LAST DS LSN= 00000000000005F7
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.SYS3.D04196.T0931212.V01 UNIT=SYSDA
START = 04.196 09:31:21.2 FIRST DS LSN= 00000000000005F8
STOP = 04.196 09:47:18.5 LAST DS LSN= 0000000000000828
FILE SEQ=0001 #VOLUMES=0001
LOGALL
START = 04.196 09:29:46.6 *
EARLIEST ALLOC TIME = 04.196 09:30:57.0
DBDS ALLOC=1 -DBD- -DDN- -ALLOC-
DBVHDJ05 CJVHDG1E 1
Figure 68. Sample Listing of a RECON at the Active Site - Log Records (Part 3 of 10)
DSN=IMSVS.SLDSP.SYS3.D04196.T0930286.V01 UNIT=SYSDA
START = 04.196 09:30:28.6 FIRST DS LSN= 000000000000030B
STOP = 04.196 09:31:00.8 LAST DS LSN= 00000000000004D9
FILE SEQ=0001 #VOLUMES=0001
CHECKPOINT TYPES=80: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=N
DSN=IMSVS.SLDSP.SYS3.D04196.T0931008.V00 UNIT=SYSDA
START = 04.196 09:31:00.8 FIRST DS LSN= 00000000000004DA
STOP = 04.196 09:31:21.2 LAST DS LSN= 00000000000005F7
FILE SEQ=0001 #VOLUMES=0001
CHECKPOINT TYPES=40: SIMPLE=N SNAPQ=Y DUMPQ=N PURGE=N FREEZE=N
DSN=IMSVS.SLDSP.SYS3.D04196.T0931212.V01 UNIT=SYSDA
START = 04.196 09:31:21.2 FIRST DS LSN= 00000000000005F8
STOP = 04.196 09:47:18.5 LAST DS LSN= 0000000000000828
FILE SEQ=0001 #VOLUMES=0001
CHECKPOINT TYPES=88: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=Y
Figure 68. Sample Listing of a RECON at the Active Site - Log Records (Part 4 of 10)
DSN=BATCH1.UPDATEF.LOG UNIT=SYSDA
START = 04.196 09:47:38.3 FIRST DS LSN= 0000000000000001
STOP = 04.196 09:47:39.5 LAST DS LSN= 000000000000009C
FILE SEQ=0001 #VOLUMES=0001
LOGALL
START = 04.196 09:47:38.3 *
EARLIEST ALLOC TIME = 04.196 09:47:39.0
DBDS ALLOC=3 -DBD- -DDN- -ALLOC-
DHVNTZ02 HIDAM 1
DXVNTZ02 XDLBT04I 1
DIVNTZ02 DBHVSAM1 1
04.197 11:04:43.8 LISTING OF RECON PAGE 0007
-------------------------------------------------------------------------------
SECLOG RECORD SIZE= 304
START = 04.196 09:47:38.3 * SSID=BATCH1 VERSION=9.1
STOP = 04.196 09:47:39.5 #DSN=1
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 3
DSN=IMSTESTL.IMS01.OLDSP1 UNIT=SYSDA
START = 04.196 09:47:38.3 FIRST DS LSN= 0000000000000001
STOP = 04.196 09:47:39.5 LAST DS LSN= 000000000000009C
FILE SEQ=0001 #VOLUMES=0001
Figure 68. Sample Listing of a RECON at the Active Site - Log Records (Part 5 of 10)
DSN=IMSTESTM.BAT01.DBLOG1 UNIT=SYSDA
START = 04.196 09:47:50.4 FIRST DS LSN= 0000000000000001
STOP = 04.196 09:47:57.6 LAST DS LSN= 00000000000000E4
FILE SEQ=0001 #VOLUMES=0001
LOGALL
START = 04.196 09:47:50.4 *
EARLIEST ALLOC TIME = 04.196 09:47:51.0
DBDS ALLOC=1 -DBD- -DDN- -ALLOC-
DBOVLFPC VLOSAM01 1
04.197 11:04:43.8 LISTING OF RECON PAGE 0009
-------------------------------------------------------------------------------
PRILOG RECORD SIZE= 304
START = 04.196 09:48:07.6 * SSID=BATFPC VERSION=9.1
STOP = 04.196 09:48:08.4 #DSN=1
GSGNAME=**NULL** BBO
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 0
DSN=IMSTESTM.BBOFPC.BB1 UNIT=SYSDA
START = 04.196 09:48:07.6 FIRST DS LSN= 0000000000000001
STOP = 04.196 09:48:08.4 LAST DS LSN= 000000000000002F
FILE SEQ=0001 #VOLUMES=0001
LOGALL
START = 04.196 09:48:07.6 *
EARLIEST ALLOC TIME = 04.196 09:48:08.2
DBDS ALLOC=1 -DBD- -DDN- -ALLOC-
DBOVLFPC VLOSAM01 1
Figure 68. Sample Listing of a RECON at the Active Site - Log Records (Part 6 of 10)
DSN=IMSVS.RLDSP.SYS3.D04196.T0948498.V02 UNIT=SYSDA
START = 04.196 09:48:49.8 FIRST DS LSN= 0000000000000001
STOP = 04.196 08:51:28.4 LAST DS LSN= 00000000000002B9
FILE SEQ=0001 #VOLUMES=0001
LOGALL
START = 04.196 09:48:49.8 *
EARLIEST ALLOC TIME = 04.196 09:48:51.8
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
04.197 11:04:43.8 LISTING OF RECON PAGE 0011
-------------------------------------------------------------------------------
PRISLD RECORD SIZE= 304
START = 04.196 09:48:49.8 * SSID=SYS3 VERSION=9.1
STOP = 04.196 08:51:28.4 #DSN=1
GSGNAME=IMSGSG1
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 4
DSN=IMSVS.SLDSP.SYS3.D04196.T0948498.V02 UNIT=SYSDA
START = 04.196 09:48:49.8 FIRST DS LSN= 0000000000000001
STOP = 04.196 08:51:28.4 LAST DS LSN= 00000000000002B9
FILE SEQ=0001 #VOLUMES=0001
CHECKPOINT TYPES=80: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=N
Figure 68. Sample Listing of a RECON at the Active Site - Log Records (Part 7 of 10)
DSN=IMSVS.RLDSP.SYS3.D04196.T0851285.V01 UNIT=SYSDA
START = 04.196 08:51:28.5 FIRST DS LSN= 00000000000002BA
STOP = 04.196 08:53:43.2 LAST DS LSN= 0000000000000444
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.RLDSP.SYS3.D04196.T0853432.V02 UNIT=SYSDA
START = 04.196 08:53:43.2 FIRST DS LSN= 0000000000000445
STOP = 04.196 08:56:33.9 LAST DS LSN= 00000000000006F3
FILE SEQ=0001 #VOLUMES=0001
LOGALL
START = 04.196 08:51:28.5 *
EARLIEST ALLOC TIME = 04.196 08:51:31.6
DBDS ALLOC=1 -DBD- -DDN- -ALLOC-
DEDBDD01 DD01AR0 1
DSN=IMSVS.SLDSP.SYS3.D04196.T0851285.V01 UNIT=SYSDA
START = 04.196 08:51:28.5 FIRST DS LSN= 00000000000002BA
STOP = 04.196 08:53:43.2 LAST DS LSN= 0000000000000444
FILE SEQ=0001 #VOLUMES=0001
CHECKPOINT TYPES=C0: SIMPLE=Y SNAPQ=Y DUMPQ=N PURGE=N FREEZE=N
DSN=IMSVS.SLDSP.SYS3.D04196.T0853432.V02 UNIT=SYSDA
START = 04.196 08:53:43.2 FIRST DS LSN= 0000000000000445
STOP = 04.196 08:56:33.9 LAST DS LSN= 00000000000006F3
FILE SEQ=0001 #VOLUMES=0001
CHECKPOINT TYPES=88: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=Y
Figure 68. Sample Listing of a RECON at the Active Site - Log Records (Part 8 of 10)
DSN=IMSVS.RLDSP.IMS2.D04196.T0855031.V00 UNIT=SYSDA
START = 04.196 08:55:03.1 FIRST DS LSN= 0000000000000001
STOP = 04.196 08:55:33.4 LAST DS LSN= 0000000000000205
FILE SEQ=0001 #VOLUMES=0001
LOGALL
START = 04.196 08:55:03.1 *
EARLIEST ALLOC TIME = 00.000 00:00:00.0
DBDS ALLOC=0
DSN=IMSVS.SLDSP.IMS2.D04196.T0855031.V00 UNIT=SYSDA
START = 04.196 08:55:03.1 FIRST DS LSN= 0000000000000001
STOP = 04.196 08:55:33.4 LAST DS LSN= 0000000000000205
FILE SEQ=0001 #VOLUMES=0001
CHECKPOINT TYPES=88: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=Y
DDNAME=DFSOLP00 DSN=IMSTESTL.IMS02.OLDSP0
START = 04.196 08:55:03.1 FIRST DS LSN= 0000000000000001
STOP = 04.196 08:55:33.4 LAST DS LSN= 0000000000000205
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=04.196 08:55:03.1 ARCHIVE JOB NAME=JT085533
VERSION=9.1
Figure 68. Sample Listing of a RECON at the Active Site - Log Records (Part 9 of 10)
DDNAME=DFSOLP03 DSN=IMSTESTL.IMS01.OLDSP3
START = 04.196 09:31:21.2 FIRST DS LSN= 00000000000005F8
STOP = 04.196 09:47:18.1 LAST DS LSN= 00000000000007AB
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=04.196 09:29:46.6 ARCHIVE JOB NAME=JT085128
VERSION=9.1
DDNAME=DFSOLP01 DSN=IMSTESTL.IMS01.OLDSP1
START = 04.196 09:48:49.8 FIRST DS LSN= 0000000000000001
STOP = 04.196 08:51:28.4 LAST DS LSN= 00000000000002B9
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=04.196 09:48:49.8 ARCHIVE JOB NAME=JT085128
VERSION=9.1
DDNAME=DFSOLP02 DSN=IMSTESTL.IMS01.OLDSP2
START = 04.196 08:51:28.5 FIRST DS LSN= 00000000000002BA
STOP = 04.196 08:53:43.2 LAST DS LSN= 0000000000000444
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=04.196 08:51:28.5 ARCHIVE JOB NAME=JT085343
VERSION=9.1
DDNAME=DFSOLP00 DSN=IMSTESTL.IMS01.OLDSP0
START = 04.196 08:53:43.2 FIRST DS LSN= 0000000000000445
STOP = 04.196 08:56:33.9 LAST DS LSN= 00000000000006F3
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=04.196 08:51:28.5 ARCHIVE JOB NAME=JT085633
VERSION=9.1
| Figure 68. Sample Listing of a RECON at the Active Site - Log Records (Part 10 of 10)
GSG Record
| 04.197 11:04:25.7 LISTING OF RECON PAGE 0002
| -------------------------------------------------------------------------------
| GSG
| GSGNAME=IMSGSG1 #SGS=2 -SGNAME- -ROLE-
| STLSITE1 TRACKING LOCAL
| STLSITE2 ACTIVE
| CURRENT PRILOG TOKEN = 6 TAKEOVER TOKEN = 0
| MINIMUM PRILOG TOKEN = 1 DSN SEQ NUMBER = 0
| START TIME OF CURRENT LOG = 04.196 08:55:03.1
| HIGHEST ACTIVE SITE TIME = 00.000 00:00:00.0
| TRACKING SUBSYSTEM ID = **NULL**
| TAKEOVER IN PROGRESS
| DSP0180I NUMBER OF RECORDS LISTED IS 1
|
| Figure 69. Sample Listing of a RECON at the Active Site - GSG Record
|
SSYS Record
| 04.201 07:41:46.5 LISTING OF RECON PAGE 0017
| -------------------------------------------------------------------------------
| SSYS
| SSID=SYS3 LOG START=04.201 07:39:28.9
| 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=9.1 XRF CAPABLE=NO
| ENCODED
| -DBD- -AREA- -LEVEL- -ACCESS INTENT- -STATE-
| DEDBDD01 DD01AR0 1 UPDATE 6
|
| Figure 70. Sample Listing of a RECON at the Active Site - SSYS Record
|
BACKOUT Record
| 04.197 11:04:33.4 LISTING OF RECON PAGE 0002
| -------------------------------------------------------------------------------
| BACKOUT
| SSID=SYS3 #UORS=2
|
| RECOVERY TOKEN=E2E8E2F3404040400000000300000002
| TIME=04.196 09:49:19.0 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=04.196 09:49:19.1 PSB=PSBEJK05
| INFLT BMP COLDEND
| ASSOCIATED DATA BASES=3
|
| BACKED DYN BKOUT
| -DBD- -OUT - -FAILURE-
| DBOHIDK5 NO NO
| DXVHIDK5 NO NO
| DBVHDJ05 NO NO
|
| Figure 71. Sample Listing of a RECON at the Active Site - BACKOUT Record
|
ALLOC
ALLOC =04.196 09:30:57.0 * ALLOC LRID =0000000000000000
DSSN=0000000004 USID=0000000005 START = 04.196 09:29:46.6
DEALLOC =04.196 09:31:21.1 DEALLOC LRID =0000000000000000
ALLOC
ALLOC =04.196 08:49:43.0 * ALLOC LRID =0000000000000000
DSSN=0000000005 USID=0000000006 START = 04.196 09:48:49.8
IMAGE
RUN = 04.196 09:30:45.8 * RECORD COUNT =33
STOP = 00.000 00:00:00.0 BATCH USID=0000000004
IC1
DSN=IMSVS.DBVHDJ05.CJVHDG1E.IC.IC093043 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222
IMAGE
RUN = 04.196 09:31:42.8 * RECORD COUNT =33
STOP = 04.196 09:31:43.0 CONCUR USID=0000000005
IC1
DSN=IMSVS.DBVHDJ05.CJVHDG1E.IC.IC093140 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222
Figure 74. Sample Listing of a RECON at the Active Site - DB (IMS) and Related Records
| (Part 2 of 2)
|
| Figure 75. Sample Listing of a RECON at the Active Site - DB (HALDB and PART) and
| Related Records (Part 1 of 11)
|
-------------------------------------------------------------------------------
04.194 12:30:54.1 LISTING OF RECON PAGE 0004
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBOHIDK5.A00001 TYPE=PART
DBD=POHIDKA DDN=POHIDKAA DSID=001 DBORG=HIDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=0 DSSN=00000004
NOREUSE RECOVPD=0 OTHER DDN=POHIDKAM
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
IC RECOMMENDED =ON
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------
ALLOC
ALLOC =04.194 11:03:22.4 * ALLOC LRID =0000000000000000
DSSN=0000000001 USID=0000000002 START = 04.194 11:03:20.4
ALLOC
ALLOC =04.194 11:04:10.1 * ALLOC LRID =0000000000000000
DSSN=0000000002 USID=0000000003 START = 04.194 11:04:06.6
ALLOC
ALLOC =04.194 11:09:03.6 * ALLOC LRID =0000000000000000
DSSN=0000000003 USID=0000000004 START = 04.194 11:07:30.7
DEALLOC =04.194 11:13:06.4 DEALLOC LRID =0000000000000000
ALLOC
ALLOC =04.194 11:19:31.3 * ALLOC LRID =0000000000000000
DSSN=0000000004 USID=0000000004 START = 04.194 11:07:30.7
DEALLOC =04.194 11:24:45.5 DEALLOC LRID =0000000000000000
REORG
RUN = 04.194 11:02:28.6 * USID = 0000000001
REORG#=00000
REORG
RUN = 04.194 11:03:02.2 * USID = 0000000001
REORG#=00000
REORG
RUN = 04.194 11:12:58.8 * USID = 0000000004
STOP = 04.194 11:13:06.2 ONLINE RECOV = NO
REORG
RUN = 04.194 11:19:31.3 * USID = 0000000004
REORG#=00000
STOP = 04.194 11:19:32.5 ONLINE RECOV = YES
REORG
RUN = 04.194 11:24:37.3 * USID = 0000000004
REORG#=00000
STOP = 04.194 11:24:45.3 ONLINE RECOV = NO
Figure 75. Sample Listing of a RECON at the Active Site - DB (HALDB and PART) and
Related Records (Part 2 of 11)
ALLOC
ALLOC =04.194 11:03:22.3 * ALLOC LRID =0000000000000000
DSSN=0000000001 USID=0000000002 START = 04.194 11:03:20.4
ALLOC
ALLOC =04.194 11:04:10.0 * ALLOC LRID =0000000000000000
DSSN=0000000002 USID=0000000003 START = 04.194 11:04:06.6
ALLOC
ALLOC =04.194 11:09:03.7 * ALLOC LRID =0000000000000000
DSSN=0000000003 USID=0000000004 START = 04.194 11:07:30.7
DEALLOC =04.194 11:13:06.5 DEALLOC LRID =0000000000000000
ALLOC
ALLOC =04.194 11:19:31.8 * ALLOC LRID =0000000000000000
DSSN=0000000004 USID=0000000004 START = 04.194 11:07:30.7
DEALLOC =04.194 11:24:45.7 DEALLOC LRID =0000000000000000
REORG
RUN = 04.194 11:02:28.6 * USID = 0000000001
REORG
RUN = 04.194 11:03:02.2 * USID = 0000000001
REORG
RUN = 04.194 11:12:58.8 * USID = 0000000004
STOP = 04.194 11:13:06.2 ONLINE RECOV = NO
REORG
RUN = 04.194 11:19:31.3 * USID = 0000000004
STOP = 04.194 11:19:32.5 ONLINE RECOV = YES
REORG
RUN = 04.194 11:24:37.3 * USID = 0000000004
STOP = 04.194 11:24:45.3 ONLINE RECOV = NO
Figure 75. Sample Listing of a RECON at the Active Site - DB (HALDB and PART) and
Related Records (Part 3 of 11)
ALLOC
ALLOC =04.194 11:12:58.8 * ALLOC LRID =0000000000000000
DSSN=0000000004 USID=0000000004 START = 04.194 11:07:30.7
DEALLOC =04.194 11:19:32.7 DEALLOC LRID =0000000000000000
ALLOC
ALLOC =04.194 11:24:37.3 * ALLOC LRID =0000000000000000
DSSN=0000000005 USID=0000000004 START = 04.194 11:07:30.7
REORG
RUN = 04.194 11:12:58.8 * USID = 0000000004
STOP = 04.194 11:13:06.2 ONLINE RECOV = YES
REORG
RUN = 04.194 11:19:31.3 * USID = 0000000004
STOP = 04.194 11:19:32.5 ONLINE RECOV = NO
REORG
RUN = 04.194 11:24:37.3 * USID = 0000000004
STOP = 04.194 11:24:45.3 ONLINE RECOV = YES
Figure 75. Sample Listing of a RECON at the Active Site - DB (HALDB and PART) and
Related Records (Part 4 of 11)
ALLOC
ALLOC =04.194 11:12:59.3 * ALLOC LRID =0000000000000000
DSSN=0000000004 USID=0000000004 START = 04.194 11:07:30.7
DEALLOC =04.194 11:19:32.9 DEALLOC LRID =0000000000000000
ALLOC
ALLOC =04.194 11:24:37.8 * ALLOC LRID =0000000000000000
DSSN=0000000005 USID=0000000004 START = 04.194 11:07:30.7
REORG
RUN = 04.194 11:12:58.8 * USID = 0000000004
STOP = 04.194 11:13:06.2 ONLINE RECOV = YES
REORG
RUN = 04.194 11:19:31.3 * USID = 0000000004
STOP = 04.194 11:19:32.5 ONLINE RECOV = NO
REORG
RUN = 04.194 11:24:37.3 * USID = 0000000004
STOP = 04.194 11:24:45.3 ONLINE RECOV = YES
04.194 12:30:54.1 LISTING OF RECON PAGE 0009
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBOHIDK5.X00001 TYPE=PART
DBD=POHIDKA DDN=POHIDKAX DSID=005 DBORG=INDEX DSORG=VSAM
OTHER DDN=POHIDKAY
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------
04.194 12:30:54.1 LISTING OF RECON PAGE 0010
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBOHIDK5.Y00001 TYPE=PART
DBD=POHIDKA DDN=POHIDKAY DSID=005 DBORG=INDEX DSORG=VSAM
OTHER DDN=POHIDKAX
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------
Figure 75. Sample Listing of a RECON at the Active Site - DB (HALDB and PART) and
Related Records (Part 5 of 11)
FREE SPACE:
FREE BLOCK FREQ FACTOR=0 FREE SPACE PERCENTAGE=0
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 OLR ACTIVE HARD COUNT =0
PARTITION INIT NEEDED =NO OLR INACTIVE HARD COUNT =0
OLREORG CURSOR ACTIVE =NO
PARTITION DISABLED =NO
ONLINE REORG CAPABLE =YES
REORG INTENT =OFF
-------------------------------------------------------------------------------
04.194 12:30:54.1 LISTING OF RECON PAGE 0012
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBOHIDK5.A00002 TYPE=PART
DBD=POHIDKB DDN=POHIDKBA DSID=001 DBORG=HIDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=0 DSSN=00000003
NOREUSE RECOVPD=0 OTHER DDN=**NULL**
DEFLTJCL=**NULL** ICJCL=PICJCL OICJCL=POICJCL RECOVJCL=PRECOJCL
RECVJCL=PRECVJCL
FLAGS: COUNTERS:
IC NEEDED =OFF
RECOV NEEDED =OFF
RECEIVE NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------
Figure 75. Sample Listing of a RECON at the Active Site - DB (HALDB and PART) and
Related Records (Part 6 of 11)
ALLOC
ALLOC =04.194 11:03:25.4 * ALLOC LRID =0000000000000000
DSSN=0000000001 USID=0000000002 START = 04.194 11:03:20.4
ALLOC
ALLOC =04.194 11:04:10.8 * ALLOC LRID =0000000000000000
DSSN=0000000002 USID=0000000003 START = 04.194 11:04:06.6
ALLOC
ALLOC =04.194 11:08:38.8 * ALLOC LRID =0000000000000000
DSSN=0000000003 USID=0000000004 START = 04.194 11:07:30.7
REORG
RUN = 04.194 11:02:29.0 * USID = 0000000001
REORG
RUN = 04.194 11:03:02.6 * USID = 0000000001
04.194 12:30:54.1 LISTING OF RECON PAGE 0013
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBOHIDK5.B00002 TYPE=PART
DBD=POHIDKB DDN=POHIDKBB DSID=006 DBORG=HIDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=0 DSSN=00000003
NOREUSE RECOVPD=0 OTHER DDN=**NULL**
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 =04.194 11:03:25.5 * ALLOC LRID =0000000000000000
DSSN=0000000001 USID=0000000002 START = 04.194 11:03:20.4
ALLOC
ALLOC =04.194 11:04:13.5 * ALLOC LRID =0000000000000000
DSSN=0000000002 USID=0000000003 START = 04.194 11:04:06.6
ALLOC
ALLOC =04.194 11:08:39.3 * ALLOC LRID =0000000000000000
DSSN=0000000003 USID=0000000004 START = 04.194 11:07:30.7
REORG
RUN = 04.194 11:02:29.0 * USID = 0000000001
REORG
RUN = 04.194 11:03:02.6 * USID = 0000000001
Figure 75. Sample Listing of a RECON at the Active Site - DB (HALDB and PART) and
Related Records (Part 7 of 11)
FREE SPACE:
FREE BLOCK FREQ FACTOR=0 FREE SPACE PERCENTAGE=0
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 OLR ACTIVE HARD COUNT =0
PARTITION INIT NEEDED =NO OLR INACTIVE HARD COUNT =0
OLREORG CURSOR ACTIVE =NO
PARTITION DISABLED =NO
ONLINE REORG CAPABLE =YES
REORG INTENT =OFF
-------------------------------------------------------------------------------
Figure 75. Sample Listing of a RECON at the Active Site - DB (HALDB and PART) and
Related Records (Part 8 of 11)
ALLOC
ALLOC =04.194 11:08:14.8 * ALLOC LRID =0000000000000000
DSSN=0000000001 USID=0000000002 START = 04.194 11:07:30.7
REORG
RUN = 04.194 11:02:29.5 * USID = 0000000001
04.194 12:30:54.1 LISTING OF RECON PAGE 0018
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBOHIDK5.B00003 TYPE=PART
DBD=POHIDKC DDN=POHIDKCB DSID=006 DBORG=HIDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=0 DSSN=00000001
NOREUSE RECOVPD=0 OTHER DDN=**NULL**
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 =04.194 11:08:14.8 * ALLOC LRID =0000000000000000
DSSN=0000000001 USID=0000000002 START = 04.194 11:07:30.7
REORG
RUN = 04.194 11:02:29.5 * USID = 0000000001
04.194 12:30:54.1 LISTING OF RECON PAGE 0019
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBOHIDK5.L00003 TYPE=PART
DBD=POHIDKC DDN=POHIDKCL DSID=003 DBORG=INDEX DSORG=VSAM
OTHER DDN=**NULL**
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------
Figure 75. Sample Listing of a RECON at the Active Site - DB (HALDB and PART) and
Related Records (Part 9 of 11)
FREE SPACE:
FREE BLOCK FREQ FACTOR=0 FREE SPACE PERCENTAGE=0
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 OLR ACTIVE HARD COUNT =0
PARTITION INIT NEEDED =NO OLR INACTIVE HARD COUNT =0
OLREORG CURSOR ACTIVE =NO
PARTITION DISABLED =NO
ONLINE REORG CAPABLE =YES
REORG INTENT =OFF
-------------------------------------------------------------------------------
Figure 75. Sample Listing of a RECON at the Active Site - DB (HALDB and PART) and
Related Records (Part 10 of 11)
ALLOC
ALLOC =04.194 11:07:52.2 * ALLOC LRID =0000000000000000
DSSN=0000000001 USID=0000000002 START = 04.194 11:07:30.7
REORG
RUN = 04.194 11:02:29.9 * USID = 0000000001
04.194 12:30:54.1 LISTING OF RECON PAGE 0023
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBOHIDK5.B00004 TYPE=PART
DBD=POHIDKD DDN=POHIDKDB DSID=006 DBORG=HIDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=0 DSSN=00000001
NOREUSE RECOVPD=0 OTHER DDN=**NULL**
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 =04.194 11:07:52.3 * ALLOC LRID =0000000000000000
DSSN=0000000001 USID=0000000002 START = 04.194 11:07:30.7
REORG
RUN = 04.194 11:02:29.9 * USID = 0000000001
04.194 12:30:54.1 LISTING OF RECON PAGE 0024
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBOHIDK5.L00004 TYPE=PART
DBD=POHIDKD DDN=POHIDKDL DSID=003 DBORG=INDEX DSORG=VSAM
OTHER DDN=**NULL**
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------
04.194 12:30:54.1 LISTING OF RECON PAGE 0025
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBOHIDK5.X00004 TYPE=PART
DBD=POHIDKD DDN=POHIDKDX DSID=005 DBORG=INDEX DSORG=VSAM
OTHER DDN=**NULL**
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------
Figure 75. Sample Listing of a RECON at the Active Site - DB (HALDB and PART) and
| Related Records (Part 11 of 11)
In This Section:
v “RECON Status Record”
v “Log Records” on page 509
v “GSG Record” on page 515
v “SSYS Record” on page 516
v “BACKOUT Record” on page 516
v “CAGRP and CA Records” on page 517
v “DBDSGRP Records” on page 518
v “DB (IMS) and Related Records” on page 519
v “DB (HALDB and PART) and Related Records” on page 521
v “DB (FP) and Related Records” on page 532
Log Records
|
| 04.197 11:48:55.3 LISTING OF RECON PAGE 0002
| -------------------------------------------------------------------------------
| PRILOG RECORD SIZE= 624
| START = 04.196 09:21:02.7 * SSID=SYS3 VERSION=9.1
| STOP = 04.196 09:28:46.6 #DSN=3
| GSGNAME=IMSGSG1 TRACKING
| FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 1
| EARLIEST CHECKPOINT = 04.196 09:21:04.5
|
| DSN=IMSTESTL.RSR.RLDS1.N0000005
| START = 04.196 09:21:02.7 FIRST DS LSN= 0000000000000001
| STOP = 04.196 09:24:54.6 LAST DS LSN= 000000000000044C
| #DS CHECKPOINTS= 1 CHKPT ID = 00.000 00:00:00.0
|
| DSN=IMSTESTL.RSR.RLDS1.N0000008
| START = 04.196 09:24:54.6 FIRST DS LSN= 000000000000044D
| STOP = 04.196 09:28:46.4 LAST DS LSN= 0000000000000624
| #DS CHECKPOINTS= 2 CHKPT ID = 04.196 09:24:54.7
|
| DSN=IMSTESTL.RSR.RLDS1.N0000010
| START = 04.196 09:28:46.4 FIRST DS LSN= 0000000000000625
| STOP = 04.196 09:28:46.6 LAST DS LSN= 0000000000000689
| #DS CHECKPOINTS= 0 CHKPT ID = 04.196 09:28:46.3
|
| LOGALL
| START = 04.196 09:21:02.7 *
| EARLIEST ALLOC TIME = 04.196 09:22:45.2
| DBDS ALLOC=5 -DBD- -DDN- -ALLOC-
| DEDBJN21 DB21AR1 1
| DEDBJN21 DB21AR2 1
| DEDBJN21 DB21AR3 1
| DEDBJN21 DB21AR4 1
| DEDBJN21 DB21AR5 1
| 04.197 11:48:55.3 LISTING OF RECON PAGE 0003
| -------------------------------------------------------------------------------
| PRISLD RECORD SIZE= 624
| START = 04.196 09:21:02.7 * SSID=SYS3 VERSION=9.1
| STOP = 04.196 09:28:46.6 #DSN=3
| GSGNAME=IMSGSG1 TRACKING
| FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 1
|
| DSN=IMSTESTL.RSR.ARCH1.N0000004
| START = 04.196 09:21:02.7 FIRST DS LSN= 0000000000000001
| STOP = 04.196 09:24:54.6 LAST DS LSN= 000000000000044C
| #DS CHECKPOINTS= 1 CHKPT ID = 00.000 00:00:00.0
| CHECKPOINT TYPES=80: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=N
|
| DSN=IMSTESTL.RSR.ARCH1.N0000007
| START = 04.196 09:24:54.6 FIRST DS LSN= 000000000000044D
| STOP = 04.196 09:28:46.4 LAST DS LSN= 0000000000000624
| #DS CHECKPOINTS= 2 CHKPT ID = 04.196 09:24:54.7
| CHECKPOINT TYPES=88: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=Y
|
| DSN=IMSTESTL.RSR.ARCH1.N0000009
| START = 04.196 09:28:46.4 FIRST DS LSN= 0000000000000625
| STOP = 04.196 09:28:46.6 LAST DS LSN= 0000000000000689
| #DS CHECKPOINTS= 0 CHKPT ID = 04.196 09:28:46.3
|
| Figure 78. Sample Listing of a RECON at the Tracking Site - Log Records (Part 1 of 7)
|
|
DSN=IMSTESTL.RSR.RLDS1.N0000023
START = 04.196 09:31:06.2 FIRST DS LSN= 00000000000004DA
STOP = 04.196 09:31:21.2 LAST DS LSN= 00000000000005F7
#DS CHECKPOINTS= 1 CHKPT ID = 04.196 09:31:14.9
DSN=IMSTESTL.RSR.RLDS1.N0000026
START = 04.196 09:31:21.2 FIRST DS LSN= 00000000000005F8
STOP = 04.196 09:47:18.1 LAST DS LSN= 00000000000007BD
#DS CHECKPOINTS= 2 CHKPT ID = 00.000 00:00:00.0
DSN=IMSTESTL.RSR.RLDS1.N0000028
START = 04.196 09:47:18.1 FIRST DS LSN= 00000000000007BE
STOP = 04.196 09:47:18.3 LAST DS LSN= 0000000000000828
#DS CHECKPOINTS= 0 CHKPT ID = 04.196 09:47:18.1
LOGALL
START = 04.196 09:29:46.6 *
EARLIEST ALLOC TIME = 00.000 00:00:00.0
DBDS ALLOC=0
04.197 11:48:55.3 LISTING OF RECON PAGE 0005
-------------------------------------------------------------------------------
PRISLD RECORD SIZE= 744
START = 04.196 09:29:46.6 * SSID=SYS3 VERSION=9.1
STOP = 04.196 09:47:18.3 #DSN=4
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 2
DSN=IMSTESTL.RSR.ARCH1.N0000022
START = 04.196 09:31:06.2 FIRST DS LSN= 00000000000004DA
STOP = 04.196 09:31:21.2 LAST DS LSN= 00000000000005F7
#DS CHECKPOINTS= 1 CHKPT ID = 04.196 09:31:14.9
CHECKPOINT TYPES=40: SIMPLE=N SNAPQ=Y DUMPQ=N PURGE=N FREEZE=N
DSN=IMSTESTL.RSR.ARCH1.N0000025
START = 04.196 09:31:21.2 FIRST DS LSN= 00000000000005F8
STOP = 04.196 09:47:18.1 LAST DS LSN= 00000000000007BD
#DS CHECKPOINTS= 2 CHKPT ID = 00.000 00:00:00.0
CHECKPOINT TYPES=88: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=Y
DSN=IMSTESTL.RSR.ARCH1.N0000027
START = 04.196 09:47:18.1 FIRST DS LSN= 00000000000007BE
STOP = 04.196 09:47:18.3 LAST DS LSN= 0000000000000828
#DS CHECKPOINTS= 0 CHKPT ID = 04.196 09:47:18.1
CHECKPOINT TYPES=00: SIMPLE=N SNAPQ=N DUMPQ=N PURGE=N FREEZE=N
Figure 78. Sample Listing of a RECON at the Tracking Site - Log Records (Part 2 of 7)
|
04.197 11:48:55.3 LISTING OF RECON PAGE 0006
-------------------------------------------------------------------------------
PRILOG RECORD SIZE= 304
START = 04.196 09:47:38.3 * SSID=BATCH1 VERSION=9.1
STOP = 04.196 09:47:39.4 #DSN=1
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 3
DSN=IMSTESTL.RSR.ARCH1.N0000030
START = 04.196 09:47:38.3 FIRST DS LSN= 0000000000000001
STOP = 04.196 09:47:39.4 LAST DS LSN= 000000000000009C
#DS CHECKPOINTS= 0 CHKPT ID = 00.000 00:00:00.0
LOGALL
START = 04.196 09:47:38.3 *
EARLIEST ALLOC TIME = 04.196 09:47:39.0
DBDS ALLOC=3 -DBD- -DDN- -ALLOC-
DHVNTZ02 HIDAM 1
DXVNTZ02 XDLBT04I 1
DIVNTZ02 DBHVSAM1 1
04.197 11:48:55.3 LISTING OF RECON PAGE 0007
-------------------------------------------------------------------------------
PRILOG RECORD SIZE= 464
START = 04.196 09:48:49.8 * SSID=SYS3 VERSION=9.1
STOP = 04.196 08:51:28.4 #DSN=2
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 4
EARLIEST CHECKPOINT = 04.196 09:48:51.5
DSN=IMSTESTL.RSR.RLDS1.N0000033
START = 04.196 09:48:49.8 FIRST DS LSN= 0000000000000001
STOP = 04.196 08:49:42.8 LAST DS LSN= 0000000000000235
#DS CHECKPOINTS= 1 CHKPT ID = 04.196 09:48:51.5
DSN=IMSTESTL.RSR.RLDS1.N0000037
START = 04.196 08:49:42.8 FIRST DS LSN= 0000000000000236
STOP = 04.196 08:51:28.4 LAST DS LSN= 00000000000002B9
#DS CHECKPOINTS= 0 CHKPT ID = 00.000 00:00:00.0
LOGALL
START = 04.196 09:48:49.8 *
EARLIEST ALLOC TIME = 04.196 09:48:51.8
DBDS ALLOC=4 -DBD- -DDN- -ALLOC-
DEDBDD01 DD01AR0 1
DHVNTZ02 HIDAM 1
DXVNTZ02 XDLBT04I 1
DIVNTZ02 DBHVSAM1 1
04.197 11:48:55.3 LISTING OF RECON PAGE 0008
-------------------------------------------------------------------------------
PRISLD RECORD SIZE= 464
START = 04.196 09:48:49.8 * SSID=SYS3 VERSION=9.1
STOP = 04.196 08:51:28.4 #DSN=2
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 4
DSN=IMSTESTL.RSR.ARCH1.N0000032
START = 04.196 09:48:49.8 FIRST DS LSN= 0000000000000001
STOP = 04.196 08:49:42.8 LAST DS LSN= 0000000000000235
#DS CHECKPOINTS= 1 CHKPT ID = 04.196 09:48:51.5
CHECKPOINT TYPES=80: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=N
Figure 78. Sample Listing of a RECON at the Tracking Site - Log Records (Part 3 of 7)
DSN=IMSTESTL.RSR.ARCH1.N0000036
START = 04.196 08:49:42.8 FIRST DS LSN= 0000000000000236
STOP = 04.196 08:51:28.4 LAST DS LSN= 00000000000002B9
#DS CHECKPOINTS= 0 CHKPT ID = 00.000 00:00:00.0
CHECKPOINT TYPES=00: SIMPLE=N SNAPQ=N DUMPQ=N PURGE=N FREEZE=N
04.197 11:48:55.3 LISTING OF RECON PAGE 0009
-------------------------------------------------------------------------------
PRILOG RECORD SIZE= 944
START = 04.196 08:51:28.5 * SSID=SYS3 VERSION=9.1
STOP = 04.196 08:56:33.8 #DSN=5
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 00000000000002BA PRILOG TOKEN= 5
EARLIEST CHECKPOINT = 04.196 08:51:30.4
DSN=IMSTESTL.RSR.RLDS1.N0000039
START = 04.196 08:51:28.5 FIRST DS LSN= 00000000000002BA
STOP = 04.196 08:51:30.6 LAST DS LSN= 0000000000000378
#DS CHECKPOINTS= 1 CHKPT ID = 04.196 09:48:51.5
DSN=IMSTESTL.RSR.SLDS1.N0000047
START = 04.196 08:51:30.6 FIRST DS LSN= 0000000000000379
STOP = 04.196 08:53:43.2 LAST DS LSN= 0000000000000444
#DS CHECKPOINTS= 1 CHKPT ID = 04.196 08:51:30.4
DSN=IMSTESTL.RSR.SLDS1.N0000052
START = 04.196 08:53:43.2 FIRST DS LSN= 0000000000000445
STOP = 04.196 08:53:43.3 LAST DS LSN= 00000000000004C2
#DS CHECKPOINTS= 0 CHKPT ID = 04.196 08:51:30.4
DSN=IMSTESTL.RSR.RLDS1.N0000049
START = 04.196 08:53:43.3 FIRST DS LSN= 00000000000004C3
STOP = 04.196 08:56:33.7 LAST DS LSN= 0000000000000692
#DS CHECKPOINTS= 2 CHKPT ID = 04.196 08:53:52.8
DSN=IMSTESTL.RSR.RLDS1.N0000051
START = 04.196 08:56:33.7 FIRST DS LSN= 0000000000000693
STOP = 04.196 08:56:33.8 LAST DS LSN= 00000000000006F3
#DS CHECKPOINTS= 0 CHKPT ID = 04.196 08:56:33.6
LOGALL
START = 04.196 08:51:28.5 *
EARLIEST ALLOC TIME = 04.196 08:51:31.6
DBDS ALLOC=1 -DBD- -DDN- -ALLOC-
DEDBDD01 DD01AR0 1
Figure 78. Sample Listing of a RECON at the Tracking Site - Log Records (Part 4 of 7)
DSN=IMSTESTL.RSR.ARCH1.N0000038
START = 04.196 08:51:28.5 FIRST DS LSN= 00000000000002BA
STOP = 04.196 08:51:30.6 LAST DS LSN= 0000000000000378
#DS CHECKPOINTS= 1 CHKPT ID = 04.196 09:48:51.5
CHECKPOINT TYPES=40: SIMPLE=N SNAPQ=Y DUMPQ=N PURGE=N FREEZE=N
DSN=IMSTESTL.RSR.SLDS1.N0000047
START = 04.196 08:51:30.6 FIRST DS LSN= 0000000000000379
STOP = 04.196 08:53:43.2 LAST DS LSN= 0000000000000444
#DS CHECKPOINTS= 1 CHKPT ID = 04.196 08:51:30.4
CHECKPOINT TYPES=80: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=N
DSN=IMSTESTL.RSR.SLDS1.N0000052
START = 04.196 08:53:43.2 FIRST DS LSN= 0000000000000445
STOP = 04.196 08:53:43.3 LAST DS LSN= 00000000000004C2
#DS CHECKPOINTS= 0 CHKPT ID = 04.196 08:51:30.4
CHECKPOINT TYPES=00: SIMPLE=N SNAPQ=N DUMPQ=N PURGE=N FREEZE=N
DSN=IMSTESTL.RSR.ARCH1.N0000048
START = 04.196 08:53:43.3 FIRST DS LSN= 00000000000004C3
STOP = 04.196 08:56:33.7 LAST DS LSN= 0000000000000692
#DS CHECKPOINTS= 2 CHKPT ID = 04.196 08:53:52.8
CHECKPOINT TYPES=88: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=Y
DSN=IMSTESTL.RSR.ARCH1.N0000050
START = 04.196 08:56:33.7 FIRST DS LSN= 0000000000000693
STOP = 04.196 08:56:33.8 LAST DS LSN= 00000000000006F3
#DS CHECKPOINTS= 0 CHKPT ID = 04.196 08:56:33.6
CHECKPOINT TYPES=00: SIMPLE=N SNAPQ=N DUMPQ=N PURGE=N FREEZE=N
04.197 11:48:55.3 LISTING OF RECON PAGE 0011
-------------------------------------------------------------------------------
PRILOG RECORD SIZE= 464
START = 04.196 08:55:03.1 * SSID=IMS2 VERSION=9.1
STOP = 04.196 08:55:33.3 #DSN=2
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 6
EARLIEST CHECKPOINT = 04.196 08:55:04.9
DSN=IMSTESTL.RSR.RLDS1.N0000044
START = 04.196 08:55:03.1 FIRST DS LSN= 0000000000000001
STOP = 04.196 08:55:33.2 LAST DS LSN= 00000000000001A4
#DS CHECKPOINTS= 2 CHKPT ID = 04.196 08:55:04.9
DSN=IMSTESTL.RSR.RLDS1.N0000046
START = 04.196 08:55:33.2 FIRST DS LSN= 00000000000001A5
STOP = 04.196 08:55:33.3 LAST DS LSN= 0000000000000205
#DS CHECKPOINTS= 0 CHKPT ID = 04.196 08:55:33.1
Figure 78. Sample Listing of a RECON at the Tracking Site - Log Records (Part 5 of 7)
LOGALL
START = 04.196 08:55:03.1 *
EARLIEST ALLOC TIME = 00.000 00:00:00.0
DBDS ALLOC=0
04.197 11:48:55.3 LISTING OF RECON PAGE 0012
-------------------------------------------------------------------------------
PRISLD RECORD SIZE= 464
START = 04.196 08:55:03.1 * SSID=IMS2 VERSION=9.1
STOP = 04.196 08:55:33.3 #DSN=2
GSGNAME=IMSGSG1 TRACKING
FIRST RECORD ID= 0000000000000001 PRILOG TOKEN= 6
DSN=IMSTESTL.RSR.ARCH1.N0000043
START = 04.196 08:55:03.1 FIRST DS LSN= 0000000000000001
STOP = 04.196 08:55:33.2 LAST DS LSN= 00000000000001A4
#DS CHECKPOINTS= 2 CHKPT ID = 04.196 08:55:04.9
CHECKPOINT TYPES=88: SIMPLE=Y SNAPQ=N DUMPQ=N PURGE=N FREEZE=Y
DSN=IMSTESTL.RSR.ARCH1.N0000045
START = 04.196 08:55:33.2 FIRST DS LSN= 00000000000001A5
STOP = 04.196 08:55:33.3 LAST DS LSN= 0000000000000205
#DS CHECKPOINTS= 0 CHKPT ID = 04.196 08:55:33.1
CHECKPOINT TYPES=00: SIMPLE=N SNAPQ=N DUMPQ=N PURGE=N FREEZE=N
04.197 11:48:55.3 LISTING OF RECON PAGE 0013
-------------------------------------------------------------------------------
PRIOLD
SSID=SYS3 # DD ENTRIES=2
EARLIEST CHECKPOINT = 04.196 09:20:23.6
DDNAME=DFSOLP00 DSN=IMSTESTL.IMS01.OLDSP0
START = 04.196 09:20:22.9 FIRST DS LSN= 0000000000000001
STOP = 04.196 08:53:56.8 LAST DS LSN= 000000000000051E
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=YES AVAIL
PRILOG TIME=04.196 09:20:22.9 ARCHIVE JOB NAME=JT085357
VERSION=9.1
DDNAME=DFSOLP01 DSN=IMSTESTL.IMS01.OLDSP1
START = 04.196 08:53:56.8 FIRST DS LSN= 000000000000051F
STOP = 04.196 08:57:01.5 LAST DS LSN= 00000000000007AF
LOCK SEQUENCE# = 000000000000
STATUS=ARC COMPLT FEOV=NO AVAIL
PRILOG TIME=04.196 09:20:22.9 ARCHIVE JOB NAME=JT085701
VERSION=9.1
Figure 78. Sample Listing of a RECON at the Tracking Site - Log Records (Part 6 of 7)
DSN=IMSVS.SLDSP.SYS3.D04196.T0920229.V00 UNIT=SYSDA
START = 04.196 09:20:22.9 FIRST DS LSN= 0000000000000001
STOP = 04.196 08:53:56.8 LAST DS LSN= 000000000000051E
FILE SEQ=0001 #VOLUMES=0001
DSN=IMSVS.SLDSP.SYS3.D04196.T0853568.V00 UNIT=SYSDA
START = 04.196 08:53:56.8 FIRST DS LSN= 000000000000051F
STOP = 04.196 08:57:01.5 LAST DS LSN= 00000000000007AF
FILE SEQ=0001 #VOLUMES=0001
| Figure 78. Sample Listing of a RECON at the Tracking Site - Log Records (Part 7 of 7)
GSG Record
| 04.197 11:48:28.1 LISTING OF RECON PAGE 0002
| -------------------------------------------------------------------------------
| GSG
| GSGNAME=IMSGSG1 #SGS=2 -SGNAME- -ROLE-
| STLSITE1 TRACKING
| STLSITE2 ACTIVE LOCAL
| CURRENT PRILOG TOKEN = 6 TAKEOVER TOKEN = 0
| MINIMUM PRILOG TOKEN = 1 DSN SEQ NUMBER = 52
| START TIME OF CURRENT LOG = 04.196 08:55:03.1
| HIGHEST ACTIVE SITE TIME = 04.196 08:56:33.8
| TRACKING SUBSYSTEM ID = SYS3
| TAKEOVER IN PROGRESS
|
| Figure 79. Sample Listing of a RECON at the Tracking Site - GSG Record
|
SSYS Record
| 04.201 07:41:52.9 LISTING OF RECON PAGE 0015
| -------------------------------------------------------------------------------
| SSYS
| SSID=SYS3 LOG START=04.201 08:08:18.6
| 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=3 VERSION=9.1 XRF CAPABLE=NO
| ENCODED
| -DBD- -AREA- -LEVEL- -ACCESS INTENT- -STATE-
| DHVNTZ02 **NULL** 3 EXCLUSIVE 7
| DXVNTZ02 **NULL** 3 EXCLUSIVE 7
| DIVNTZ02 **NULL** 3 EXCLUSIVE 7
|
| SSYS
| SSID=SYS3 LOG START=04.201 08:36:48.4
| 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=9.1
XRF CAPABLE=NO
| 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
| 04.201 07:41:52.9 LISTING OF RECON PAGE 0016
| -------------------------------------------------------------------------------
|
| Figure 80. Sample Listing of a RECON at the Tracking Site - SSYS Record
|
BACKOUT Record
| 04.197 11:48:49.2 LISTING OF RECON PAGE 0002
| -------------------------------------------------------------------------------
| BACKOUT
| SSID=SYS3 #UORS=1
|
| RECOVERY TOKEN=E2E8E2F3404040400000000300000002
| TIME=04.196 09:49:19.0 PSB=PLVAPZ12
| INFLT BMP
| ASSOCIATED DATA BASES=3
|
| BACKED DYN BKOUT
| -DBD- -OUT - -FAILURE-
| DHVNTZ02 NO NO
| DXVNTZ02 NO NO
| DIVNTZ02 NO NO
|
| Figure 81. Sample Listing of a RECON at the Tracking Site - BACKOUT Record
|
DBDSGRP Records
| 04.198 09:19:44.3 LISTING OF RECON PAGE 0002
| -------------------------------------------------------------------------------
| 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 83. Sample Listing of a RECON at the Tracking Site - DBDSGRP Records
|
-------------------------------------------------------------------------------
04.198 08:57:55.5 LISTING OF RECON PAGE 0006
-------------------------------------------------------------------------------
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 OTHER DDN=**NULL**
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 =04.196 09:47:39.0 * ALLOC LRID =0000000000000009
DSSN=0000000001 USID=0000000002 START = 04.196 09:47:38.3
ALLOC
ALLOC =04.196 09:49:18.9 * ALLOC LRID =0000000000000155
DSSN=0000000002 USID=0000000003 START = 04.196 09:48:49.8
IMAGE
RUN = 04.196 09:18:36.0 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 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 = 04.196 09:18:47.9 * RUN USID = 0000000001
04.198 08:57:55.5 LISTING OF RECON PAGE 0007
-------------------------------------------------------------------------------
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 OTHER DDN=**NULL**
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 = 04.196 09:18:36.0 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 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 = 04.196 09:18:48.0 * RUN USID = 0000000001
Figure 84. Sample Listing of a RECON at the Tracking Site - DB (IMS) and Related Records
| (Part 2 of 2)
|
| Figure 85. Sample Listing of a RECON at the Tracking Site - DB (HALDB and PART) and
| Related Records (Part 1 of 11)
|
-------------------------------------------------------------------------------
03.287 13:23:51.7 LISTING OF RECON PAGE 0015
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHIDJ03.A00001 TYPE=PART
DBD=POHIDJA DDN=POHIDJAA DSID=001 DBORG=HIDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000002
NOREUSE RECOVPD=0 OTHER DDN=**NULL**
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 =03.287 10:49:51.9 * ALLOC LRID =000000000000000C
DSSN=0000000001 USID=0000000002 START = 03.287 10:49:50.0
ALLOC
ALLOC =03.287 10:55:40.2 * ALLOC LRID =0000000000000012
DSSN=0000000002 USID=0000000003 START = 03.287 10:55:36.8
IMAGE
RUN = 03.287 11:22:19.0 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000003
IC1
DSN=IMSVS.POHIDJA.POHIDJAA.IC.IC112153 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222
REORG
RUN = 03.287 10:49:13.7 * USID = 0000000001
RECOV
RUN = 03.287 11:47:59.9 * RUN USID = 0000000000
Figure 85. Sample Listing of a RECON at the Tracking Site - DB (HALDB and PART) and
Related Records (Part 2 of 11)
ALLOC
ALLOC =03.287 10:49:51.8 * ALLOC LRID =0000000000000008
DSSN=0000000001 USID=0000000002 START = 03.287 10:49:50.0
ALLOC
ALLOC =03.287 10:55:40.1 * ALLOC LRID =000000000000000D
DSSN=0000000002 USID=0000000003 START = 03.287 10:55:36.8
IMAGE
RUN = 03.287 11:23:05.7 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000003
IC1
DSN=IMSVS.POHIDJA.POHIDJAB.IC.IC112154 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222
REORG
RUN = 03.287 10:49:13.7 * USID = 0000000001
RECOV
RUN = 03.287 11:54:13.3 * RUN USID = 0000000000
03.287 13:23:51.7 LISTING OF RECON PAGE 0017
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHIDJ03.L00001 TYPE=PART
DBD=POHIDJA DDN=POHIDJAL DSID=003 DBORG=INDEX DSORG=VSAM
OTHER DDN=**NULL**
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------
03.287 13:23:51.7 LISTING OF RECON PAGE 0018
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHIDJ03.X00001 TYPE=PART
DBD=POHIDJA DDN=POHIDJAX DSID=005 DBORG=INDEX DSORG=VSAM
OTHER DDN=**NULL**
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0
Figure 85. Sample Listing of a RECON at the Tracking Site - DB (HALDB and PART) and
Related Records (Part 3 of 11)
-------------------------------------------------------------------------------
03.287 13:23:51.7 LISTING OF RECON PAGE 0019
-------------------------------------------------------------------------------
DB
DBD=POHIDJB MASTER DB=DBHIDJ03 IRLMID=*NULL CHANGE#=3 TYPE=PART
USID=0000000003 AUTHORIZED USID=0000000003 HARD USID=0000000003
RECEIVE USID=0000000003 RECEIVE NEEDED USID=0000000000
DBRCVGRP=**NULL**
DSN PREFIX=IMSTESTS.DBHIDJ03 PARTITION ID=00002
PREVIOUS PARTITION=POHIDJA NEXT PARTITION=POHIDJC
OLRIMSID=**NULL** ACTIVE DBDS=A-J
FREE SPACE:
FREE BLOCK FREQ FACTOR=0 FREE SPACE PERCENTAGE=0
FLAGS: COUNTERS:
BACKOUT NEEDED =OFF RECOVERY NEEDED COUNT =0
READ ONLY =OFF IMAGE COPY NEEDED COUNT =0
PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =1
HELD AUTHORIZATION STATE=0
DATABASE LEVEL TRACK =YES EEQE COUNT =0
TRACKING SUSPENDED =NO RECEIVE REQUIRED COUNT =0
OFR REQUIRED =NO OLR ACTIVE HARD COUNT =0
PARTITION INIT NEEDED =NO OLR INACTIVE HARD COUNT =0
OLREORG CURSOR ACTIVE =NO
PARTITION DISABLED =NO
ONLINE REORG CAPABLE =YES
Figure 85. Sample Listing of a RECON at the Tracking Site - DB (HALDB and PART) and
Related Records (Part 4 of 11)
-------------------------------------------------------------------------------
03.287 13:23:51.7 LISTING OF RECON PAGE 0020
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHIDJ03.A00002 TYPE=PART
DBD=POHIDJB DDN=POHIDJBA DSID=001 DBORG=HIDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000002
NOREUSE RECOVPD=0 OTHER DDN=**NULL**
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 =03.287 10:49:56.6 * ALLOC LRID =0000000000000C62
DSSN=0000000001 USID=0000000002 START = 03.287 10:49:50.0
ALLOC
ALLOC =03.287 10:55:44.5 * ALLOC LRID =0000000000000992
DSSN=0000000002 USID=0000000003 START = 03.287 10:55:36.8
IMAGE
RUN = 03.287 11:23:42.4 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000003
IC1
DSN=IMSVS.POHIDJB.POHIDJBA.IC.IC112155 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222
REORG
RUN = 03.287 10:49:14.0 * USID = 0000000001
RECOV
RUN = 03.287 12:01:41.5 * RUN USID = 0000000000
Figure 85. Sample Listing of a RECON at the Tracking Site - DB (HALDB and PART) and
Related Records (Part 5 of 11)
ALLOC
ALLOC =03.287 10:49:55.4 * ALLOC LRID =0000000000000C2A
DSSN=0000000001 USID=0000000002 START = 03.287 10:49:50.0
ALLOC
ALLOC =03.287 10:55:44.4 * ALLOC LRID =000000000000092E
DSSN=0000000002 USID=0000000003 START = 03.287 10:55:36.8
IMAGE
RUN = 03.287 11:24:19.6 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000003
IC1
DSN=IMSVS.POHIDJB.POHIDJBB.IC.IC112155 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222
REORG
RUN = 03.287 10:49:14.0 * USID = 0000000001
RECOV
RUN = 03.287 12:10:36.0 * RUN USID = 0000000000
03.287 13:23:51.7 LISTING OF RECON PAGE 0022
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHIDJ03.L00002 TYPE=PART
DBD=POHIDJB DDN=POHIDJBL DSID=003 DBORG=INDEX DSORG=VSAM
OTHER DDN=**NULL**
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0
-------------------------------------------------------------------------------
03.287 13:23:51.7 LISTING OF RECON PAGE 0023
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHIDJ03.X00002 TYPE=PART
DBD=POHIDJB DDN=POHIDJBX DSID=005 DBORG=INDEX DSORG=VSAM
OTHER DDN=**NULL**
FLAGS: COUNTERS:
RECOV NEEDED =OFF EEQE COUNT =0
Figure 85. Sample Listing of a RECON at the Tracking Site - DB (HALDB and PART) and
Related Records (Part 6 of 11)
-------------------------------------------------------------------------------
03.287 13:23:51.7 LISTING OF RECON PAGE 0024
-------------------------------------------------------------------------------
DB
DBD=POHIDJC MASTER DB=DBHIDJ03 IRLMID=*NULL CHANGE#=4 TYPE=PART
USID=0000000001 AUTHORIZED USID=0000000001 HARD USID=0000000001
RECEIVE USID=0000000001 RECEIVE NEEDED USID=0000000000
DBRCVGRP=**NULL**
DSN PREFIX=IMSTESTS.DBHIDJ03 PARTITION ID=00003
PREVIOUS PARTITION=POHIDJB NEXT PARTITION=POHIDJD
OLRIMSID=**NULL** ACTIVE DBDS=A-J
FREE SPACE:
FREE BLOCK FREQ FACTOR=0 FREE SPACE PERCENTAGE=0
PARTITION HIGH KEY/STRING (CHAR): (LENGTH=5 )
J0600
PARTITION HIGH KEY/STRING (HEX):
D1F0F6F0F0404040404040404040404040404040404040404040404040404040
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
DATABASE LEVEL TRACK =YES EEQE COUNT =0
TRACKING SUSPENDED =NO RECEIVE REQUIRED COUNT =0
OFR REQUIRED =NO OLR ACTIVE HARD COUNT =0
PARTITION INIT NEEDED =NO OLR INACTIVE HARD COUNT =0
OLREORG CURSOR ACTIVE =NO
PARTITION DISABLED =NO
ONLINE REORG CAPABLE =YES
Figure 85. Sample Listing of a RECON at the Tracking Site - DB (HALDB and PART) and
Related Records (Part 7 of 11)
-------------------------------------------------------------------------------
03.287 13:23:51.7 LISTING OF RECON PAGE 0025
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHIDJ03.A00003 TYPE=PART
DBD=POHIDJC DDN=POHIDJCA DSID=001 DBORG=HIDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000000
NOREUSE RECOVPD=0 OTHER DDN=**NULL**
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 = 03.287 11:24:57.2 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000001
IC1
DSN=IMSVS.POHIDJC.POHIDJCA.IC.IC112156 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222
RECOV
RUN = 03.287 12:16:02.1 * RUN USID = 0000000000
03.287 13:23:51.7 LISTING OF RECON PAGE 0026
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHIDJ03.B00003 TYPE=PART
DBD=POHIDJC DDN=POHIDJCB DSID=006 DBORG=HIDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000000
NOREUSE RECOVPD=0 OTHER DDN=**NULL**
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 = 03.287 11:25:37.6 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000001
IC1
DSN=IMSVS.POHIDJC.POHIDJCB.IC.IC112156 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222
RECOV
RUN = 03.287 12:20:52.3 * RUN USID = 0000000000
Figure 85. Sample Listing of a RECON at the Tracking Site - DB (HALDB and PART) and
Related Records (Part 8 of 11)
FREE SPACE:
FREE BLOCK FREQ FACTOR=0 FREE SPACE PERCENTAGE=0
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
DATABASE LEVEL TRACK =YES EEQE COUNT =0
TRACKING SUSPENDED =NO RECEIVE REQUIRED COUNT =0
OFR REQUIRED =NO OLR ACTIVE HARD COUNT =0
PARTITION INIT NEEDED =NO OLR INACTIVE HARD COUNT =0
OLREORG CURSOR ACTIVE =NO
PARTITION DISABLED =NO
ONLINE REORG CAPABLE =YES
Figure 85. Sample Listing of a RECON at the Tracking Site - DB (HALDB and PART) and
Related Records (Part 9 of 11)
-------------------------------------------------------------------------------
03.287 13:23:51.7 LISTING OF RECON PAGE 0030
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHIDJ03.A00004 TYPE=PART
DBD=POHIDJD DDN=POHIDJDA DSID=001 DBORG=HIDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000000
NOREUSE RECOVPD=0 OTHER DDN=**NULL**
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 = 03.287 11:26:12.4 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000001
IC1
DSN=IMSVS.POHIDJD.POHIDJDA.IC.IC112157 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222
RECOV
RUN = 03.287 12:26:02.7 * RUN USID = 0000000000
03.287 13:23:51.7 LISTING OF RECON PAGE 0031
-------------------------------------------------------------------------------
DBDS
DSN=IMSTESTS.DBHIDJ03.B00004 TYPE=PART
DBD=POHIDJD DDN=POHIDJDB DSID=006 DBORG=HIDAM DSORG=OSAM
CAGRP=**NULL** GENMAX=2 IC AVAIL=0 IC USED=1 DSSN=00000000
NOREUSE RECOVPD=0 OTHER DDN=**NULL**
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 = 03.287 11:26:54.2 * RECORD COUNT =0
STOP = 00.000 00:00:00.0 BATCH USID=0000000001
IC1
DSN=IMSVS.POHIDJD.POHIDJDB.IC.IC112157 FILE SEQ=0001
UNIT=SYSDA VOLS DEF=0001 VOLS USED=0001
VOLSER=222222
RECOV
RUN = 03.287 12:30:52.7 * RUN USID = 0000000000
Figure 85. Sample Listing of a RECON at the Tracking Site - DB (HALDB and PART) and
Related Records (Part 10 of 11)
Figure 85. Sample Listing of a RECON at the Tracking Site - DB (HALDB and PART) and
| Related Records (Part 11 of 11)
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.
| or
Note: DBRC sets the CHECKPOINT TYPES bit values and also sets the Y or N
values. Y is set if at least one checkpoint of the given type starts on the data
set. There could be more than one checkpoint on the log and there is no
guarantee that there is a complete checkpoint on the log. The number of
checkpoints listed on the CHECKPOINT TYPES line might not be the same
number that is listed as the CKPTCT value. For example, there could be
three simple checkpoints on a log. Only SIMPLE=Y would be displayed and
CKPTCT or #DS CHECKPOINTS would have a value of two. CKPTCT or
#DS CHECKPOINTS would have a value of two because that is the
maximum allowed.
Table 51. Fields Present in the DBDS (non-Fast Path) Record (continued)
Record Type Line Number Field Contents
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.
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= ON Indicates that DBRC recommends an image
copy of the DBDS should be taken before using
the database.
11 RECOV NEEDED= ON | OFF Indicates whether the DBDS needs to be
recovered.
12 RECEIVE NEEDED = Indicates whether an image copy of this DBDS
ON | OFF 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 ELEMENTS: Heading for the following list of extended error
-EQERBA-EEQE TYPE-SSID- queue elements (lines 14-nnn).
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).
Table 52. Fields Present in the DBDS (Fast Path) Record (continued)
Record Type Line 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 DSORG= The database and data set organization, as
dsetorg 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 USID= n This only applies to shadow areas at 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 data sets,
IC USED= nnnn 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.
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 | NOPREOPEN Indicates whether the area is opened at control
region initialization or when the area is started.
PRELOAD | NOPRELOAD Indicates whether the VSO area is loaded into
the data space the next time it is opened.
Table 52. Fields Present in the DBDS (Fast Path) Record (continued)
Record Type Line Number Field Contents
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.
| MAS | NOMAS Indicates whether (or not) the area is to reside
in a multi-area coupling facility structure.
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 DBRCVGRP=rcvgrpnm The name of the recovery group to which this
DBDS belongs, if any. Otherwise, **NULL** is
printed.
12 FLAGS: COUNTERS: This heading line is printed for lines 11 through
19 describing the status of this area.
13 PROHIBIT AUTHORIZATION= The value of this flag is OFF if the area is
ON | OFF available for authorization processing.
AUTHORIZED SUBSYSTEMS= The count of subsystems that have current
n authorization to this area.
14 HELD AUTHORIZATION This is the state derived by the database
STATE= n 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.
15 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.
16 IC RECOMMENDED= ON Indicates that DBRC recommends an image
copy of the area should be taken before it is
used.
17 RECOV NEEDED= ON | OFF Indicates whether the areas associated with the
DEDB should be recovered.
Table 52. Fields Present in the DBDS (Fast Path) Record (continued)
Record Type Line Number Field Contents
REGISTERED ADS #= n Indicates how many area data sets for this area
are registered in RECON.
18 DATABASE LEVEL TRACK = Indicates the level of tracking for the area. YES
YES | NO 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.
19 RECEIVE NEEDED = Indicates whether an image copy of this area
ON | OFF needs to be received at the tracking site. This
indicator is only applicable in an RSR
environment at the RSR tracking site.
20 OFR REQUIRED= YES | NO Indicates whether online forward recovery is
required for this shadow area.
21 TRACKING SUSPENDED= YES Indicates whether tracking has been suspended
| NO for this shadow area.
22 HSSP CIC IN PROGRESS= YES Indicates whether an HSSP concurrent image
| NO copy is in progress.
The following lines, 23 through 25, are printed only if one or more error queue elements exist.
23 ERROR QUEUE ELEMENTS: Heading for the following list of error queue
24 -EQERBA-EEQE TYPE-SSID- elements.
25-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 26 through 28 list those area data sets that
are currently registered in this area record:
26 ADS LIST: -ADS DDN- -ADS These lines, 26 through 28, represent the column
27 DSN- -STAT- CREATE headings for the following line 29.
28 -RUNNING-
The following line (29) is repeated for each area data set that is registered for this area.
29-nn adsddn adsdsn AVAIL indicates that the area data set is
AVAIL | UNAVAIL available. UNAVAIL indicates that the area data
YES | NO 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 SUBSYSTEM Lines nn+1 through nn+3 represent the column
nn+3 INFORMATION -SSID- headings for the following 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.
Table 52. Fields Present in the DBDS (Fast Path) Record (continued)
Record Type Line Number Field Contents
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.
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:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 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.
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.
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.
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.
COPYRIGHT LICENSE:
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
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies.
A current list of IBM trademarks is available on the Web in the topic “Copyright
and trademark information” at http://www.ibm.com/legal/copytrade.shtml.
Notices 571
572 DBRC Guide and Reference
Bibliography
This bibliography includes all the publications Title Acronym Order
cited in this book, including the publications in number
the IMS library. IMS Version 9: Command CR SC18-7814
v CICS Transaction System for z/OS CICS Supplied Reference
Transaction, SC34-5992 IMS Version 9: Common Queue CQS SC18-7815
Server Guide and Reference
v CICS Transaction System for z/OS IMS Database
IMS Version 9: Common CSL SC18-7816
Control Guide, SC34-6010 Service Layer Guide and
v DFSMS/MVS V1R5 MDFSMSdfp Advanced Reference
Services, SC26-4921 IMS Version 9: Customization CG SC18-7817
v High Level Assembler for MVS & VM & VSE Guide
Language Reference, SC26-4940 IMS Version 9: Database DBRC SC18-7818
Recovery Control (DBRC)
v High Level Assembler for MVS & VM & VSE Guide and Reference
Programmer’s Guide, SC26-4941 IMS Version 9: Diagnosis DGR LY37-3203
v z/OS MVS Planning: Global Resource Serialization, Guide and Reference
GC28-1759 IMS Version 9: Failure Analysis FAST LY37-3204
Structure Tables (FAST) for
v z/OS MVS Programming: Authorized Assembler
Dump Analysis
Services Reference, GC28-1763
IMS Version 9: IMS Connect CT SC18-9287
v z/OS DFSMS Access Method Services for Guide and Reference
Integrated Catalog Facility IMS Version 9: IMS Java Guide JGR SC18-7821
v z/OS V1R3 MVS Programming : Assembler and Reference
Services, Volume 1, SA22-7606 IMS Version 9: Installation IIV GC18-7822
Volume 1: Installation
v z/OS V1R3 MVS Programming : Assembler
Verification
Services, Volume 2, SA22-7607
IMS Version 9: Installation ISDT GC18-7823
Volume 2: System Definition
IMS Version 9 Library and Tailoring
IMS Version 9: Master Index MIG SC18-7826
Title Acronym Order and Glossary
number IMS Version 9: Messages and MC1 GC18-7827
IMS Version 9: Administration ADB SC18-7806 Codes, Volume 1
Guide: Database Manager IMS Version 9: Messages and MC2 GC18-7828
IMS Version 9: Administration AS SC18-7807 Codes, Volume 2
Guide: System IMS Version 9: Open OTMA SC18-7829
IMS Version 9: Administration ATM SC18-7808 Transaction Manager Access
Guide: Transaction Manager Guide and Reference
IMS Version 9: Application APDB SC18-7809 IMS Version 9: Operations OG SC18-7830
Programming: Database Guide
Manager IMS Version 9: Release RPG GC17-7831
IMS Version 9: Application APDG SC18-7810 Planning Guide
Programming: Design Guide IMS Version 9: Summary of SOC SC18-7832
IMS Version 9: Application APCICS SC18-7811 Operator Commands
Programming: EXEC DLI IMS Version 9: Utilities URDBTM SC18-7833
Commands for CICS and IMS Reference: Database and
IMS Version 9: Application APTM SC18-7812 Transaction Manager
Programming: Transaction IMS Version 9: Utilities URS SC18-7834
Manager Reference: System
IMS Version 9: Base Primitive BPE SC18-7813
Environment Guide and
Reference
Publication Collections
Title Format
Order
number
IMS Version 9 Softcopy Library CD LK3T-7213
IMS Favorites CD LK3T-7144
Licensed Bill of Forms (LBOF): Hardcopy LBOF-7789
IMS Version 9 Hardcopy and and CD
Softcopy Library
Unlicensed Bill of Forms Hardcopy SBOF-7790
(SBOF): IMS Version 9
Unlicensed Hardcopy Library
OS/390 Collection CD SK2T-6700
z/OS Software Products CD SK3T-4270
Collection
z/OS and Software Products DVD SK3T-4271
DVD Collection
Index 577
data sets (continued) Database Change Accumulation utility Database Change Accumulation utility
M-through-V 50 (DFSUCUM0) (continued) (DFSUCUM0) (continued)
data sharing 16 commands (continued) commands (continued)
assigning a sharing level with CHANGE.SECLOG (for NOTIFY.REORG 332
DBRC 17 RLDS) 191 NOTIFY.SECLOG (for OLDS) 335
batch backout 22 CHANGE.SECLOG (for SLDS and NOTIFY.SECLOG (for RLDS) 338
database integrity 17 TSLDS) 195 NOTIFY.SECLOG (for SLDS) 342
dynamic backout 22 CHANGE.SG 200 NOTIFY.UIC 346
forward recovery 24 CHANGE.SUBSYS 201 RESET.GSG 349
information in the RECON data CHANGE.UIC 202 description 43
set 17 DELETE.ADS 205 execution recorded by DBRC 47
levels of 16 DELETE.ALLOC 206 input 45
block level 16 DELETE.BKOUT 207 subset of log volumes 45
database level 16 DELETE.CA 207 valid log subset with DBRC 47
merging logs 47 DELETE.CAGRP 208 database change accumulation utility JCL
online reorganization 52 DELETE.DB 208 adding information to RECON 312
planning for recovery 21 DELETE.DBDS 209 changing information about a
record 72 DELETE.DBDSGRP 210 run 138
database DELETE.GSG 210 deleting information from
adding information to RECON 332 DELETE.IC 211 RECON 207
allocation record 71 DELETE.LOG (for OLDS) 212 generating a job 225
authorization, changing 114 DELETE.LOG (for RLDS) 212 skeletal JCL 450
backup 35, 43 DELETE.LOG (for SLDS) 212 database data set record 67
commands for 37 DELETE.RECOV 216 Database Image Copy 2 utility
backup copies DELETE.REORG 217 (DFSUDMT0) 37
/DBDUMP command 37 DELETE.SG 217 Database Image Copy utility
changing information 143 DELETE.SUBSYS 218 (DFSUDMP0) 37
data set groups, changing DELETE.UIC 218 adding information to RECON 314
information 159 GENJCL.ARCHIVE 221 creating data sets for future use 39
data set, changing information 152 GENJCL.CA 225 description 35
defining 268 GENJCL.CLOSE 229 execution recorded by DBRC 35
deleting information from GENJCL.IC 233 generating a job 233
RECON 208 GENJCL.OIC 242 maximum number of generations 40
integrity in data sharing 17 GENJCL.RECEIVE 247 nonstandard image copy data sets 43
listing 293 GENJCL.RECOV 251 recovery period 40
making HISAM copies 42 GENJCL.USER 257 reusing image copy data sets 41
making image copies 35 INIT.ADS 263 skeletal JCL 455
open exit 16 INIT.CA 265 database recovery
record 67 INIT.CAGRP 266 Database Image Copy 2 output
database allocation record 71 INIT.DB 268 format 38
Database Change Accumulation INIT.DBDS 271 defining groups 276
utility 44 INIT.DBDSGRP 276 groups 67
Database Change Accumulation utility INIT.GSG 277 database recovery control
(DFSUCUM0) INIT.IC 278 changing information 162
CA group INIT.RECON 284 changing partition information 164
defining 47 INIT.SG 289 data set, creating a backup copy 133
defining for future use 47 LIST.BKOUT 291 Database Recovery Control
reusing 47 LIST.CAGRP 292 See DBRC (Database Recovery
commands LIST.DB 293 Control)
BACKUP.RECON 133 LIST.DBDS 294 Database Recovery Control utility
CHANGE.ADS 135 LIST.DBDSGRP 296 (DSPURX00)
CHANGE.BKOUT 136 LIST.GSG 297 description 27
CHANGE.CA 138 LIST.HISTORY 298 generating a job 251, 257
CHANGE.CAGRP 140 LIST.LOG (for a category of GENJCL.RECOV command 251
CHANGE.DBDSGRP 159 records) 301 overview 27
CHANGE.IC 162 LIST.LOG (for a PRILOG database recovery records 65
CHANGE.PRILOG (for family) 300 database recovery with data sharing
OLDS) 169 LIST.RECON 304 batch 22
CHANGE.PRILOG (for NOTIFY.ALLOC 309 data sharing 24
RLDS) 171 NOTIFY.BKOUT 311 dynamic 22
CHANGE.PRILOG (for NOTIFY.CA 312 forward 24
SLDS) 175 NOTIFY.IC 314 managing system logs 47
CHANGE.PRILOG (for NOTIFY.PRILOG (for OLDS) 317 DB Groups 49
TSLDS) 175 NOTIFY.PRILOG (for RLDS) 321 DB header record
CHANGE.RECON 179 NOTIFY.PRILOG (for SLDS and HALDB 68
CHANGE.SECLOG (for TSLDS) 326 DB partition
OLDS) 189 NOTIFY.RECOV 329 HALDB 69
Index 579
DBRC (Database Recovery Control) DBRC Command Authorization Support DEFLTJCL parameter (continued)
(continued) using both DSPDCAX0 and INIT.CAGRP 267
parameters RACF 80 INIT.DBDS 272
IMS.PROCLIB execution using DSPDCAX0 80 DELEQE parameter CHANGE.DBDS
parameter 19 DBTRACK parameter command 154
partitioned data set members 5 CHANGE.DB command 149 delete group 88
QUERY request CHANGE.DBDS command 158 delete log records, how to 112
BACKOUT 363 DDN parameter commands DELETE parameter commands
RECON data set CHANGE.DBDS 154 CHANGE.BKOUT 137
creating 60 CHANGE.IC 162 CHANGE.CAGRP 141
shared among multiple CHANGE.UIC 203 DELETE.ADS command 205
processors 57 DELETE.ALLOC 206 DELETE.ALLOC command 206
RECON data set, registering databases DELETE.DBDS 209 DELETE.BKOUT command 207
in 20 DELETE.IC 211 DELETE.CA command 207
RECON status query DELETE.RECOV 216 DELETE.CAGRP command 208
output 415 DELETE.REORG 217 DELETE.DB command 208
overview 413 DELETE.UIC 219 DELETE.DBDS command 209
parameters 413 GENJCL.IC 235 DELETE.DBDSGRP command 210
return codes 414 GENJCL.OIC 243 DELETE.GSG command 210
syntax 413 GENJCL.RECEIVE 248 DELETE.IC command 211
RECON, defining recovery GENJCL.RECOV 252 DELETE.LOG (for OLDS) command 212
requirements 11 GENJCL.USER 258 DELETE.LOG (for RLDS) command 212
recording change accumulations 47 INIT.DBDS 272 DELETE.LOG (for SLDS) command 212
recording image copies 35 INIT.IC 278 DELETE.PART command
recovery utilities 14 LIST.DBDS 295 DBD parameter 215
RELBUF query LIST.HISTORY 299 PART parameter 215
overview 423 NOTIFY.ALLOC 310 syntax 215
return codes 424 NOTIFY.IC 315 DELETE.RECOV command 216
syntax 423 NOTIFY.RECOV 330 DELETE.REORG command 217
request time-stamp format 358 NOTIFY.REORG 333 DELETE.SG command 217
share control 16 NOTIFY.UIC 347 DELETE.SUBSYS command 218
SLDS stop time, locating the last in DDNNEW parameter DELETE.UIC command 218
RECON data set 108 CHANGE.DBDS command 155 deleting a SSYS record 113
specifying when it is to be used 19 deadlock, avoiding RECON data set 57 deleting information
STARTDBRC request deallocation, changes to processing 16 all change accumulation group
overview 427 DEALTIME parameter command records 208
parameters 427 NOTIFY.ALLOC 310 all database data set records 209
return codes 428 DEDB Fast Path record 69 all database records 208
syntax 427 default members allocation record of database data
STOPDBRC request See skeletal JCL set 206
overview 431 DEFAULTS parameter commands area data set 205
parameters 431 GENJCL.ARCHIVE 222 backout record 207
syntax 431 GENJCL.CA 226 change accumulation run record 207
SUBSYS query GENJCL.CLOSE 230 database data set group records 210
output 421 GENJCL.IC 237 global service group records 210
overview 417 GENJCL.OIC 243 image copy data set records 211
parameters 418 GENJCL.RECEIVE 248 log records 112
return codes 419 GENJCL.RECOV 252 nonstandard image copy data
syntax 417 GENJCL.USER 258 sets 218
subsystem (SSYS) records 113 DEFINE CLUSTER keywords 60 online log data set records 212
system, considerations for a 33 CONTROLINTERVALSIZE 61 recovery log data set records 212
tailoring JCL 9 CYLINDERS 61 recovery run record 216
time stamp 126 FREESPACE 61 reorganization records 217
tips 107 INDEXED 61 service group records 217
variables 60 KEYS 61 subsystem records 218
when should you use it 5 NAME 61 system log data set records 212
DBRC (Database Recovery Control) NOWRITECHECK 62 deleting unnecessary RECON records 74
commands RECORDSIZE 62 DELMEM parameter,
Database Recovery Control utility SHAREOPTIONS 62 CHANGE.DBDSGRP command 160
(DSPURX00) 4 SPEED 62 DEQ macro 58
DBRC Command Authorization exit defining DFSUARC0 (Log Archive utility)
routine (DSPDCAX0) 80 DB groups 276 description 8
DBRC command authorization DBDS groups 276 DFSUCUM0 (Database Change
support 78 recovery groups 276 Accumulation utility)
using a security product 79 DEFLTJCL parameter See also Database Change
CHANGE.CAGRP 141 Accumulation utility (DFSUCUM0)
CHANGE.DBDS 155
Index 581
GENJCL.CLOSE command (continued) GRPNAME parameter commands ICDSN parameter commands (continued)
TIMEFMT parameter 231 (continued) reusing 41
GENJCL.IC 37 NOTIFY.CA 312 selecting 99
HALDB online reorganization 50 GRS macro 57 ICDSN2 parameter commands
GENJCL.IC command 233 GSG parameter commands CHANGE.IC 163
TIMEFMT parameter 238 CHANGE.PRILOG (for RLDS) 173 DELETE.IC 211
GENJCL.OIC 37 CHANGE.PRILOG (for SLDS) 177 INIT.IC 279
HALDB online reorganization 50 CHANGE.SECLOG (for RLDS) 193 NOTIFY.IC 316
GENJCL.OIC command 242 CHANGE.SECLOG (for SLDS) 197 NOTIFY.REORG 334
TIMEFMT parameter 245 GSGNAME parameter commands ICJCL parameter
GENJCL.RECEIVE command 247 CHANGE.DB 145 commands
TIMEFMT parameter 249 CHANGE.DBDS command 156 CHANGE.DBDS 156
GENJCL.RECOV command 251 GTF (Generalized Trace Facility) USR GENJCL.CA 226
parameters records 187 GENJCL.CLOSE 230
USEAREA 255 GENJCL.IC 237
USEDBDS 255 GENJCL.OIC 244
USEIC 255
USEOLRRG 255
H GENJCL.RECEIVE 248
GENJCL.RECOV 253
HALDB
RESTORE parameter 254 GENJCL.USER 258
DBRC commands supported 49
TIMEFMT parameter 254 INIT.DBDS 272
master (DSPDBHRC)
GENJCL.USER command 257 skeletal JCL execution member 455
DB header record 68
TIMEFMT parameter 259 ICOFF parameter CHANGE.DBDS
OLR coexistence support 51
GENMAX parameter command 156
partition 69
image copy data sets for future ICON parameter CHANGE.DBDS
partition DB record (DSPDBHRC) 69
use 39 command 156
partition DBDS records
of the INIT.DBDS command 272 ICRCVJCL parameter skeletal JCL
(DSPDSHRC) 69
resetting 109 execution member 463
partition record (DSPPTNRC)
specifying image copy ICREQ parameter CHANGE.DB
PHDAM 69
requirements 40 command 146
types of DBDSs 69
Global Resource Serialization macro 57 ICREQ parameter INIT.DB
HALDB partition
global service group command 269
registering 280
deleting information 210 ILDS (Indirect List Data Set) 48
header record, RECON data set 64
listing 297 Index/ILDS Rebuild Utility
hints and tips
record 70 (DFSPREC0) 14
using DBRC 107
resetting 349 image copies
adjusting GENMAX when it is
GROUP parameter commands 234 fuzzy 36
reached or is too high 109
GENJCL.IC 234 image copy 2 JCL 455
locating the last SLDS Stop Time in
GENJCL.OIC 242 image copy data set
RECON 108
GENJCL.RECEIVE 247 recovery period 40
PRILOG compression not
GENJCL.RECOV 252 Image Copy Group record 70
working 110
GENJCL.USER 257 Image Copy utility
PRILOG record sizes 111
LIST.DBDS 295 See also Database Image Copy utility
HISAM Reorganization Unload utility
LIST.HISTORY 298 (DFSUDMP0)
(DFSURUL0)
GROUP query See Online Database Image Copy
for backup 42
output 393 utility (DFSUICP0)
HISTORY command 298
overview 390 IMS recovery utilities 14
HSSP data set 42
parameters 390 IMS Structured Call Interface (SCI) 78
database registered with DBRC 42
return codes 392 IMS.PROCLIB 5
syntax 390 IMS.SDFSISRC 5
GRPMAX parameter commands IMSCTRL macro
CHANGE.CAGRP 141 I archiving OLDS 9
INIT.CAGRP 266 ICDSN parameter commands parameters 19
GRPMEM parameter INIT.CAGRP CHANGE.IC 163 IMSplex
command 266 creating for future use 39 use of DSPAPI 359
GRPNAME parameter commands defining 278 IMSPLEX
CHANGE.CA 139 duplicate, naming convention 34 CHANGE.RECON 183
CHANGE.CAGRP 141 INIT.IC 278 DSPSCIX0 184
CHANGE.DBDSGRP 160 maximum number of generations 40 IMSplex, DBRC support of 18
DELETE.CA 207 naming convention 34 INACTIVE parameter DELETE.LOG (for
DELETE.CAGRP 208 nonstandard 43 RLDS and SLDS) command 213
DELETE.DBDSGRP 210 NOTIFY.IC 315 Index/ILDS Rebuild utility
GENJCL.CA 226 NOTIFY.REORG 334 (DFSPREC0) 14
INIT.CA 265 RECON INDEXED keyword
INIT.CAGRP 267 adding information 329 DEFINE CLUSTER keywords 61
INIT.DBDSGRP 276 changing information 162 INIT.ADS command
LIST.CAGRP 292 record 70 description 263
LIST.DBDSGRP 296 recovery period 40 INIT.CA command 265
Index 583
logging (continued) NEWTIME parameter commands nonstandard image copy data sets
condensing logs using (continued) (continued)
DFSUCUM0 43 CHANGE.SECLOG (for SLDS) 197 RECON
LOGRET parameter NEWVOL parameter commands adding information 346
INIT.RECON 287 CHANGE.PRILOG (for RLDS) 173 changing information 202
LOGRET parameter of CHANGE.PRILOG (for SLDS) 177 deleting information 218
CHANGE.RECON 185 CHANGE.SECLOG (for RLDS) 193 NOOWNER parameter 149
LSR (Local Shared Resources option) 61 CHANGE.SECLOG (for SLDS) 197 NOPREL parameter CHANGE.DBDS
NOAUTH parameter command 157
CHANGE.DB 145 NOPREO parameter CHANGE.DBDS
M CHANGE.DBDS 155
NOBACK parameter CHANGE.DB
command 158
NORECOV parameter
macro
command 146 NOTIFY.REORG 334
DEQ 58
NOBACKUP parameter NORECOV parameter CHANGE.DBDS
DFP Record Management Services 58
CHANGE.SUBSYS command 201 command 158
DSPAPI
NOCATDS NOREORGI parameter
accessing 357
CHANGE.RECON 180 CHANGE.DB 151
forms 356
NOCATDS parameter commands NOREUSE parameter
overview 353
CHANGE.RECON 179 CA data set 47
versions 356
INIT.RECON 285 CHANGE.DBDS 156
GRS 57
NOCFSTR2 parameter CHANGE.DBDS command
IMSCTRL 9
command 155 CHANGE.CAGRP 142
OBTAIN 58
NOCHECK parameter image copy data sets for future
RESERVE 57
CHANGE.RECON 184 use 39
maximum number of generations, image
INIT.RECON 286 INIT.CAGRP 267
copy data sets, GENMAX
NODEFLT parameter commands INIT.DBDS 273
parameter 155, 272
CHANGE.CAGRP 141 NORMAL parameter commands
MAXOLDS parameter
GENJCL.CA 227 CHANGE.PRILOG (for OLDS) 170
GENJCL.ARCHIVE command 223
GENJCL.IC 238 CHANGE.PRILOG (for RLDS) 172
MEMBER parameter
GENJCL.OIC 244 CHANGE.PRILOG (for SLDS) 177
GENJCL.ARCHIVE command 223
GENJCL.RECOV 254 CHANGE.SECLOG (for OLDS) 190
GENJCL.CA 227
GENJCL.USER 259 CHANGE.SECLOG (for RLDS) 192
GENJCL.CLOSE 231
NOFORCER parameter commands CHANGE.SECLOG (for SLDS) 197
GENJCL.IC 237
CHANGE.RECON 183 CHANGE.SUBSYS 201
GENJCL.OIC 244
INIT.RECON 286 NOTIFY.SUBSYS 346
GENJCL.RECEIVE 249
NOICREQ parameter CHANGE.DB normal restart 24
GENJCL.RECOV 253
command 146 NOTCOVER parameter
GENJCL.USER 257
NOICREQ parameter INIT.DB CHANGE.DB command 145
INIT.DBDSGRP 276
command 269 CHANGE.DBDS command 156
members
NOJOB parameter commands nothing to process, when change
See skeletal JCL
GENJCL.ARCHIVE 222 accumulation says 114
merging logs 47
GENJCL.CA 226 NOTIFY.ALLOC command 309
MULTIJOB parameter commands
GENJCL.CLOSE 230 NOTIFY.BKOUT command 311
GENJCL.IC 237
GENJCL.IC 237 NOTIFY.CA command 312
GENJCL.OIC 244
GENJCL.OIC 244 NOTIFY.IC command
GENJCL.RECOV 253
GENJCL.RECEIVE 248 HALDB considerations 50
GENJCL.USER 259
GENJCL.RECOV 253 NOTIFY.PRILOG (for OLDS)
multiple
GENJCL.USER 258 command 317
cold starts in a test environment 116
NOLIST parameter commands NOTIFY.PRILOG (for RLDS)
GENJCL.ARCHIVE 223 command 321
GENJCL.CA 226 NOTIFY.PRILOG (for SLDS and TSLDS)
N GENJCL.CLOSE 231 command 326
NAME keyword GENJCL.IC 237 NOTIFY.RECOV command 329
DEFINE CLUSTER keywords 61 GENJCL.OIC 244 NOTIFY.REORG command 332
naming conventions GENJCL.RECEIVE 249 NOTIFY.SECLOG (for OLDS)
change accumulation data sets 34 GENJCL.RECOV 253 command 335
DBRC data sets 33 GENJCL.USER 258 NOTIFY.SECLOG (for RLDS)
duplicate image copy data sets 34 NOLKASID parameter command 338
image copy data sets 34 CHANGE.DBDS command 157, 275 NOTIFY.SECLOG (for SLDS)
SSIDs in RECON SSYS records, NONEW parameter commands 288 command 342
for 113 CHANGE.RECON 186 NOTIFY.SUBSYS command 345
SSIDs processed by batch backout, INIT.RECON 288 NOTIFY.UIC command
for 113 NONRECOV parameter, description 346
NEWTIME parameter commands CHANGE.DB 147 HALDB considerations 50
CHANGE.PRILOG (for RLDS) 173 nonstandard image copy data sets notifying DBRC that log data sets have
CHANGE.PRILOG (for SLDS) 177 description 43 moved 115
CHANGE.SECLOG (for RLDS) 193 NOVSO parameter 159
Index 585
R RECON I/O exit routine 81
RECON initialization token (RIT) 16
recovery (continued)
DBRC 33
RCVTIME parameter RECON Loss Notification 78 defining groups 276
GENJCL.RECOV 254 RECON record types 63 description 77
NOTIFY.RECOV 331 RECON status query groups 67
RCVTRACK parameter output 415 in data sharing
CHANGE.DB command 149 overview 413 planning procedures 21
CHANGE.DBDS command 158 parameters 413 without DBRC 24
READOFF parameter CHANGE.DB return codes 414 log data set
command 149 syntax 413 deleting information 212
READON parameter CHANGE.DB RECON1 parameter, BACKUP.RECON log data set, adding information to
command 149 command 133 RECON 321, 338
RECDCT parameter commands record log information 7 maintaining records 52
CHANGE.IC 163 record type parameter 89 overview 3
NOTIFY.IC 317 records period, of image copy data sets 40
NOTIFY.REORG 334 BACKOUT 66 point-in-time 11
RECON change accumulation group 66 process overview 10
allocation 55 change accumulation run 66 RECON data set 76
DSECTS 473 data sharing 72 record 72
initialization 56 database 67 time stamp 11
sample listing 473 database allocation 71 recovery control
RECON data set database data set 67 data set
accessing with DSPAPI 358 database data set group 67 commands to generate JCL and
active 62 database recovery 65 user-defined output 83
ALLOC record 71 DBDS group 67 listing 304
availability 56 DEDB 69 recovery control data set
backup 73 deleting unnecessary 73 See also RECON
changing log control records 8 global service group 70 I/O error processing 75
concurrent image copy data set 39 HALDB online reorganization 50 records 63
contention problems 56 image copy 70 replacing discarded RECON 77
creating 60 in RECON data set 63 recovery functions for DBDSs 7
data sharing record types 72 log allocation 71 recovery log data set
data-sharing records 17 log data set 64 See RLDS (recovery log data set)
Database Image Copy 2 data set 37 maintaining RECON 73 recovery log data set (RLDS)
defining 55 online reorganization 50 records 64
defining requirements in 11 RECON data set header 64 recovery period, definition of 40
description 55 recovery 72 recovery records, database 65
dynamic allocation 60 reorganization 71 recovery utilities 14
enqueue problems, causes of 117 subsystem 72 RECOVJCL parameter
extending 60 RECORDSIZE keyword commands
header records 64 DEFINE CLUSTER keywords 62 CHANGE.DBDS 158
HSSP image copy data set 42 RECOV parameter INIT.DBDS 273
initial access 62 NOTIFY.REORG 334 skeletal JCL execution member 465
LOGALL record 71 RECOVABL parameter RECOVPD parameter 40
maintaining 72 CHANGE.DB 147 INIT.DBDS 274
maintaining records 73 INIT.DB 269 RECOVPD parameter commands
overview 55 RECOVER commands 14 CHANGE.DBDS 159
preserving integrity of 78 recoverable databases INIT.DBDS 274
records, maintaining 73 CHANGE.DB command 36 RECTIME parameter commands
recovering 76 Image Copy utilities 36 CHANGE.CA 139
recovery record types 65 INIT.DB command 36 CHANGE.IC 162
registering databases 20 recovering a database CHANGE.UIC 203
REORG record 71 archiving log records 9 DELETE.ALLOC 206
reorganizing 74 batch support 22 DELETE.CA 208
replacing a discarded 77 DBRC role 12 DELETE.IC 211
replacing damaged 75 dynamic backout 22 DELETE.RECOV 216
retrieving log-related information process 12 DELETE.REORG 217
from 9 recovery facilities 22 DELETE.UIC 219
security considerations 62 setting up recovery mechanisms 21 RECVJCL parameter CHANGE.DBDS
serialization 57 without DBRC 24 command 159
shared among multiple processors 57 Recovering the RECON registering databases in the RECON data
spare 62 RECON Loss Notification 78 set 20
subsystem (SSYS) record 72 recovery RELBUF query
tracking changes to 81 CHANGE.DBDS 158 overview 423
upgrading 27 concepts 10 RELBUF request
version migration 27 database data set or area, adding parameters 423
VSAM CREATE mode 60 information to RECON 329 return codes 424
RECON data sets, both are unusable 76
Index 587
SSID parameter commands (continued) subsystem (SSYS) record (continued) symbolic keywords (continued)
NOTIFY.PRILOG (for SLDS and initializing during IMS restart 72 JCL execution member (continued)
TSLDS) 329 size calculation 114 %OLDSDSN 95
NOTIFY.SECLOG (for OLDS) 337 working with 113 %OLDSSEL 95
NOTIFY.SECLOG (for RLDS) 341 symbolic keywords %OLDSTYP 95
NOTIFY.SECLOG (for SLDS) 344 See also symbolic keywords, JCL %PLGTIME 102
NOTIFY.SUBSYS 345 execution member %SLDETIM 96
standard form of time stamps, parameters control keywords 86 %SLDFRID 96
of DBRC commands 126 %DELETE 88, 91 %SLDFSEQ 96
START command %ENDDEL 88, 91 %SLDLRID 96
use of 17, 251 %ENDSEL 88 %SLDRMT 96
STARTDBRC request %SELECT 88, 94 %SLDSDDN 96
overview 427 %SET MEMBER 88, 92 %SLDSSEL 96
parameters 427 %SET TIMEFMT 88, 93 %SLDSTIM 96
return codes 428 description 85, 88, 103 %SLDUNIT 96
syntax 427 JCL execution member %SLDVOLS 96
STARTIME parameter commands %ALLSEL 102 %SSID 87
CHANGE.PRILOG (for RLDS) 172 %ALLTIME 102 %TIME 87
CHANGE.PRILOG (for SLDS) 176 %ALLUSID 102 symbolic keywords 86, 102
CHANGE.SECLOG (for RLDS) 191 %CADSN 101 recognized by DBRC 435
CHANGE.SECLOG (for SLDS) 196 %CAFSEQ 101 user-defined 87
DELETE.LOG (for RLDS and %CALGTM 101 symbolic keywords, JCL execution
SLDS) 213 %CAODSN 92 member
NOTIFY.ALLOC 310 %CASEL 101 substitution 83
NOTIFY.PRILOG (for OLDS) 318 %CATIME 101 symbolic keywords
NOTIFY.PRILOG (for RLDS) 322 %CAUNIT 101 %SLDCHKT 97
NOTIFY.PRILOG (for SLDS and %CAVCNT 101 syntax diagram
TSLDS) 327 %CAVOLS 101 how to read 124
NOTIFY.SECLOG (for OLDS) 336 %DALTIME 102 syntax, DBRC command 122
NOTIFY.SECLOG (for RLDS) 339 %DBADDN 103 system log data set
NOTIFY.SECLOG (for SLDS) 343 %DBADSAV 103 See SLDS (system log data set)
STARTNEW parameter %DBDDN 102, 103 system log data set (SLDS)
commands 186 %DBDSDEL 103 records 64
CHANGE.RECON 186 %DBDSN 103 system log management, with data
INIT.RECON 288 %DBDSNRV 103 sharing 47
usage 76 %DBNAME 102, 103 system logs, with data sharing 47
STARTRCV parameter commands %DBTYPE 103
CHANGE.SUBSYS 202 %DBUSID 103
NOTIFY.SUBSYS 346
STATUS parameter LIST.RECON
%DDNAME 89
%ICCAT 100
T
TAPEUNIT parameter commands
command 305 %ICDSN 99
CHANGE.RECON 186
STOPDBRC request %ICFSEQ 100
INIT.RECON 289
overview 431 %ICSEL 100
tasks of DBRC 4
parameters 431 %ICSTOP 100
time qualifier 90
syntax 431 %ICTIME 100
time stamp 126
STOPTIME 334 %ICTYPE 99
conversions and examples 130
STOPTIME parameter commands %ICUNIT 100
DBRC commands affected by
CHANGE.IC 164 %ICUSID 100
format 131
NOTIFY.CA 312 %ICVCNT 100
format for DBRC requests 358
NOTIFY.IC 317 %ICVOLS 100
recovery 11
SUBSET parameter commands %LOGDSN 98
specifying zero values 130
CHANGE.CA 140 %LOGETIM 99
standard default settings for
NOTIFY.CA 314 %LOGFRID 99
values 131
SUBSYS query %LOGFSEQ 98
standard format 126
output 421 %LOGLRID 99
TIMEFMT parameter 127
overview 417 %LOGMERG 99
two-digit year input 130
parameters 418 %LOGONL 99
TIMEFMT parameter
return codes 419 %LOGRMT 99
GENJCL.ARCHIVE 223
syntax 417 %LOGSEL 99
GENJCL.CA 227
subsystem %LOGSTIM 98
GENJCL.CLOSE 231
changing information 201 %LOGUNIT 98
GENJCL.IC 238
listing 306 %LOGVOLS 98
GENJCL.OIC 245
RECON 218 %OLDCTIM 95
GENJCL.RECEIVE 249
adding information 345 %OLDFRID 95
GENJCL.RECOV 254
deleting information 218 %OLDLRID 95
GENJCL.USER 259
subsystem (SSYS) record %OLDOTIM 95
TIMEFMT parameter sublist
deleting a 113 %OLDSDDN 95
CHANGE.RECON 188
Index 589
590 DBRC Guide and Reference
Printed in USA
SC18-7818-03
Spine information: