Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-59
FILE_GETINFO_ Procedure
[2] Object type. For disk files, a value greater than 0 indicates an SQL
object; 0 indicates a nonSQL file. -1 is returned for nondisk files.
[3] File type. For disk files, indicates the file type:
0 unstructured
1 relative
2 entry-sequenced
3 key-sequenced
-1 is returned for nondisk files.
[4] File code. For disk files, gives the application-defined file code (file
codes 100-999 are reserved for use by HP). -1 is returned for
nondisk files.
flags output
INT .EXT:ref:1
returns additional information about the file. The bits, when set to 1, indicate the
following:
<0:14> Reserved and undefined.
<15> File is an OSS file.
Considerations
•
You can obtain the last-error value resulting from a file operation that is not
associated with a file number by specifying a
filenum value of -1 to
FILE_GETINFO_. An error number can be obtained in this manner for such
operations as a purge, waited open, or failed create operation. The result of a
preceding awaitio[x] or alter operation can also be obtained in this manner.
•
When -1 is supplied for filenum, only last-error returns useful information. A
filename-length of 0 is returned.
•
If FILE_GETINFO_ is called subsequent to a file close, an error value of 16 (file
not open) is returned.
OSS Considerations
•
Use the flags parameter of FILE_GETINFO_ or FILE_GETINFOBYNAME_ or
use item code 161 of FILE_GETINFOLIST_ or FILE_GETINFOLISTBYNAME_ to
determine whether the file is an OSS file.
•
Use the item-list parameter of FILE_GETINFOLIST_ or
FILE_GETINFOLISTBYNAME_ to specify which OSS file attribute values are to be
returned.