Issuing DBRC commands

With DBCTL, you must issue DBRC commands by using DBCTL console commands (/RMxxxxxx) because DBRC runs outside the CICS® address space. You can issue the /RMxxxxxx commands by using the CICS-supplied transaction CDBM.

You can use the following /RMxxxxxx commands online:
  • /RMCHANGE: to change or modify information in the RECON
  • /RMDELETE: to delete information from the RECON
  • /RMGENJCL: to generate JCL for a specified utility
  • /RMINIT: to create records in the RECON
  • /RMLIST: to list the contents of the RECON
  • /RMNOTIFY: to add information to the RECON.
For example:
/RMINIT DBRC='DB DBD(IVPDB2) SHARELVL(3)'.
See Operations and automation in IMS product documentation for further guidance on the syntax of these commands.

You can also enter DBRC commands in batch, but the syntax is slightly different, as shown in Figure 1.

Figure 1. Example JCL to register a database with DBRC
//INITDB JOB 1,PGMERID,CLASS=Q,MSGCLASS=A
//*
//RECON    EXEC PGM=DSPURX00,REGION=1000K
//STEPLIB  DD DSN=IMS.RESLIB,DISP=SHR
//DFSRESLB DD DSN=IMS.RESLIB,DISP=SHR
//SYSPRINT DD SYSOUT=*
//RECON1   DD DSN=IMS.RECON1,DISP=SHR
//RECON2   DD DSN=IMS.RECON2,DISP=SHR
//SYSIN    DD *
 INIT.DB DBD(IVPDB2) SHARELVL(3)
/*