Internal Script Variables

Top  Previous  Next

 

FileLink maintains a set of internally defined variables. These variables always begin with the % or $ symbol. You may use these variables just as you would any user variable, but assigning values to these variables using the SETSET or SETNUM commands is not recommended.

 

%currentlocaldir Contains the current local working folder (directory)
%datetime Contains a formatted date/time string (i.e., Sat Feb 17 11.00.22 2006)
%dbrawqueryresult Contains the raw SQL query result if the DBGETRESULTS command does not recognize or cannot parse the result into individual %db_xxxx variables.
%dbqueryrows Contains the number of rows returned on the most recent DBQUERY command SQL database query
%dbqueryvariables Contains the number of variables created during the most recent DBGETRESULTS command
%difffileid Contains a numeric representation of the type of difference found on the most recent run of the GETDIFF command
%difffilename Contains the name of a file where a difference has been found on the most recent run of the GETDIFF command
%difffilepath Contains the full path a file where a difference has been found on the most recent run of the GETDIFF command
%difffiles Contains the number of file differences found on the most recent run of the DIFF command
%difffiletext Contains a text description of the type of difference found on the most recent run of the GETDIFF command
%diffnum Contains the sequence number of the file difference returned on the most recent run of the GETDIFF command
%lasterror Error or result code returned by the last script command run
%lasterrormsg Descriptive text of error returned by the last script command run
%newportNew port number set by MODEMDETECT script command
%nextcmd Character string obtained by CRON command
%nextfile File name obtained by GETNEXTFILE command
%nextfiledate File date obtained by GETNEXTFILE command
%nextfiledatetime File date/time stamp obtained by GETNEXTFILE command
%nextfilesize File size (in bytes) obtained by GETNEXTFILE command
%nextfiletime File time stamp obtained by GETNEXTFILE command
%nextfolder Optional folder name obtained by GETNEXTFILE command
%nextpath Full path name obtained by GETNEXTFILE command
%port Contains the current COM port
%rcvfilecount Contains the number of files received by last RCVFILE command
%sendfilecount Contains the number of files sent by last SENDFILE command
%snapshotfiles Contains the number of files examined during the most recent run of the SNAPSHOT command
%time Contains the current system time (i.e., 11.00.22)
%timedate Same as %datetime
%unzipcount Contains the number of files unzipped during the previous UNZIP command
%zipcount Contains the number of files zipped during the previous ZIP command
$ERROR_nnPredefined $ERROR constants for use with the IFERROR command
%1 - %9Variables assigned from Shortcut Target arguments

 

Consider the following examples in which the use of an internal variable is shown.

 

GETNEXTFILE

MESSAGEBOX %nextfile "Last file name received was:"

;; create a directory using current date and time

MAKEDIR %datetime

 

Details on internal script variable usage follows in additional sections.