Run RPID with the RPID report

When you use the Recovery Point ID (RPID) ISPF interface to generate IMS Database Recovery Facility jobs, you must specify the database components that you want to recover and the recovery time.

Using the RPID ISPF interface with the RPID report allows you to specify database components and recovery times directly from the RPID report.

Because the RPID report lists validated recovery time spans for one or more databases, you do not have to independently verify database components and recovery times.

Before you begin, complete the following prerequisite tasks:

  • Install the Extended Functions ISPF interface and allocate the ISPF libraries required for the RPID ISPF interface.
  • Run the RPID function to generate an RPID report.

    The report must be in an EDIT or VIEW session.

  • To recover a group of database components to a common recovery point, make sure that a common time span exists for all of the database components.

    If the database components do not have a common time span, you can generate one by using the Recovery Point Create function.

To select the database components and recovery times by using the RPID ISPF interface with the RPID report:

  1. Start the RPID ISPF interface with the RPID report by issuing the IROTREXL command on the command line of an RPID report:
    Command ===> irotrexl

    After you start the RPID ISPF interface, the initial RPID ISPF interface panel is displayed, as shown in the following figure:

    Figure 1. The initial RPID ISPF interface panel with the RPID report
    
                             IMS DATABASE FACILITY EXTENDED FUNCTIONS 
                                   Recovery Point ID Report                          
     Command ===> –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––– 
                                                                                    
       Select option and press ENTER to continue.  Press END to exit.              
         _   1. Common Time Span processing                                         
             2. Database component processing                                       
             3. View selected recovery basis                                        
             4. Generate IMS Database Recovery Facility JCL                         
                                                                                    
      RPID report parameters                                                        
         Execution . . . : 12/08/2021 19:26          Time format. . . : UTC         
                                                                                    
         Time range. . . : 21.314 14:15:40.1+0000 -- 21.364 14:15:40.1+0000         
                           Nov 10 2021               Dec 30 2021                    
    

    The RPID ISPF interface contains help panels that provide more detailed information about the interface and its options.

    You can access help panels by pressing the PF1 key at any time.

  2. Select Common Time Span processing.
  3. In the Common Time Spans panel, select a common time span to limit the recovery to a specific time span.

    A common time span helps you recover a group of database components to a common recovery point.

    If you do not select a common time span, generated control statements will not contain an RCVTIME parameter, and any subsequent option that relies on a common time span cannot be selected.

    For examples, the following figure shows that the 21.338 11:10:19.946777+0000 -- 21.364 14:15:40.100000+0000 common time span was selected after S was entered to the left of the selection.

    The selection is now indicated by *Recvr.

    Figure 2. Common Time Spans - Selected
    
                                                                     Row 1 to 2 of 2
                                    Common Time Spans                               
     Command ===> ________________________________________________ Scroll  ==> CSR  
                                                                                    
      Select/deselect time with "S" and press ENTER.  Press END after selection.    
                                                                                    
            ----- Span Start Time -----    ------ Span End Time ------              
     _      21.314 14:15:40.100000+0000 -- 21.338 10:54:27.712196+0000              
            Nov 10 2021                    Dec 04 2021                              
                                                                                    
     _      21.338 11:10:19.946777+0000 -- 21.364 14:15:40.100000+0000               
    *Recvr  Dec 04 2021                    Dec 30 2021                              
                                                                                    
     ******************************* Bottom of data ********************************
  4. Exit the Common Time Spans panel and select Database component processing from the IMS Recovery Point ID Report panel.
  5. In the Database Component Processing panel, enter a forward slash (/) to the left of the components that you want to recover.

    A list of processing options is displayed that allows you to specify the recovery options for the selected component.

    For example, you can specify the time to which components are to be recovered, exclude specific components for recovery, or view more information about each component.

    Attention: To avoid data integrity exposure, do not specify individual ddnames for recovery. If you want to specify individual ddnames, make sure that you are familiar with ddname recovery and its implications.

    The following figure shows that the partitions POHIDKB and POHIDKC are selected for recovery and that the full recovery time of ddname POHIDKCB is selected as the recovery time. All other components are excluded from recovery.

    Figure 3. Recovery time selected on the Database Component Processing panel
                                                                Line 1 to 20 of 50
                              Database Component Processing
    Command ===> __________________________________________________ Scroll==> CSR
    
    Common Time Span: 21.338 11:10:19.946777+0000 to 21.364 14:15:40.100000+0000
      Recovery basis: 21.338 11:12:50.200000+0000 POHIDKCB Full-Recovery
    
    Enter request at input fields or enter "/" for request list. Press END to exit.
    
    Type    Database    Area/Part   DDname    Recover     -- Recovery Selection --
           _ *DBLIST
    
     HAL   _ DBOHIDK5  _ POHIDKA   _ POHIDKAA  Excl-Part
                                   _ POHIDKAM
                                   _ POHIDKAB
                                   _ POHIDKAN
                       _ POHIDKB   _ POHIDKBA  Add-Part
                                   _ POHIDKBM
                                   _ POHIDKBB
                                   _ POHIDKBN
                       _ POHIDKC   _ POHIDKCA  Add-Part
                                   _ POHIDKCM
                                   _ POHIDKCB              Full-Recovery           
                                   _ POHIDKCN
                       _ POHIDKD   _ POHIDKDA  Excl-Part
                                   _ POHIDKDM
                                   _ POHIDKDB
                                   _ POHIDKDN
    
     FF    _ DBOVLFPC              _ VLOSAM01  Excl-Dbase
    

    When you select a recovery time, the database component that you selected the recovery time from is highlighted. Any parents and children of that database component are also highlighted.

    If you have specified a recovery time, the time is shown in the Recovery basis field.

    The Recover column contains recovery status indicators that define how JCL will be generated for each component.

  6. After you have selected the components that you want to recover, exit the Database Component Processing panel.
  7. Optional: To review a summary of your recovery selections, select View selected recovery basis from the IMS Recovery Point ID Report panel.
  8. Select Generate IMS Database Recovery Facility JCL to complete the selection of database components and recovery times.

    The IMS Database Recovery Facility Job Generation panel is displayed, which allows you to customize parameters, customize control statements, and add additional JCL before generating the IMS Database Recovery Facility job.