Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-79
FILE_GETINFOLIST_ Procedure
106 * Alternate-key descriptors (32-bit). An array of 14-byte descriptor
entries, one for each alternate key. Each entry has the
following structure:
INT key-specifier;
INT key-len;
INT (32) key-offset;
INT key-filenum;
INT null-value;
INT attributes;
The
attributes parameter has the following fields:
<0> Do not index when null.
<1> Unique.
<2> Do not update.
<3> Insertion order duplicate.
108 * Alternate-file relative name-length array. For disk files, an array
of INT byte counts, each giving the length of the corresponding
alternate-key file name in the form returned by item 109. The
length of this item is two times item 102.
109 * Alternate-file relative names. For disk files, the concatenated
names of the alternate-key files. Unlike item 104, the system
name can be left out (implying the system of the primary file)
depending on how the names were specified when the file was
created. The length of each name is given by the
corresponding entry in item 108. The length of this item is given
by the sum of the elements of item 108.
110 4 Volume capacity. For disk volumes and disk objects, the data
capacity of the volume as indicated in the volume label,
expressed in pages (2048-byte units). This value accounts for
disk space used for data protection (such as spare sectors), but
not for other system uses. For files residing on Storage
Management Foundation (SMF) virtual disks, this item code will
return a -1.
111 4 Volume free space. For disk volumes and disk objects, the total
free space currently available on the volume, in pages (2048-
byte units). For files residing on Storage Management
Foundation (SMF) virtual disks, this item code will return a 0.
Table 5-4. FILE_GETINFOLIST_ Item Codes (page 11 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