DBRC commands and API requests

DBRC commands

Use DBRC commands to generate a listing of the information in the RECON data set; add to, change, and delete information in the RECON data set, and generate the JCL and the control statements necessary to run the IMS utilities that are used in database recovery.

The following is a list of the DBRC batch commands, along with information about how they are used:

• Use the BACKUP.RECON command to create a backup copy of the RECON data set.
• Use the CLEANUP.RECON command to delete old or expired recovery-related information and log information from the RECON data set.
• Use the CHANGE commands to modify information in the RECON data set.
• Use the DELETE commands to delete information from the RECON data set.
• Use the GENJCL commands to generate jobs for the various IMS recovery utilities.
• Use the INIT commands to make the following changes to a RECON data set:
  • Create DB groups
  • Create DBDS groups
  • Create recovery groups
  • Register databases
  • Create image copy records that are available for use during subsequent runs of the supported image copy utilities
  • Create change accumulation data sets that are available for future use by the Change Accumulation utility
  • Create entries that defines an area data set (ADS) that belongs to a Fast Path area
  • Create CA groups
  • Register DBDSs or DEDB areas
  • Register HALDB partitions
  • Initialize a RECON data set
• Use the LIST commands to produce a formatted printout of all or selected parts of the RECON data set.
• Use the NOTIFY commands to add to the RECON data set information that is normally written there automatically.

You can issue DBRC commands by embedding them in the JCL for running the Database Recovery Control utility (DSPURX00). This utility can process these commands while running either in a batch environment or as a TSO foreground program.

You can also issue the DBRC commands (with the exception of the LIST commands) as a parameter of the COMMAND API request (see IMS Version 15.5 Commands, Volume 3: IMS Component and z/OS® Commands).

Certain DBRC commands can be issued from an online IMS environment (/RMxxxxxx commands). The online DBRC commands are:

• /RMCHANGE
• /RMDELETE
• /RMGENJCL
• /RMINIT
• /RMLIST
• /RMNOTIFY

DBRC API requests

Use the DBRC API requests to obtain services from DBRC.

Related reading: For detailed information about the DBRC application programming interface and the DBRC API requests, see IMS Version 15.5 System Programming APIs.