>>-+-+-/RMCHANGE-+-+--+------------------+----------------------> | '-/RMC------' | '-LTERM--ltermname-' +-+-/RMDELETE-+-+ | '-/RMD------' | +-+-/RMGENJCL-+-+ | '-/RMG------' | +-+-/RMINIT-+---+ | '-/RMI----' | +-+-/RMLIST-+---+ | '-/RML----' | '-+-/RMNOTIFY-+-' '-/RMN------' >--DBRC='modifier parameter-set'-------------------------------><
Table 143 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keyword can be issued.
Command / Keyword | DB/DC | DBCTL | DCCTL |
---|---|---|---|
/RMxxxxxx | X | X | X |
LTERM | X | X |
The /RMxxxxxx commands are multisegment commands that call functions of IMS Database Recovery Control (DBRC). These commands allow the IMS master terminal operator or an authorized terminal operator to run certain DBRC utility functions online. Output is limited to what can be put in a 4 KB buffer (8 KB for /RMLIST).
All /RMxxxxxx formats require an EOM indication to denote end-of-message. An EOS indication must be included for all segments, if any, that precede the last segment. See Multisegment Command Input for more detail on using EOS and EOM. If comments are included with the /RMxxxxxx commands, they must be enclosed in asterisks.
|If a failure other than the loss of both RECON data |sets occurs while DBRC is processing an online command, DBRC makes |the command unavailable for the remaining time the IMS online region |is running. (After determining and correcting the cause of the original |failure, the command can be made available again by resubmitting |the online command with the RESET parameter specified in the parameter |set.) It is the verb, rather than the modifier, |level of the command that DBRC makes unavailable. That is, if a |DBRC INIT.DB command fails, DBRC makes all INIT commands unavailable. DBRC sends an error message to the |originating terminal when the command fails. You can still issue |the failing command from other IMS online regions.
Exception: DBRC does not make GENJCL commands unavailable because the GENJCL.ARCHIVE command is needed for automatic archiving.
DBRC does not remember command failures across IMS restarts because it assumes that you will correct the error before restarting IMS.
Table 144 lists the DBRC commands that are supported online and describes the utility function of each command.
Command | Utility Function |
---|---|
/RMCHANGE | Changes or modifies information in the RECON data set |
/RMDELETE | Deletes information in the RECON data set |
/RMGENJCL | Generates JCL for:
|
/RMINIT | Creates records in the DBRC RECON data set |
/RMLIST | Lists information contained in the RECON data set |
/RMNOTIFY | Adds information to the RECON data set |
Recommendation: Because some of the DBRC commands generate a large amount of output, especially the /RMGENJCL and /RMLIST commands, direct the output to a printer.
Table 145 lists the DBRC modifiers and the /RMxxxxxx commands with which the modifiers can be issued.
Modifier | CHANGE | DELETE | GENJCL | INIT | LIST | NOTIFY |
---|---|---|---|---|---|---|
ADS | X | X | X | |||
ALLOC | X | X | ||||
ARCHIVE | X | |||||
BKOUT | X | X | X | X | ||
CA | X | X | X | X | X | |
CAGRP | X | X | X | X | ||
CLOSE | X | |||||
DB | X | X | X | X | ||
DBDS | X | X | X | X | ||
DBDSGRP | X | X | X | X | ||
GSG | X | X | X | |||
HISTORY | X | |||||
IC | X | X | X | X | X | |
LOG | X | X | ||||
OIC | X | |||||
PART | X | |||||
PRILOG | X | X | ||||
RECON | X | X | X | |||
RECOV | X | X | X | |||
REORG | X | X | ||||
SECLOG | X | X | ||||
SG | X | X | X | |||
SUBSYS | X | X | X | X | ||
UIC | X | X | X | |||
USER | X |
Entry ET (with comments):
/RMCHANGE DBRC='DB DBD(DIVNTZ04) SHARELVL(3)'. *COMMENT*.
Response ET:
CHANGE.DB DBD(DIVNTZ04) SHARELVL(3) DSP0203I COMMAND COMPLETED WITH CONDITION CODE 00 DSP0220I COMMAND COMPLETION TIME DSP0211I COMMAND PROCESSING COMPLETE DSP0211I HIGHEST CONDITION CODE = 00 DSP0058I RMC COMMAND COMPLETED
Entry ET:
/RMCHANGE DBRC='DBDS DBD(DIVNTZ04) DDN(DBHVSAM1) ICON'.
Response ET:
CHANGE.DBDS DBD(DIVNTZ04) DDN(DIVNTZ04) ICON DSP0203I COMMAND COMPLETED WITH CONDITION CODE 00 DSP0220I COMMAND COMPLETION TIME DSP0211I COMMAND PROCESSING COMPLETE DSP0211I HIGHEST CONDITION CODE = 00 DSP0058I RMC COMMAND COMPLETED
Entry ET:
/RMC DBRC='DBDS DBD(DEDBJN21) AREA(DB21AR7) VSO PREOPEN'.
Response ET:
DFS000I CHANGE.DBDS DBD(DEDBJN21) AREA(DB21AR7) VSO PREOPEN DFS000I DSP0203I COMMAND COMPLETED WITH CONDITION CODE 00
Entry ET (with comments):
/RMDELETE DBRC='DB DBD(DIVNTZ04)'. *COMMENT*.
Response ET:
DELETE.DB DBD(DIVNTZ04) DSP0203I COMMAND COMPLETED WITH CONDITION CODE 00 DSP0220I COMMAND COMPLETION TIME DSP0211I COMMAND PROCESSING COMPLETE DSP0211I HIGHEST CONDITION CODE = 00 DSP0058I RMD COMMAND COMPLETED
Entry ET (with comments):
/RMGENJCL LTERM SMITH DBRC='IC DBD(HDAMVSAM) DDN(DD1) LIST'. *END OF DAY MESSAGE*.
Response ET:
DSP058I RMG COMMAND COMPLETED
Response LTERM SMITH:
GENJCL.IC DBD(HDAMVSAM) DDN(DD1) //IC135607 JOB //IC EXEC PGM=DFSRRC00,PARM='ULU,DFSUDMP0',REGION=800K //* //* THIS JCL ORIGINATES FROM THE USER'S 'JCLPDS' LIBRARY. //* %KEYWORDS ARE REPLACED BY THE GENJCL FUNCTION OF //* THE IMS DATABASE RECOVERY CONTROL FEATURE. //* //* JCL FOR IMAGE COPY. //* //SYSPRINT DD SYSOUT=A //RECON1 DD DSN=POCONO1,DISP=SHR //RECON2 DD DSN=POCONO2,DISP=SHR //IMS DD DSN=IMS.DBDLIB,DISP=SHR //DD1 DD DSN=HDAMVASM,DCB=BUFNO=10,DISP=OLD //DATAOUT1 DD DSN=IMS.HDAMVSAM.DD1.IC.ICDD1,UNIT=3400, // VOL=(PRIVATE,,,1,SER=(******)), // LABEL=(1,SL), // DISP=(NEW,KEEP),DCB=BUFNO=10 //DFSVSAMP DD * 1024,2 4096,4 //SYSIN DD * D1 HDAMVSAM DD1 DATAOUT1 DSP0203I COMMAND COMPLETED WITH CONDITION CODE 00 DSP0220I COMMAND COMPLETION TIME DSP0211I COMMAND PROCESSING COMPLETE DSP0211I HIGHEST CONDITION CODE = 00 DSP0058I RMG COMMAND COMPLETED
Entry ET (with comments):
/RMINIT DBRC='DB DBD(DIVNTZ04) SHARELVL(3)'. *COMMENT*.
Response ET:
INIT.DB DBD(DIVNTZ04) SHARELVL(3) DSP0203I COMMAND COMPLETED WITH CONDITION CODE 00 DSP0220I COMMAND COMPLETION TIME DSP0211I COMMAND PROCESSING COMPLETE DSP0211I HIGHEST CONDITION CODE = 00 DSP0058I RMI COMMAND COMPLETED
Entry ET (with comments):
/RMLIST DBRC='DB DBD(DIVNTZ04)'. *LAST COMMENT*.
Response ET:
LIST.DB DBD(DIVNTZ04) RECON1 DSN=RECONH1 ------------------------------------------------------------------------------ DB DBD=DINNTZ04 IRLM=*NULL DMB#=769 TYPE=IMS SHARE LEVEL=0 FLAGS: COUNTERS: BACKOUT NEEDED=OFF RECOVERY NEEDED COUNT=0 READ ONLY=OFF IMAGE COPY NEEDED COUNT=1 PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS=0 RECOVERABLE=YES HELD AUTHORIZATION STATE=0 EEQE COUNT=0 DSP0180I NUMBER OF RECORDS LISTED IS 1 DSP0203I COMMAND COMPLETED WITH CONDITION CODE 00 DSP0220I COMMAND COMPLETION TIME DSP0211I COMMAND PROCESSING COMPLETE. DSP0211I HIGHEST CONDITION CODE = 00 DSP0058I RML COMMAND COMPLETED
Entry ET:
/RMLIST DBRC='DB DBD(DIVNTZ04) DBDS'
Response ET:
LIST.DB DBD(DIVNTZ04) DBDS RECON1 DSN=RECONH1 ------------------------------------------------------------------------------ DB DBD=DIVNTZ04 IRLMID=*NULL DMB#=769 TYPE=IMS SHARE LEVEL=0 FLAGS: COUNTERS: BACKOUT NEEDED=OFF RECOVERY NEEDED COUNT=0 READ ONLY=OFF IMAGE COPY NEEDED COUNT=1 PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS=0 RECOVERABLE=YES HELD AUTHORIZATION STATE=0 EEQE COUNT=0 ------------------------------------------------------------------------------ DBDS DSN =JDSGIIZ4 DBDS SEQ=1 IMS DBD=DIVNTZ04 DDN=DBHVSAM1 DSID=01 DBORG=HISAM DSORG=VSAM DSLOG SEQ=00 CA GRPNAME=**NULL** GENMAX=3 IC AVAIL=0 IC USED=0 IC NEEDED-ON RECOV-OFF NOREUSE ICJCL=ICJCL OICJCL=OICJCL RECOVJCL=RECOVJCL ------------------------------------------------------------------------------ DBDS DSN =JDSGIIZ4 DBDS SEQ=2 IMS DBD=DIVNTZ04 DDN=DBHVSAM2 DSID=01 DBORG=HISAM DSORG=VSAM DSLOG SEQ=00 CA GRPNAME=**NULL** GENMAX=3 IC AVAIL=0 IC USED=0 IC NEEDED-OFF RECOV-OFF NOREUSE ICJCL=ICJCL OICJCL=OICJCL RECOVJCL=RECOVJCL DSP0180I NUMBER OF RECORDS LISTED IS 3 DSP0203I COMMAND COMPLETED WITH CONDITION CODE 00 DSP0220I COMMAND COMPLETION TIME DSP0211I COMMAND PROCESSING COMPLETE. DSP0211I HIGHEST CONDITION CODE = 00 DSP0058I RML COMMAND COMPLETED
Entry ET (With Comments):
/RML DBRC='DBDS DBD(DEDBJN21) AREA(DB21AR0)'. *VSO AREA*.
Response ET:
LIST.DBDS DBD(DEDBJN21) AREA(DB21AR0) ------------------------------------------------------------------------ DBDS DBD=DEDBJN21 AREA=DB21AR0 TYPE=FP SHARE LEVEL=1 DSID=001 DBORG=DEDB DSORG=VSAM GSG NAME=**NULL** USID=0000000002 AUTHORIZED USID=0000000002 RECEIVE USID=0000000002 MAX USID=0000000002 RECEIVE NEEDED USID=0000000000 CAGRP=**NULL** GENMAX=5 IC AVAIL=0 IC USED=0 DSSN=0000000 HSSP IC IN PROCESS=NO AVAIL USED PARTIAL HSSP IC=0 HSSP IC=0 HSSP IC=0 REUSE RECOVPD=0 VSO PREOPEN PRELOAD DEFLTJCL=**NULL** ICJCL=ICJCL RECVJCL=ICRCVJCL RECOVJCL=RECOVJCL FLAGS: COUNTERS: PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =1 HELD AUTHORIZATION STATE=7 IC NEEDED =OFF ADS AVAIL # =1 RECOV NEEDED =OFF REGISTERED ADS # =1 EEQE COUNT =0 TRACKING IN PROGRESS =NO RECEIVE NEEDED =OFF OFR REQUIRED =NO TRACKING SUSPENDED =NO ADS LIST: CREATE -ADS DDN--ADS DSN- -STAT- -RUNNING- DB21AR0 DB21AR0 AVAIL NO ASSOCIATED SUBSYSTEM INFORMATION: ENCODED -SSID- -ACCESS INTENT- -STATE- -SS ROLE- SYS3 EXCLUSIVE 7 ACTIVE ALLOC ALLOC = 93.076 13:30:35.0* START = 93.076 13:30:23.3 LRID=0000000000000000 DSSN=0000000001 USID=0000000002 REORG RUN = 93.076 13:23:38.0* USID=0000000000 DSP0180I NUMBER OF RECORDS LISTED IS 3 DSP0203I COMMAND COMPLETED WITH CONDITION CODE 00 DSP0220I COMMAND COMPLETION TIME 93.076 13:37:36.7 DSP0211I COMMAND PROCESSING COMPLETE DSP0211I HIGHEST CONDITION CODE = 00 DSP0058I RML COMMAND COMPLETED
Entry ET (With Comments):
/RML DBRC='DBDS DBD(DEDBJN21) AREA(DB21AR6)'. *DEDB AREA*.
Response ET:
LIST.DBDS DBD(DEDBJN21) AREA(DB21AR6) ------------------------------------------------------------------------ DBDS DBD=DEDBJN21 AREA=DB21AR6 TYPE=FP SHARE LEVEL=1 DSID=007 DBORG=DEDB DSORG=VSAM GSG NAME=**NULL** USID=0000000002 AUTHORIZED USID=0000000002 RECEIVE USID=0000000002 MAX USID=00000000 RECEIVE NEEDED USID=0000000000 CAGRP=**NULL** GENMAX=5 IC AVAIL=0 IC USED=0 DSSN=0000000 HSSP IC IN PROCESS=NO AVAIL USED PARTIAL HSSP IC=1 HSSP IC=0 HSSP IC=0 REUSE RECOVPD=0 NOVSO NOPREOPEN NOPRELOAD DEFLTJCL=**NULL** ICJCL=ICJCL RECVJCL=ICRCVJCL RECOVJCL=RECOVJCL FLAGS: COUNTERS: PROHIBIT AUTHORIZATION=OFF AUTHORIZED SUBSYSTEMS =0 HELD AUTHORIZATION STATE=0 IC NEEDED =OFF ADS AVAIL # =0 RECOV NEEDED =ON REGISTERED ADS # =1 EEQE COUNT =0 TRACKING IN PROGRESS =NO RECEIVE NEEDED =OFF OFR REQUIRED =NO TRACKING SUSPENDED =NO ADS LIST: CREATE -ADS DDN--ADS DSN- -STAT- -RUNNING DB21AR6 DB21AR6 UNAVAIL NO ALLOC ALLOC = 93.076 13:32:05.0* START = 93.076 13:30:23.3 LRID=0000000000000000 DSSN=0000000001 USID=0000000002 DEALLOC = 93.076 13:34:21.2 DEALLOC LRID=0000000000000000 REORG RUN = 93.076 13:24:12.5* USID=0000000000 AVAILABLE DATA SET DBD=DEDBJN21 DDN=DB21AR6 IMAGE * CREATE = 93.076 13:22:52.8* HSSP IC1 DSN=IC21AR6 DSP0180I NUMBER OF RECORDS LISTED IS 4 DSP0203I COMMAND COMPLETED WITH CONDITION CODE 00 DSP0220I COMMAND COMPLETION TIME 93.076 13:38:21.0 DSP0211I COMMAND PROCESSING COMPLETE DSP0211I HIGHEST CONDITION CODE = 00 DSP0058I RML COMMAND COMPLETED
Entry ET (with comments):
/RMNOTIFY DBRC='SUBSYS SSID(IMSB) IRLMID(IRLM1) NORMAL'. *END OF DAY MESSAGE*.
Response ET:
NOTIFY.SUBSYS SSID(IMSB) IRLMID(IRLM1) NORMAL DSP0203I COMMAND COMPLETED WITH CONDITION CODE 00 DSP0220I COMMAND COMPLETION TIME DSP0211I COMMAND PROCESSING COMPLETE. DSP0211I HIGHEST CONDITION CODE = 00 DSP0058I RMN COMMAND COMPLETED