# STATUS Function
Read Time: 2 minute(s)
If used after an OPENPATH statement, the STATUS function will find the cause of a file open failure (that is, for a statement in which the ELSE clause is used). The following values can be returned if the statement is unsuccessful:
- 0 if successful, or an
- Operating System error code if previous command failed.
- 13 is returned if permission denied on UNIX systems.
For OCONV conversions, the function returns:
- 0 if conversion was successful,
- 1 if an invalid conversion is requested,
- 3 if conversion of possible invalid date.
If used after a READ statement, the STATUS function returns, if the file is a distributed file, the following:
If used after a READL, READU, READVL, or READVU statement, if the statement includes the LOCKED clause, the returned value is the terminal number, as returned by the WHO command, of the user who set the lock.
If used after a READSEQ statement, the STATUS function will return 1 if at end-of-file.
If used after a READT, REWIND, WEOF, or WRITET statement, the returned value is hardware-dependent (I.e. varies according to the characteristics of the specific tape drive unit).
The documentation that accompanied drive unit for may offer information about interpreting the values returned by the STATUS function.
Go back to jBASE BASIC
Go back to Programmers' Reference Guide