Guardian Procedure Calls Reference Manual

Table 18 FILE_GETINFOLIST_ Item Codes (continued)
DescriptionSize (Bytes)Item
Code
Alternate-key descriptors (32-bit). An array of 14-byte descriptor entries, one for each alternate
key. The structure of each entry is described under item 106 in Table 17 (page 394) (under
FILE_CREATELIST_). The length in bytes of this item is 14 times the value of item 100.
*106
If this value has never been set, the key length of the file (the value of item 46) is returned.
Supersedes item 101.
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.
*108
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)
*109
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.
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
4110
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.
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.
4111
Volume fragments. For disk volumes and disk objects, the number of individual free space
fragments on the volume. For files residing on SMF (Storage Management Foundation) virtual
disks, this item code will return a 0.
4112
Largest volume fragment. For disk volumes and disk objects, the size in pages of the largest
free space fragment on the volume. For files residing on SMF (Storage Management Foundation)
virtual disks, this item code will return a 0.
4113
Disk drive types. For disk volumes and disk objects, the types of drives on which the volume
is mounted. This item contains two eight-byte fields that give the types of the primary and mirror
16114
drives respectively. Each field is a drive-product number in ASCII. If the information is
unavailable for a drive (because it's inaccessible or not configured), the corresponding field
is returned blank. For drive models 4110 and 4120, which cannot be distinguished by software,
the returned value is 4110. For files residing on SMF (Storage Management Foundation) virtual
disks, this item code will return blanks.
Disk drive capacities. For disk volumes and disk objects, the capacities in pages (2048-byte
units) of the primary and mirror drives on which the volume is mounted. This item contains two
8115
INT(32) values, expressing in pages (2048-byte units) the capacities of the primary and
mirror drives respectively. The values account for disk space used for data protection (such as
spare sectors), but not for other system uses. If the information is unavailable for a drive (because
it is inaccessible or not configured), 0D is returned for that drive. For files residing on SMF
(Storage Management Foundation) virtual disks, this item code will return blanks.
Sequential block buffering. 1 if the open is using a sequential block buffer; 0 otherwise.2116
Last open LCT. For disk objects, the timestamp of the last time the file was opened, expressed
in the local civil time (LCT) of the system on which the file resides.
8117
Expiration LCT. For disk objects, the timestamp giving the time before which the file cannot be
purged, expressed in the local civil time (LCT) of the system on which the file resides. If this
attribute has not been set, the returned field is zero-filled.
8118
Creation LCT. For disk objects, the timestamp of the file's creation, expressed in the local civil
time (LCT) of the system on which the file resides.
8119
Partition EOF. For disk objects other than SQL shorthand views, the end-of-file value of the
partition named in the open operation (when returned by FILE_GETINFOLIST_) or of the partition
4136
named in this call (when returned by FILE_GETINFOLISTBYNAME_). A returned value of -1
FILE_GETINFOLIST_ Procedure 419