FILECOMPAREFROM        Compare file size and time/date stamp from FTP site

Top  Previous  Next

Syntax:

FILECOMPAREFROM

[ file name ]

Arguments:

[ file name ]

Variable or string defining a file name on the FTP site.

Options:

/tz=xx

Timezone adjustment (in hours) between the local PC and the FTP site; value is expressed as a positive or negative integer; used when local and server file’s time/date stamps are compared.  This option is unnecessary if the remote site supports the /precisetime option of the FTPLOGON command. This option is functionally equivalent to calling the TIMEZONE command so this adjustment persists after the execution of the current line of script. This option is deprecated in favor of the TIMEZONE command.

 

 

This command compares the size and date/time stamp of a specified file on the FTP site with a file of the same name on the local PC in the current folder.

 

The results of the comparison are saved in two internal script variables: size result is saved in %comparesize and date/time result is saved in %comparedate. These variables may then be tested using the IFSIZE and IFDATE commands respectively. (Do not use the IFERROR command.)

 

Consider the following example where a file on the FTP site is compared to a correspondingly named local file and a conditional branch is taken if the files are the same size.

 

FILECOMPAREFROM "server_file"

IFSIZE $ERROR_FILES_SAME_SIZE goto save_this_file

 

If you are not using the TIMEZONE script command, you may specify the /tz option to account for differences in timezones between Robo-FTP and the FTP site. This is important for accurate file date and time stamp comparisons. For example, if you are using Robo-FTP in the Central U.S. timezone and the FTP site is located in the Eastern U.S. timezone there is a one-hour difference between the file system times of Robo-FTP’s PC and the FTP site. To allow for this in the FILECOMPAREFROM command, the command would look like the following which indicates that the FTP site is one hour ahead:

 

FILECOMPAREFROM "server_file" /tz=+1

 

Further, if the FTP site is located in the Pacific U.S. timezone there is a two-hour difference the other way between the file system times of Robo-FTP’s PC and the FTP site. To allow for this, the command would look like the following which indicates that the FTP site is two hours behind:

 

FILECOMPAREFROM "server_file" /tz=-2

 

Important

The success of this command depends on Robo-FTP's ability to automatically read and understand the directory listings returned by the remote site.  It is not uncommon for HTTP/HTTPS sites to fail to return any directory listings or to return listings in an unsupported format.  Contact technical support if you have an urgent need related to a directory listing format that is currently unsupported.

 

Related Command(s): IFSIZE, IFDATE, FILECOMPARETO

See also: Comparing Local and FTP Site Files