|
The STATUS statement returns a dynamic array containing a variety of information about an open file. Not all fields are returned on the PDA version of QM.
Format
STATUS var FROM file.var THEN statement(s) ELSE statement(s)
where
| var | is the variable to receive the dynamic array. |
| file.var | is the file variable associated with an open file. |
At least one of the THEN and ELSE clauses must be present for compatibility with other multivalue products. The implementation of STATUS in QM never executes the ELSE clause.
The STATUS statement returns a dynamic array where the fields contain the following information:
| 1 | File position for a sequential file. |
| 2 | 1 if at end of file, else 0 (sequential files) |
| 4 | Bytes available to read (sequential files) |
| 5 | File permission flags in the form used by Linux, etc to define access rights |
| 7 | Number of hard links (not Windows) |
| 8 | User id of owner (not Windows) |
| 9 | Group id of owner (not Windows) |
| 10 | Inode number (not Windows) |
| 11 | Device number (not Windows) |
| 13 | Time of last access. Seconds since midnight in user's local timezone. |
| 14 | Date of last access. Pick style day number in user's local timezone. |
| 15 | Time of last modification. Seconds since midnight in user's local timezone. |
| 16 | Date of last modification. Pick style day number in user's local timezone. |
| 20 | Operating system file pathname |
| 35 | Time of last modification. Epoch value. |
See also:
FILEINFO()
|