Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-165
FILEINQUIRE Procedure (Superseded by
FILE_GETINFOLISTBYNAME_ Procedure )
Condition Code Settings
< (CCL) indicates that an error occurred (see error-code).
= (CCE) indicates that the FILEINQURE was successful.
> (CCG) indicates that one or more of the items requested are invalid for the file’s
device type, file type, open status, or other characteristic.
Considerations
•
A particular item can be valid only when this procedure is called with filenumber,
or only with
file-name, or with either. This is indicated in Table 5-9.
•
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 4-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 5-9
.
Note. The information that items 6, 7, and 8 return is already available, either through
FILEINFO or FILERECINFO, but some users may find the FILEINQUIRE interface more
convenient.
Table 5-9. FILEINQUIRE Item Codes (page 1 of 3)
Code
Size
(bytes)
Valid with
Number/Name Description
1 6 num For labeled tapes, the tape volume serial
number of the reel currently being processed
2 24 num DEFINE name which was opened. Not valid for
files which were opened without use of a
DEFINE.
3 2 both For key sequenced disk files, the number of
levels used in the key indexing structure.