Visara Master Console Center Scripting Guide - Manual (Page 108)

Chapter 5 Script Commands
Scripting Guide 108
FMODTIME
Syntax:
FMODTIME( File) ==> %EpochSeconds
Description:
Returns the time value of a last modified date/time stamp for a file.
Action: The epoch seconds for the specified file’s last modified date/time stamp
is returned.
Parameters:
File. Numeric or string expression. The name of the file for which to
return the date/time stamp. The file name or the file handle may be
specified. For a numeric expression, specify the file handle obtained
from FOPEN(). For a string expression, specify the case-sensitive file
name, including any path.
Returns:
Numeric value, as follows:
Value
Meaning
0 (Zero) False. The file does not exist.
Any other value The epoch seconds of the file’s last
modified date/time stamp.
For additional information, refer to Epoch Seconds on page 40.
Notes:
1. Refer also to Date/Time on page 40.
2. FMODTIME can be used to check any file on the MCC unit.
3. Using NFS, it is possible to check virtually any file on any server or
mainframe from the MCC unit.
Example:
%Handle := FOPEN( $FileName)
%TimeStamp := FMODTIME( %Handle)
%TimeStamp := FMODTIME( $FileName)
See Also:
FCLOSE, FDELETE, FEXISTS, FOPEN, FREAD, FRENAME,
FREWIND, FWRITE