Guardian Procedure Calls Reference Manual

Table 22 FILEINQUIRE Item Codes (continued)
DescriptionValid with
Number/Name
Size (bytes)Code
the time of its creation is returned. This is the same information as
available through FILEINFO in three-word TIMESTAMP form.
For particular access methods on some devices, a value associated
with the last completed I/O operation. The meaning of the value is
num417
specific to the access method. For SNAX, it is the exception response
identification number.
Considerations
• If error 2 (operation not allowed for file type) occurs but no other errors occur (as indicated
by condition code CCG), the other, valid items (if any) in the item-list still have their
values returned. If an invalid item is of fixed size, the space for the item will be reserved in
the result buffer, but the value is undefined. If an invalid item is of variable size, no
space for it is reserved.
• If the result buffer is not large enough to hold the specified items, error 563 (buffer too
small) will be returned.
• A call to FILEINQUIRE does not alter the saved error code associated with a file.
• For DP2 disk files, the values returned for time of file creation and last open are in the four-word
format for the time stamp. A peculiarity in the last open date could arise. The creation date
for a file has been maintained since the first DP2 release, but the last open date and time has
been maintained only since the B30 release of DP2. Therefore, it is possible that the date of
last open for DP2 files could appear to be January 1, 4713 B.C. (returned as 0F). See Table 22.
• In H06.28/J06.17 RVUs with specific SPRs and later RVUs, if error 582 is reported for a
format 2 key-sequenced file with increased limits, at least one of the returned values in
alternate-key-parameters array was too large for its defined field and the maximum
value for the field was stored instead (such as, 255 for the alternate key length field, 4095
for the alternate key offset field). (For a list of the required H06.28/J06.17 SPRs, see SPR
Requirements for Increased Enscribe Limits for the H06.28/J06.17 Release (page 31).) You
can call one of the superseding routines, FILE_GETINFOLIST[BYNAME]_, to get the full file
attribute values for the file.
FILEINQUIRE Procedure (Superseded by FILE_GETINFOLISTBYNAME_ Procedure) 563