Rollback

Overview

Each time you run analysis on a model, PhixFlow creates a new set of data in each stream. You can view the stream sets and the data they contain; see Recordset List. Stream sets remain available until you run an archive task on the stream; see Task. 

If there is a problem during the analysis run, you may find that a stream set has incorrect or missing data. To fix stream sets, you can undo the analysis by running rollback. There are several options available to configure rollback; see Using the Rollback Window, below.

• Either rollback deletes the specified stream set(s).
  You cannot repopulate a deleted stream set.
  Use this approach when you want to completely discard a stream set. When you next run analysis, PhixFlow creates a new stream set with the latest data.
  
  
• Or rollback deletes the data but keeps the stream set itself. Tick the Keep old stream sets option to use this option.
  The stream set remains on the stream set list, marked as incomplete. You can repopulate an incomplete stream.
  Use this approach when you want to fix the data in a stream set. When you next run analysis, PhixFlow repopulates the incomplete stream set; see Repopulating Incomplete Stream Sets, below. 

For large data sets, it may take some time to rollback all the data in a stream set.

Accessing the Rollback Window

To undo one, some or all of the stream sets for a stream, use the  Rollback menu option, which displays the Rollback window. You can access this option from several places:

• In the repository: right-click on a stream name and select    Rollback Stream.
• In the repository: use Ctrl+click to select multiple streams, right-click one of the stream names and select    Rollback Selected Objects.
• In a model: right-click on a stream icon and select  Rollback Stream.
• In a list of stream sets: select one or more stream sets, then right-click on one stream set and select  Rollback StreamSet. PhixFlow automatically populates the data for the rollback options, as it knows the properties of the selected stream set(s).

Using the Rollback Window

In the Rollback window, select an option and specify the stream sets to rollback.

Option	Description
Rollback a number of StreamSets	Enter the number of stream sets to roll back. PhixFlow removes this number of stream sets, starting with the most recent.
Rollback to a specific run	Enter the run ID of a stream set to which you want to rollback. You can find the run IDs in the Recordset List. PhixFlow removes all the streams from the most recent, up to and including the specified run ID. For a transactional stream, PhixFlow removes the specified run ID only. All other stream sets, even more recent ones, are retained.
From Date	Enter a date. PhixFlow removes stream sets whose period start date is more recent than the specified date.
Rollback all data	Phixflow removes all stream sets for this stream.
Keep old Stream sets	This box is ticked by default.  Tick to rollback the data but to keep the stream set itself. In the stream set list, the stream set is empty and marked incomplete.  Untick to delete the stream set. Both the data and the stream set itself are removed from the stream set list. You cannot repopulate deleted stream sets.
	Close the window without running rollback.
	Run the rollback process, then click Yes to confirm.

Details about the rollback process are displayed in the console.

Repopulating Incomplete Stream Sets

If you rollback data due to errors, you can repopulate an incomplete stream set with the correct data. This is because the all stream sets in a model that were created during the same analysis run have the same Run ID. PhixFlow can use the run ID to pull the correct data into an incomplete stream.

To repopulate an incomplete stream set:

1. Go to the console.
2. Find the log messages related to rollback.
3. Right-click the log message and select Repeat to reinstate data; see Rollback or Repeat Cycles.

For information about rerunning incomplete stream sets in an transactional stream; see the Recordset List → Reprocess StreamSet option.