Control statements for the Recovery function (DFSURDB0 JCL)

The control statements for the Recovery function that is invoked with IMS compatible JCL must reside in the SYSIN data set.

The utility control statement for the Recovery function invoked with IMS compatible JCL is the same as that of the original Recovery function.

ABEND statement

This figure shows the format of the utility control statement for using IMS compatible JCL.

Use the ABEND statement to end the utility with a user abend 302 when an abnormal condition is encountered. A storage dump is provided if a SYSUDUMP DD statement is supplied. If this statement is omitted, the Recovery function issues an error message for any abnormal condition encountered and continues processing.

The ABEND control statement must come before the IMS HP Image Copy Database Recovery control statement.

ABEND must start in column 1.

Database Recovery control statement

This figure shows the format of the utility control statement for using IMS compatible JCL.
Position
Description
1
Statement ID

Specify the statement ID of the Database Recovery utility control statement. It must be the character 'S'.

2
Must be blank.
3
Must be blank.
4-11
DBD name

Specify the name of the DBD that describes the database containing the data set to be recovered. This name must also appear in the PARM field of the EXEC statement.

12
Must be blank.
13-20
The data set name

Specify the ddname of the data set to be recovered. It must be the same as the ddname in the DBD and dataset1 DD statement.

21
Must be blank.
22-29
The input ddname

Specify the ddname of the data set used for the image copy input. If this field is blank, the ddname 'DFSUDUMP' is the default.

30
Must be blank.
31-55
Specify the time stamp when the RCVTIME parameter is specified in the GENJCL.RECOV command. Otherwise, these positions must be blank. For more information about time stamp recovery, see Time stamp recovery.

Either..

31-42
Specifies the date and time in the format yydddhhmmsst,

where:

  • yy is the year.
  • ddd is the day of the year.
  • hh is the hour.
  • mm is the minute.
  • ss is the second.
  • t is the tenth of a second.
43
Specifies the sign of the offset value; + or -.
44-47
Specifies the offset to the UTC, in the format HHMM.
48-55
Contains blank.

Or..

31-47
Specifies the punctuated time stamp with the format yy.ddd hh:mm:ss.t,

where:

  • yy is the year.
  • ddd is the day of the year.
  • hh is the hour.
  • mm is the minute.
  • ss is the second.
  • t is the tenth of a second.
48
Specifies the sign of the offset value; + or -.
49-53
Specifies the offset to the UTC, in the format HH:MM.
54-55
Contains blanks.

Or..

31-49
Specifies the punctuated time stamp with a four-year digit in the format yyyy.ddd hh:mm:ss.t,
where:
  • yy is the year.
  • ddd is the day of the year.
  • hh is the hour.
  • mm is the minute.
  • ss is the second.
  • t is the tenth of a second.
50
Specifies the sign of the offset value; + or -.
51-55
Specifies the offset to the UTC, in the format HHMM.
56
Contains a blank
57
C if the USEDBDS parameter is specified on the GENJCL.RECOV command; otherwise, blank.
58-80
A comment

For more information, see the GENJCL.JCL command in IMS Commands for the version of IMS that you are using.

You do not have to specify the name of the compression routine in the Database Recovery control statement. The image copy header includes the module name and its assemble time stamp.

Time stamp recovery

To recover data sets to a specific point in time, you must provide a valid recovery time stamp in columns 31-55. A valid recovery time stamp can be:
  • If the image copy data sets that you use as input are created as batch, SMSNOCIC, or SMSOFFLC image copies, the recovery time stamp can be the time when the Image Copy job was run or any time after that.
  • If the image copy data sets that you use as input are created as CIC, SMSCIC, SMSONLC, or ONLINE image copies, the recovery time stamp must be a time after the Image Copy job was run.
To recover data sets to a specific point in time, the following conditions must be satisfied:
  • The job must run with DBRC=Y.
  • Input image copy data sets, log data sets, and change accumulation data sets must be registered to DBRC RECON data sets.
  • The recovery time stamp that you specify must meet the following conditions:
    • Database data sets were not allocated or in use at the specified recovery time stamp.
    • The online log data set (OLDS) must be closed at the specified recovery time stamp, and is archived to the SLDS (system log data set) or RLDS (recovery log data set) before the specified recovery time stamp.
    • If a change accumulation data set is used, the change accumulation data set must be created before the specified recovery time stamp.