History Recovery

Maximum hours of history to recover

Number of hours to recover history for all points. Setting the value to 0 disables history recovery for all points. (command line parameter /RH= hours)

The Use Default button resets the value to the default setting of 8.

Hours of history to recover per cycle

This is the number of hours of history to recover in each cycle through the point list. If the number of hours specified in the Hours of history to recover per cycle box is greater than or equal to the hours of history recovery requested in the Maximum hours of history to recover box, history will be recovered in one archive call from *- Hours of history to recover per cycle hours to *.

If the number in the Maximum hours of history to recover box is greater than the number in the Hours of history to recover per cycle box, the archive calls to retrieve history is divided into N calls, where N = Maximum hours of history to recover / Hours of history to recover per cycle + 1.

The calls, which start from *-Maximum hours of history to recover, each span Hours of history to recover per cycle hours. Each history increment is collected for all tags in the given scan class before the next time increment is begun. If this field is set to zero, the default 24 hours is used. (command line parameter /RH_INC= hours)

The Use Default button resets the value to the default setting of 24 hours for the number in the Hours of history to recover per cycle box.

Millisecond pause between history calls

The number of milliseconds to pause between history recovery calls. (command line parameter /HRPAUSE= millisecond)

The Use Default button resets the value to the default setting of 0 milliseconds to pause between history recovery calls.

Use history recovery only (no snapshot data collection)

If this check box is selected, tags do not sign up for exceptions. Each scheduled scan time (each scan class), history recovery is done from the last snapshot value to the current time. This box must be checked if you want to enable the Time Range History Recovery controls and enter a History time range. (command line parameter /HRONLY)

Time Range History Recovery

This section is only enabled if the Use history recover only check box is selected.

History time range (dd-mmm-yy:hh:mm:ss,dd-mmm-yy:hh:mm:ss)

If the Time Range History Recovery controls are enabled, you can specify a range of history to recover. The interface exits after history recovery completes. The times must be specified using PI time string formats with a colon separating the date and the time. For example:

10-dec-98:10:00:00,10-dec-98:12:00:00

Note: These times are local to where the interface runs.

The example above recovers two hours of data from the source to receiving system; put it into the receiving PI system snapshot for all points and then exit. This switch overrides the normal checking for the most recent snapshot time in the receiving database, thus out of order data may result.

When time-range history recovery is enabled, the value specified by the /RH parameter is overridden. (command line parameter /HRONLY=dd-mmm-yy:hh:mm:ss,dd-mmm-yy:hh:mm:ss)

Start history recovery beginning with the first value prior to the start time.

If the Time Range History Recovery controls are enabled, you can check the Start history recovery beginning with the first value prior to the start time box to retrieve history for all the points starting from the value immediately prior to the start time. The default is to begin with the first value after the start time. (command line parameter /NS).

Additional Parameters

This Additional Parameters box is provided for any additional parameters that the current ICU Control does not support.