Utility Statements › ROLLFORWARD › ROLLFORWARD Parameter

ROLLFORWARD Parameter

FILE

Specifies that one or more files is to be restored. Areas associated with the specified files are not unlocked.

segment-name

Specifies the segment associated with the file.

file-name

Specifies the name of the file.

AREA

Specifies that one or more areas are to be restored and unlocked.

segment-name

Identifies the segment associated with the area.

area-name

Specifies the name of the area.

SEGMENT

Specifies to restore and unlock all areas associated with the specified segments.

segment-name

Specifies the name of the segment.

DMCL

Restores all areas defined by the DMCL specified in the SYSIDMS parameter file.

rollforward-options

Specifies options used to rollforward from a standard archive journal tape.

Expansion of rollforward-options immediately follows the main statement syntax.

FROM EXTRACT

Specifies that an extract journal will be used for input instead of a standard archive journal tape.

This option excludes use of the SORTED/SEQUENTIAL, VERIFY, ALL/COMPLETED, and STOP AT options because these options have no effect on the already created extract file.

ddname

Specifies the external name for the input extract file.

COMPLETED

• If you do not specify a STOP time, after images are applied onlyfor transactions that have been completed before the end of the journal file. After images are applied for incomplete distributed transactions whose state is InDoubt at the end of the journal file (unless a manual recovery control file entry overrides this behavior by specifying BACKOUT for one or more of the transactions).
• If you do specify a STOP time, after images are applied for all transactions that have been completed up to the first checkpoint record after the STOP time. After images are applied for incomplete distributed transactions whose state is InDoubt at the stop time (unless a manual recovery control file entry overrides this behavior by specifying BACKOUT for one or more of the transactions).

ALL

• If you do not specify a STOP time, after images are appliedfor all transactions in the journal file.
• If you do specify a STOP time, after images are applied until a point at or after the specified time where there are no active transactions. If no such point is found, processing stops at the end of the journal file.

SEQUENTIAL

After images are applied in the sequence in which they occur in the journal file.

SEQUENTIAL is the default.

Note: Backward file reads are not supported under z/VM. If an aborted transaction is encountered, a backward read may be attempted, in which case it will fail. For this reason, it is safer for z/VM users to specify SORTED.

SORTED

Specifies that after images are to be sorted in the journal file by database key and only the latest after image for any database key is applied.

All the database keys on a given database page will be copied back together. Thus, each page will be accessed once.

By default, if you do not specify SORTED, the after images will be copied back sequentially.

Note: You cannot use the SORTED option with VSAM KSDS files.A native VSAM KSDS file must be recovered using the SEQUENTIAL option.

VERIFY

Indicates that the validity of the specified conditions should be checked. If the VERIFY option is not specified, no checking is performed. If VERIFY is specified without DATABASE or QUIESCE, DATABASE is the default.

• DATABASE—Specifies that before images are to be verified in the journal file before the after images are applied. If a before image in the journal file does not match the contents of the database, the roll forward operation will terminate with an error.

  By default, if database validity checking is not in effect, after images are copied back without first verifying the before images.

• QUIESCE—Specifies the level of quiesce point verification that will be performed.
  • NONE—Specifies that no quiesce point verification should be done. If "START AT" is specified, NONE is treated as LIMITED.
  • LIMITED—Specifies that limited quiesce point verification be performed. This is the default.
  • FULL—Specifies that the strictest form of quiesce point verification be performed.

START AT

Specifies that the operation should start only after reaching a specified date and time in the journal file. Only images for transactions that begin after the specified start time will be applied. By default, processing starts at the beginning of the journal file.

STOP AT

Specifies that the operation should stop as soon as possible after reaching a specified date and time in the journal file.

By default, processing stops when the end of the journal file is reached.

date

Specifies the date, in one of the following formats:

• yyyy-mm-dd
• mm/dd/yyyy
• dd.mm.yyyy

In these formats, the following rules apply:

• yyyy specifies the year. yyyy must be an integer in the range 0001 through 9999. Leading zeros are optional.
• mm specifies the month within the year. mm must be an integer in the range 01 through 12. Leading zeros are optional.
• dd specifies the day within the month. dd must be an integer in the range 01 through 31. Leading zeros are optional.

The combined values of yyyy, mm, and dd must represent a valid date. For example, 1988-02-29 is a valid date. 1989-02-29 is not.

date-time

Specifies the date and time, where:

• The format for specifying the DATE-TIME is:

  yyyy-mm-dd-hh.mm.ss.ffffff

• The rules for specifying the DATE component of DATE-TIME are the same as for DATE described previously. The rules for specifying the TIME component of DATE-TIME are:
  • hh specifies the hour on a 24-hour clock. hh must be an integer in the range 00 through 23. Leading zeros are optional.
  • mm specifies the number of minutes past the hour. mm must be an integer in the range 00 through 59. Leading zeros are optional.
  • ss specifies the number of seconds past the minute. ss must be an integer in the range 00 through 59. Leading zeros are optional.
  • ffffff specifies the number of millionths of a second past the specified second. ffffff is optional; if you include it, it must be an integer in the range 000000 through 999999. The default value is 000000. Trailing zeros are optional.

time

Specifies the time in one of the following formats:

• hh.mm.ss
• hh:mm:ss

The rules for specifying TIME are the same as those listed for DATE-TIME.

When TIME is specified, the date defaults to the current date.

UTC

Specifies that Start and Stop times are interpreted as UTC times instead of local times.