Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-69
FILE_GETINFOLIST_ Procedure
•
The FILE_GETINFOLIST_ procedure should not be used to determine, the
current-key-value parameter for queue files (item code 15), because a
current key position is not maintained for queue files.
•
Support for SQL files includes both Format 1 and Format 2 files.
•
If the file being referenced is a Format 2 file and the extent size exceeds 65535,
item codes will return -1 with no error indication.
•
For all items in Table 5-4 that return some form of last modification time, creation
time is returned for an object that has never been modified. Similarly, for items that
return some form of last open time, creation time is returned for an object that has
never been opened.
Table 5-4
shows the item codes used by FILE_GETINFOLIST_. Item codes of 30 and
greater, except item codes 201 through 206, are also used by
FILE_GETINFOLISTBYNAME_.
Table 5-4. FILE_GETINFOLIST_ Item Codes (page 1 of 21)
Items in this table with a size of 2 bytes are of data type INT. The term “disk file”
applies only to Enscribe files. The term “disk object” applies to Enscribe files and
SQL objects. Items described as “Applies only to SQL/MX objects” return file system
error 2 if queried on anything that is not an SQL/MX object.
Item
Code
Size
(Bytes) Description
1 2 File-name length. The length in bytes of the file name returned
by item 2.
2 * File name. The fully qualified name of the specified file at the
time it was opened.
3 2 Current file name length. The length in bytes of the file name
returned by item 4.
4 * Current file name. The current fully qualified name of the
specified file. This might differ from item 2 because the file
might have been renamed since it was opened.
5 2 DEFINE name length. For files opened with a DEFINE, the
length in bytes of the DEFINE name; for other files, 0.
6 * DEFINE name. For files opened with a DEFINE, the name of
the DEFINE.
72
Last error. The file-system error number resulting from the last
file-system operation. If
filenum identifies an open file, the last
error associated with that file number is returned. If
filenum is
-1, the last error for an operation not associated with a file
number is returned. See “Considerations,” earlier in this
subsection.