Guardian Procedure Calls Reference Manual

Table 18 FILE_GETINFOLIST_ Item Codes (continued)
DescriptionSize (Bytes)Item
Code
Current key value. For structured disk files, the current key value. Item 15 is not defined for
queue files.
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 204.
*15
Current primary-key length. For structured disk files, the length in bytes of the current primary-key
value. In H06.28/J06.17 RVUs with specific SPRs and later RVUs, the maximum primary-key
216
length for format 2 key-sequenced files is 2048. (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).) For earlier RVUs, the maximum primary-key length is 255, regardless of whether
the file is a format 1 or format 2 file.
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 205.
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.
*17
Tape volume. For labeled tape files, the volume serial number of the reel currently being
processed.
618
Highest open-file number. The highest file number of any currently open file.219
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.
220
Open access mode. The access mode under which the specified file has been opened. Values
are:
221
read-write0
read only1
write only2
extend (supported for tape, not disk)3
Open exclusion mode. The exclusion mode under which the specified file has been opened.
Values are:
222
shared0
exclusive1
protected3
Open nowait depth. The number of concurrent nowait operations permitted on the specified
file, as specified when the file was opened.
223
Open sync depth. The sync depth or receive depth under which the specified file has been
opened. For details, see the FILE_OPEN_ Procedure (page 457).
224
Open options. The miscellaneous options under which the specified file has been opened. For
details, see the FILE_OPEN_ Procedure (page 457).
225
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.
426
Device type. The device type associated with the specified file.230
Device subtype. The device subtype associated with the specified file.231
Demountable disk. For disk volumes and disk objects, 1 if the volume is demountable; 0
otherwise.
232
414 Guardian Procedure Calls (F)