IMS Version 9

/RMxxxxxx

Format

Read syntax diagramSkip visual syntax diagram>>-+-+-/RMCHANGE-+-+--+------------------+---------------------->
   | '-/RMC------' |  '-LTERM--ltermname-'
   +-+-/RMDELETE-+-+
   | '-/RMD------' |
   +-+-/RMGENJCL-+-+
   | '-/RMG------' |
   +-+-/RMINIT-+---+
   | '-/RMI----'   |
   +-+-/RMLIST-+---+
   | '-/RML----'   |
   '-+-/RMNOTIFY-+-'
     '-/RMN------'

>--DBRC='modifier parameter-set'-------------------------------><

Environments and Keywords

Table 143 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keyword can be issued.

Table 143. Valid Environments for the /RMxxxxxx Command and Keyword
Command / Keyword DB/DC DBCTL DCCTL
/RMxxxxxx X X X
LTERM X X

Usage

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.

Table 144. Functions of the DBRC Commands Supported Online
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:
  • IMS Change Accumulation utility
  • IMS Log Archive utility
  • IMS Log Recovery utility
  • IMS Database Image Copy utility
  • Database Image Copy 2
  • IMS Online Database Image Copy utility
  • Database Recovery utility
  • User-defined output
/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
LTERM
Specifies the logical terminal designated for output. If you omit the LTERM keyword, the output destination is the input terminal.

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.

modifier
The DBRC modifier for the function specified.

Table 145 lists the DBRC modifiers and the /RMxxxxxx commands with which the modifiers can be issued.

Table 145. DBRC Modifiers for the /RMxxxxxx Commands
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      
parameter-set
Represents the required and optional parameters that will be passed to DBRC. For a full description of the DBRC commands, modifiers, and parameters, see IMS Version 9: DBRC Guide and Reference.

Examples

Example for /RMCHANGE Command

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

Example for /RMDELETE Command

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

Example for /RMGENJCL Command

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

Example for /RMINIT Command

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

Example for /RMLIST Command

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

Example for /RMNOTIFY Command

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

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004