? tab(-10, AG_FILESTATS); fspec {,versiz {,hashsiz{, flags}}}; chr(127);
AG_FILESTATS (31) allows you to retrieve info about a file. The return string is of the format:
bytes, mtime, ctime, mode {,ver {,hash {,pcspec}}}
versiz, hashsiz
these are numeric values representing the size of the strings you intend to retrieve them into. If 0 or not specified, then the corresponding field will not be returned. Set versiz=30 to get the #####.#####.#####.#####.##### format; see MX_FILESTATS.
flags
may contain one or more of the following:
|
Value |
Description |
|
&h0001 |
Check for fspec in ATE cache directories if not found otherwise |
|
&h0002 |
Returned client native spec of located file |
Note that MX_FILESTATS is generally use in preference to AG_FILESTATS, because it is easier to use (standard subroutine return values), and works in all the same cases (including ATE), with the one exception that it requires A-Shell on the server. AG_FILESTATS could be used on any kind of server.
History
2011 June, A-Shell 5.1.1222: Add flags parameter, reformat return string