|
The STATUS statement returns a dynamic array containing a variety of information about an open file.
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 time zone. |
| 14 | Date of last access. Pick style day number in user's local time zone. |
| 15 | Time of last modification. Seconds since midnight in user's local time zone. |
| 16 | Date of last modification. Pick style day number in user's local time zone. |
| 20 | Operating system file pathname |
| 27 | Operating system file pathname (same as field 20) |
| 35 | Time of last modification. Epoch value. |
See also:
FILEINFO()
| 
