STATUS

STATUS

Top  Previous  Next

 

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

 

varis the variable to receive the dynamic array.

 

file.varis 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:

 

1File position for a sequential file.
21 if at end of file, else 0 (sequential files)
3Unused on QM
4Bytes available to read (sequential files)
5File permission flags in the form used by Linux, etc to define access rights
6File size
7Number of hard links (not Windows)
8User id of owner (not Windows)
9Group id of owner (not Windows)
10Inode number (not Windows)
11Device number (not Windows)
12Unused on QM
13Time of last access. Seconds since midnight in user's local time zone.
14Date of last access. Pick style day number in user's local time zone.
15Time of last modification. Seconds since midnight in user's local time zone.
16Date of last modification. Pick style day number in user's local time zone.
17-19Unused on QM
20Operating system file pathname
21File type (see FILEINFO() for a list of values)
22-33Unused on QM.
34Time of last access. Epoch value (see Dates, Times and Epoch Values).
35Time of last modification. Epoch value.

 

 

See also:

FILEINFO()