SNAPSHOT -- Take a “snapshot” of the local PC file system

Syntax:	SNAPSHOT	[ path ] [ dbfile ] [ /options ]
Arguments:	[ path ]	Optional Variable or string defining the starting local path from which to take a “snapshot” of the file system; if omitted, the current working folder is used and [ dbfile ] defaults to “snapshot_local.sql”.
	[ dbfile ]	Optional Variable or string defining an alternative to the default “snapshot_local.sql” database file used to save the snapshot.
Options:	/incldirs	Take a snapshot of the current or specified folder and all subfolders thereunder.

This script command is used in conjunction with the DIFF and GETDIFF script commands to locate individual file differences (i.e., change in size, date/time stamp) within a specified folder (and optional subfolder) tree within the local PC file system.

SNAPSHOT is the first step to establish a baseline (or “snapshot”) of the specified folder(s) from which to determine if any file(s) change. Details about files found are saved in an SQL database file. The database file name defaults to “snapshot_local.sql” but you may name it anything you like via the [ dbfile ] argument.

As long as unique and consistent [ dbfile ] arguments are specified, FileLink supports as many separate snapshots as you wish.

Consider the following example which takes a snapshot of the current working folder and any subfolders.

In most cases SNAPSHOT need only be run once. Future changes detected in the file system by the DIFF command are automatically updated in the database file unless FileLink is specifically told not to do so.

The total number of files examined in the local PC file system is saved in the %snapshotfiles script variable.