FTPSNAPSHOT - Take a "snapshot" of the FTP site file system

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

This script command is used in conjunction with the FTPDIFF and FTPGETDIFF script commands to locate individual file differences (i.e., change in size, date/time stamp) within a specified directory (and optional subdirectory) tree within the FTP site file system.

FTPSNAPSHOT is the first step to establish a baseline (or “snapshot”) of the specified directory(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_site.sql” but you may name it anything you like via the [ dbfile ] argument.

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

Consider the following example which takes a snapshot of the current directory on the FTP site and any subdirectories.

In most cases FTPSNAPSHOT need only be run once. Future changes detected in the file system by the FTPDIFF command are automatically updated in the database file unless Robo-FTP is specifically told not to do so.

The total number of files examined within the FTP site file system is saved in the %ftpsnapshotfiles script variable.