Example report: Full recovery using environment control statements

The report example shows the batch invocation of full recovery using SYSIN-supplied environment control statements.

FRD0000I  D A T A B A S E   R E C O V E R Y   F A C I L I T Y   10/03/2020 09:24                        Page 1


 D A T A B A S E   R E C O V E R Y   F A C I L I T Y   C O M M A N D S / C O N T R O L   S T A T E M E N T S

FRD7201I  SORTPARM(NUM(9) HIPRMAX(OPTIMAL) MAINSIZE(5) ASPREF(IDRF) -
FRD7201I  AVGRLEN(10000) FILSZ(30000) DYNALLOC(3))
FRD7201I  READNUM(01,03)     DRFPROC(TESTDRF)
FRD7201I  SPSIZE(1000)
FRD7201I ADD DBDS(POHIDKA POHIDKAA POHIDKC POHIDKCA  -
FRD7201I    POHIDKD POHIDKDA)
FRD7201I START ERROR(STOP) READNUM(2) VERIFY


 D A T A B A S E   R E C O V E R Y   F A C I L I T Y   R E C O V E R Y   P A R A M E T E R S

 PROCESS : VERIFY             RECOVERY OPTIONS
 SOURCE  : PRI                  RCVTIME : Not Specified
 READNUM : 02,03                TYPE    : Full
 ERROR   : STOP                 CHECK   : Yes
 RCVTOKEN: DRF
 DRFPROC : TESTDRF                 LBI     : No                   SPSIZE  :     1000
 
 ----------  Sort-Related Parameters  ----------
 
 NUM     :        9             MAINSIZE:       5              AVGRLEN :    10000
 FILSZ   :    30000             HIPRMAX : OPTIMAL              ASPREF  :     IDRF
 DYNALLOC:        3 , N/A


 D A T A B A S E   R E C O V E R Y   F A C I L I T Y   S U M M A R Y   R E P O R T

 Database   DD/Area    DSID        --------- Records Read ---------     Records    Subord.     Final
 Name       Name                         IC          CA         LOG     Written    Reg Name    Status

 POHIDKA    POHIDKAA    1               N/A         N/A         N/A         N/A      N/A       No errors encountered
 POHIDKC    POHIDKCA    1               N/A         N/A         N/A         N/A      N/A       No errors encountered
 POHIDKD    POHIDKDA    1               N/A         N/A         N/A         N/A      N/A       No errors encountered
FRD0000I  D A T A B A S E   R E C O V E R Y   F A C I L I T Y   10/03/2020 09:24                        Page 1


 D A T A B A S E   R E C O V E R Y   F A C I L I T Y   D A T A   S E T   I / O   R E P O R T

 Recover to point: Not Specified

 Image Copy Data Set Name                      Volume     IC DS      IC    -------- Time Stamp Range ----------
 -------------------------------------------   Serial   Read Count  Type   1st Record               Last Record

 IMSVS.POHIDKA.POHIDKAA.IC.IC124722            222222           0    STD
 IMSVS.POHIDKC.POHIDKCA.IC.IC124723            222222           0    STD
 IMSVS.POHIDKD.POHIDKDA.IC.IC124724            222222           0    STD

 Change Accum Data Set Name                    Volume     CA DS            -------- Time Stamp Range ----------
 -------------------------------------------   Serial   Read Count         1st Record               Last Record

 No data available for this type data set

 Log Data Set Name                             Volume     Log DS     IMS   -------- Time Stamp Range ----------
 -------------------------------------------   Serial   Read Count  SYSID  1st Record               Last Record

 IMSVS.RLDSP.IMS1.D20252.T1245071.V00          SCR03            0  IMS1    2020.252 19:45:07.1  2020.252 19:50:07.9
   Prilog: 2020.252 19:44:32.1
 IMSVS.RLDSP.IMS1.D20252.T1245071.V01          SCR03            0  IMS1    2020.252 19:50:07.9  2020.252 19:50:10.9
   Prilog: 2020.252 19:44:32.1
 IMSVS.RLDSP.IMS1.D20252.T1245071.V02          SCR03            0  IMS1    2020.252 19:50:10.9  2020.252 19:50:13.5
   Prilog: 2020.252 19:44:32.1
 IMSVS.RLDSP.IMS1.D20252.T1250135.V01          SCR03            0  IMS1    2020.252 19:50:13.5  2020.252 19:50:44.0
   Prilog: 2020.252 19:44:32.1
