Application icon

Active Files to List

The Restore Initial Set of Files statement allows you to have a single restore point for file availability. This statement when used in conjunction with a List to Active Files statement allows you to have multiple varied restore points.

This statement saves a list of file indexes delimited by the default list delimiter \~. When not batch processing, the saved indexes correspond to a file's index into the list of all visible (not hidden) loaded files. When batch processing, the indexes correspond to files in the initial file availability.

You should never have to directly work with the individual list items. It is easy to programatically set the availability of files using an Ignore Files statement which can be saved by this statement. Typically the produced list would only be used in conjunction with a List to Active Files statement.

The named variable field may contain any of the escape sequences described in Escape Sequences.

The statement is always valid. When executing a Load & Run statement, the returned named variable will be empty unless the same file was already loaded. In this case the action test state will be set to false. Otherwise, the action test state will be set to true.

Additional information can be found in the File Availability topic.