6.129 REPORTROLLOVER

Valid For

Extract and Replicat

Description

Use the REPORTROLLOVER parameter to force report files to age on a regular schedule, instead of when a process starts. For long or continuous runs, setting an aging schedule controls the size of the active report file and provides a more predictable set of archives that can be included in your archiving routine.

Note:

Report statistics are carried over from one report to the other. To reset the statistics in the new report, use the STATOPTIONS parameter with the RESETREPORTSTATS option.

You can specify a time of day, a day of the week, or both. Specifying just a time of day (AT option) without a day of the week (ON option) generates a report at the specified time every day.

Rollovers caused by this parameter do not generate runtime statistics in the process report:

  • To control when runtime statistics are generated to report files, use the REPORT parameter.

  • To generate new runtime statistics on demand, use the SEND EXTRACT or SEND REPLICAT command with the REPORT option.

Default

Roll reports at startup

Syntax

REPORTROLLOVER
{AT hh:mi |
ON day |
AT hh:mi ON day}
AT hh:mi

The time of day to age the file.

Valid values:

  • hh is based on a 24-hour clock and accepts values of 1 through 23.

  • mi accepts values from 00 through 59.

ON day

The day of the week to age the file. Valid values are:

SUNDAY
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY

The values are not case-sensitive.

Examples

Example 1   
REPORTROLLOVER AT 05:30
Example 2   
REPORTROLLOVER ON friday
Example 3   
REPORTROLLOVER AT 05:30 ON friday