Guardian Procedure Calls Reference Manual

Table 18 FILE_GETINFOLIST_ Item Codes (continued)
DescriptionSize (Bytes)Item
Code
These values give the primary and secondary extent sizes in pages (2048-byte units). The
length of this item in bytes is four times item 90. Superseded by item 97.
Partition-volume name-length array. For disk files, an array of INT values, each giving the length
in bytes of the volume name (supplied in item 93) on which the corresponding secondary
partition resides. The length in bytes of this item is 2 times the value of item 90.
*92
Partition-volume names. For disk files, the concatenated volume names of the secondary
partitions. The names are fully qualified. The length of each is given by the corresponding
*93
entry in item 92. The length of this item is given by item 96, or equivalently, by the sum of the
elements in item 92.
Partition partial-key length. For partitioned key-sequenced disk files, the number of bytes of the
primary key that are used to determine which partition of the file contains a particular record.
294
Partition partial-key values. For partitioned key-sequenced disk files, the concatenated partial-key
values. Since the number of entries is given by item 90, and the size of each entry is given by
item 94, the size of item 95 is the product of those two values.
*95
Partition-volume names total length. For disk files, the total number of bytes occupied by the
concatenated volume names of the secondary partitions. This is the same as the sum of the
elements in item 92.
296
Partition descriptors (32-bit). An array of eight-byte partition descriptors, one for each secondary
partition. Each entry has this structure:
INT (32) primary-extent-size;
INT (32) secondary-extent-size;
*97
These values give the primary and secondary extent sizes in pages (2048-byte units). For a
format 1 legacy key-sequenced file, the maximum extent size is 65,535 pages; for a format
2 legacy key-sequenced file, the maximum extent size is 536,870,912 pages. For an enhanced
key-sequenced file, the maximum extent size is 536,870,912 pages, and the primary partition
must have a primary extent size of at least 140 pages. The length of this item in bytes is eight
times item 90. Supersedes item 91.
Partition-volume relative names-length array. For disk files, an array of INT byte counts, each
giving the length of the corresponding secondary partition-volume name in the form returned
*98
by item 99. The length of this item is two times item 90. The length of this item is the sum of
the elements in item 98.
Partition-volume relative names. For disk files, the concatenated names of the volumes of the
secondary partitions. Unlike item 93, the names can be missing a system name (implying the
*99
system of the primary file) depending on how the names were specified when the file was
created.
Number of alternate keys. For disk files, the number of alternate-key fields.2100
Alternate-key descriptors. For disk files, an array of key-descriptor entries, one for each alternate
key. Each entry is 12 bytes long. The structure of each entry is described under item 101 in
*101
Table 17 (page 394) (under FILE_CREATELIST_). The length in bytes of this item is 12 times the
value of item 100. Superseded by item 106.
Number of alternate-key files. For disk files, the number of files holding alternate-key records.2102
Alternate-file name-length array. For disk files, an array of INT values, each giving the length
in bytes of the corresponding alternate-file name found in item 104. The length in bytes of this
item is 2 times the value of item 102.
*103
Alternate-file names. For disk files, the concatenated names of the alternate-key files. The names
are fully qualified. The length of each is given by the corresponding entry in item 103. The
*104
length of this item is given by item 105, or equivalently, by the sum of the elements of item
103.
Alternate-file total name length. For disk files, the total number of bytes occupied by the
concatenated alternate-file names. This is the same as the sum of the elements in item 103.
2105
418 Guardian Procedure Calls (F)