Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-94
FILE_GETINFOLISTBYNAME_ Procedure
The subtype 30 process replies with the requested information in system message
-40 or -106, corresponding to the original message. The returned device type
value should be one of those listed in Appendix A, Device Types and Subtypes
. If
the message response is incorrectly formatted, the FILE_GETINFOLISTBYNAME_
caller receives device type and subtype values of 0. The REPLY caller (the
subtype 30 process) receives an error 2.
A deadlock occurs if a subtype 30 process calls FILE_GETINFOLISTBYNAME_ on
its own process name.
•
Last modification times and last open times
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.
•
Specifying a SMF logical file
When the FILE_GETINFOLISTBYNAME_ procedure is called with a file name that
designates an SMF logical file and the physical volume containing the associated
physical file is inaccessible, an error is returned. An exception to this is when a
call requests only items 182 and 183; in that case, the requested physical file
name is returned without error, provided that the SMF virtual volume process is
accessible and encounters no error.
•
Secondary partition of non-SQL Enscribe files
If the
filename argument contains a secondary partition of an Enscribe file other
than SQL, it returns only the value for the partition named. Only the primary
partition of a file other than an SQL file has information on the other partitions in its
label. Only when
filename contains the primary partition do the aggregate items
return the expected information.
•
Support for SQL files includes both Format 1 and Format 2 files.
•
Referencing Format 2 files with extent size greater than 65535
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.
OSS Considerations
•
The following item codes are not applicable to OSS objects but do not cause an
error to be returned: 50, 51, 59, 60, 61, and 62.
Example
itemlist := 54; ! return creation timestamp of file
number^of^items := 1;
result^max := 8; ! timestamp is 8 bytes long
error := FILE_GETINFOLISTBYNAME_ ( name:length, itemlist,