FILE STATUS (FST)
|
|
FILE STATUS (FST) |
|
|
Standard Noun Noun |
Used by the verbs that perform file operations (external and internal).
It contains a numeric status of the most recent file operation. This status tells you whether or not the file operation completed properly.
Both FILE STATUS and EXTERNAL ECHO are set after file operations, and either may be Checked.
FILE STATUS, since it contains numeric values, is language independent.
If the value FILE STATUS "<>" the value 0 do FILE STATUS ERROR ROUTINE RETURN else end
The noun FILE STATUS contains a numeric status after all file operations (except those using mock internal emulation; mockflag = 1).
Both FILE STATUS and EXTERNAL ECHO are set after file operations, and either may be Checked.
| {bml EXCLAMAT.BMP} | FILE STATUS, since it contains numeric values, is language independent; whereas EXTERNAL ECHO contains text which is different for each country. If EXTERNAL ECHO is used, the verb is dependent upon the file status messages selected in PRAGMA.DES. |
These are the possible values of FILE STATUS :
| OK | 0 |
| record not found | 1 |
| duplicate reference | 2 |
| conflict | 3 |
| file is locked | 4 |
| queue is empty | 5 |
| queue is locked | 6 |
| prepare to stop | 7 |
| NO SUCH FILE | 8 |
| REFERENCE TOO LONG | 9 |
| MORE NOUNS IN LOCAL FILE | 10 |
| FEWER NOUNS IN LOCAL FILE | 11 |
| NO SUCH QUEUE | 12 |
| NO RESPONSE RECEIVED | 13 |
| EXTERNAL DISC IS FULL | 14 |
| TRANSMISSION ERROR | 15 |
| INTERNAL LOGIC ERROR | 16 |
| UNKNOWN EXTERNAL ECHO? | 17 |
| The file does not exist in the vocab | 18 |
| The item is not a file | 19 |
| The definition count in the file is zero | 20 |
| You cannot use a file with a mock flag greater than 16 | 21 |
If you are using BTRIEVE as filemanager and the result of a fileoperation is INTERNAL LOGIC ERROR for the EXTERNAL ECHO, the FILE STATUS will contain the BTRIEVE error number. This is to help to trace BTRIEVE errors.
| OK | 0 |
| record not found | 1 |
| Various messages, see below | 99 |
A FILE STATUS message of 99 indicates that the message has either been received from SQL or is a special Pragma error and in every case it means that there has been a problem that has to be taken care of. In every case the origin of the message is indicated.