Following is an explanation of the Batch Invocation of Full Recovery Using SYSIN-Supplied Environment Control Statements example:
  • COMMANDS / CONTROL STATEMENTS
    This section displays the images of the control statements read from the SYSIN file:
    • The first four statements are Environment Control Statements and override comparable parameters included in the FRXDRFxx member.
    • The last three statements are Recovery Control Statements.
  • RECOVERY PARAMETERS
    This section lists the parameters used to direct the recovery. The recovery parameters were supplied via one of the following three mechanisms, in ascending order of selection priority:
    PROCESS: VERIFY
    A VERIFY recovery process was selected.
    SOURCE: PRI
    The Primary log and image copy data sets are to be used.
    READNUM: 02,03
    The maximum number of total devices to be used during recovery is 03. Of these, up to 02 can be tape devices. These numbers were specified as (3,3) in the FRXDRFxx member, but were overridden to (1,3) by the environment control statements in SYSIN. The number of tapes was further overridden by the START recovery control statement.
    ERROR: STOP
    Should an error be encountered during recovery, processing should terminate.
    RCVTOKEN: DRF
    The recovery token used during recovery is DRF.
    RCVTIME: Not Specified
    A recovery time was not specified.
    TYPE: Full
    A full recovery was requested.
    CHECK: Yes
    A check will be performed to ensure that, should a DBDS be in a recovery group, all of the DBDs within that recovery group need to be included in the list.
    DRFPROC: TESTDRF
    The procedure for the RSS is contained in member TESTDRF in the proclib PDS.
    LBI: No
    Large Block Interface processing was not requested.
    SPSIZE: 1000
    The SPSIZE specified is 1000. This number was specified as 1024 in the FRXDRFxx member, but was overridden by SYSIN.
    NUM: 9
    Num was specified as 9. This number was specified as 3 in the FRXDRFxx member, but was overridden by SYSIN.
    MAINSIZE: 5
    Mainsize was specified as 5. This number was specified as 30 in the FRXDRFxx member, but was overridden by SYSIN.
    AVGRLEN: 10000
    Avgrlen was specified as 10000. This number was specified as 256 in the FRXDRFxx member, but was overridden by SYSIN.
    FILSZ: 30000
    Filsz was specified as 30000. This number was specified as 21000 in the FRXDRFxx member, but was overridden by SYSIN.
    HIPRMAX: OPTIMAL
    Hiprmax was specified as Optimal. Both the FRXDRFxx member and SYSIN specified the save value.
    ASPREF: IDRF
    Aspref was specified as IDRF. This value was specified as DRFI in the FRXDRFxx member, but was overridden by SYSIN.
    DYNALLOC: 3 , N/A
    The number of dynamically allocated SORTWORK data sets is 3, as specified in SYSIN. The unit associated with the dynamic allocation was not specified, and is not available for the report. The Sort installation value for unit will be used by the SORT utility.
  • SUMMARY REPORT
    This section presents statistics and summarizes the results of the recovery for each of the data sets associated with each database:
    Database Name
    The database name is listed.
    DD/Area Name
    The DD name associated with each data set is listed. In this case, all of the databases were full-function. Had any fast path databases been included, the associated Area name or names would have been listed.
    DSID
    The data set id number is listed.
    Records Read
    The number of records read from the image copy, change accumulation and log data sets for application in the recovery are listed. If FlashCopy, the read count will be 'N/A'.
    Records Written
    The number of records written to the database data set is listed.
    Subord. Reg Name
    The name of the started task which was responsible for sorting the records being written for the indicated data set is listed.
    Final Status
    The status of the conclusion of the recovery is listed.
  • DATA SET I/O REPORT
    As was seen in earlier sections of the report, no recovery time was specified. This fact is reflected in the Recover to point in this section. The data set I/O report is divided into three sections:
    1. Image Copy
      For each image copy data set used during the recovery, the following information is listed:
      Image Copy Data Set Name
      The data set name is listed.
      Volume Serial
      The volume or volumes upon which the data sets were found.
      Read Count
      The number of records read from the data set with intent to be used as input is listed. If FlashCopy, the read count will be 'N/A'.
      IC Type
      The image copy type is listed. Allowable values for this field include:
      STD
      Standard Image Copy
      IC2
      Image Copy 2
      IC EXT
      Extended Image Copy
      HISAM UNL
      HISAM Unload
      Time Stamp Range
      Although this heading appears, this field has no significance for image copy data sets.
    2. Change Accum
      For each change accum data set used during the recovery, the following information is listed:
      Change Accum Data Set Name
      No change accum data sets were used.
      Volume Serial
      This field is intentionally blank.
      Read Count
      This field is intentionally blank.
      Time Stamp Range
      Although this heading appears, this field has no significance for image copy data sets.
    3. Log
      For each log data set used during the recovery, the following information is listed:
      Log Data Set Name
      The data set name is listed.
      Volume Serial
      The volume or volumes upon which the data sets were found.
      Read Count
      The number of records read from the data set with intent to be used as input is listed.
      IMS SYSID
      The SYSID associated with the IMS which created the log is listed.
      Time Stamp Range
      The range of times which are covered by the log is listed. The time stamp on the first and last records in the log is listed.
      Prilog:
      The PRILOG time listed in RECON for the log is listed.

      The difference between the log records read and the log records applied values in the recovery report are due to the update records read that generate multiple output records. The IMS Database Recovery Facility creates multiple update records for expedited processing when certain internal conditions are recognized.