Fmodtime – Visara Master Console Center Scripting Guide User 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)

FREWIND, FWRITE