Recovery File Utility

The Recovery File Utility program (SARRCOV) creates a recovery file with data such as tape volume serial number, data set name, DSN number, DSN count, and file sequence number. This program also allows limited editing of the recovery file and prints a formatted listing of it.
view
The Recovery File Utility program (SARRCOV) creates a recovery file with data such as tape volume serial number, data set name, DSN number, DSN count, and file sequence number. This program also allows limited editing of the recovery file and prints a formatted listing of it.
This utility program can be helpful when:
  • No recovery file has been created but one is needed.
  • An existing recovery file has been damaged and must be recreated.
2
2
Job Control Statements
Sample execution JCL can be found in member HAEXRCOV in your CVDEJCL data set.
These job control statements are used to execute SARRCOV:
  • JOB
    Initiates the job.
  • EXEC
    Specifies the program name (PGM=SARRCOV) and, optionally, the high-level name of the database as the PARM parameter (PARM='VIEW.SYSTEM1').
  • STEPLIB DD
    Defines the load library containing SARRCOV.
    If the program resides in a linklist library, omit this statement.
  • SYSUDUMP DD
    Defines the output data set (normally SYSOUT) used for listing the system memory contents at the time of an abend.
  • SARRECV DD
    Defines a user-maintained sequential data set used as the recovery file.
  • REPORT DD
    Defines the sequential output data set (normally SYSOUT) used for listing the control statements and messages.
    If not a SYSOUT data set, DCB=BLKSIZE=nnn must be coded where nnn is a multiple of 133.
  • SYSIN DD
    Defines a card image data set containing the control statements that are to be input.
SARRCOV Control Statements
Two control statements, FILESEQ and DATA SET NAME/VOLSER are used with the Recovery File Utility program. They are explained in the next sections.
Note:
Be sure to specify DR tape DSNs if you are planning to do a SARDBASE RESTORE using the DR tape.
FILESEQ
The FILESEQ control statement specifies the file sequence of the master index on the backup tape. To determine the file sequence number of the master index backup, use the mapping feature of the SARTCP program. If the backup tape is mapped with bypass label processing (LABEL=(,BLP)), do not include the file containing the standard labels in the counting for the FILESEQ parameter.
Syntax:
FILESEQ=
nnnnnnn
where
  • nnnnnnnn
    Specifies the file sequence of the master index on the backup tape. This value cannot exceed 99999999.
Note:
For more information about an example using FILESEQ, see SARRCOV Initialization below.
DATA SET NAME/VOLSER
The DATA SET NAME/VOLSER control statement specifies the data set name and the optional VOLSER of the backup tapes.
Syntax:
data-set-name[,volser]
where:
  • data-set-name
    Specifies the data set name of the backup tape
  • volser
    Optionally, specifies the VOLSER of the backup tape
Recovery Data Set Guidelines
Important! The data set must reside on a direct access volume. Be aware of the following:
  • Because the data set is used to recover the database, it must not be placed on the same volumes that contain data sets for the database.
  • The data set must not be allocated with DCB attributes.
  • Only one track can be allocated for this data set.
SARRCOV Initialization
SARRCOV Example 1
This JCL will update a recovery file and specifies that the most current backup of the master index is on file 99 of tape data set VIEW.SYSTEM1.SARTAPE.T0000009 and continues onto the following two backup tapes.
//EXAMPLE1 JOB ACCOUNT,PROGRAMMER //STEP1    EXEC PGM=SARRCOV //STEPLIB  DD DSN=CAI.CVDELOAD,DISP=SHR //REPORT   DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //SARRECV  DSN=VIEW.SARRECV,DISP=OLD //SYSIN    DD * FILESEQ=99 VIEW.SYSTEM1.SARTAPE.T0000009,00100 VIEW.SYSTEM1.SARTAPE.T0000010,00101 VIEW.SYSTEM1.SARTAPE.T0000011,00102 //
SARRCOV Example 2
This JCL initializes a recovery file and lists an existing recovery file.
//EXAMPLE2 JOB ACCOUNT,PROGRAMMER //STEP1    EXEC PGM=SARRCOV //STEPLIB  DD DSN=CAI.CVDELOAD,DISP=SHR //REPORT   DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //SARRECV  DD DSN=VIEW.SARRECV,DISP=OLD //SYSIN    DD DUMMY //
Note:
This process does not initialize the recovery data set. If the SYSIN data set is empty (as in this case) SARRCOV will only list the entries in the existing recovery data set.