Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-71
FILE_GETINFOLIST_ Procedure
17 * Current primary-key value. For structured disk files, the current
primary-key value. This item cannot be used with the 64-bit
primary-key election of the FILE_OPEN_ procedure; an attempt
results in error 581. Superseded by item 206.
18 6 Tape volume. For labeled tape files, the volume serial number
of the reel currently being processed.
19 2 Highest open-file number. The highest file number of any
currently open file.
20 2
Next open-file number. The next file number of any open file
higher than the input
filenum value; if no higher-numbered
open file exists, a value of -1 is returned.
21 2 Open access mode. The access mode under which the
specified file has been opened. Values are:
0 read-write
1 read only
2 write only
3 extend (supported for tape, not disk)
22 2 Open exclusion mode. The exclusion mode under which the
specified file has been opened. Values are:
0 shared
1 exclusive
3protected
23 2 Open nowait depth. The number of concurrent nowait
operations permitted on the specified file, as specified when the
file was opened.
24 2 Open sync depth. The sync depth or receive depth under which
the specified file has been opened. See FILE_OPEN_ for
details.
25 2 Open options. The miscellaneous options under which the
specified file has been opened. See FILE_OPEN_ for details.
26 4 Operation information. For particular access methods on some
devices, a value associated with the last completed I/O
operation. The meaning of the value is specific to the access
method. For SNAX, it is the exception response identification
number.
30 2 Device type. The device type associated with the specified file.
Table 5-4. FILE_GETINFOLIST_ Item Codes (page 3 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