Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-46
FILE_CREATELIST_ Procedure
92 * 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 is to reside. The length in bytes of this item is 2 times
the value of item 90.
93 * Partition-volume names. For disk files, contains the
concatenated names of the secondary partition volumes.
Because each name occupies exactly the number of characters
specified in the corresponding entry of item 92, the total length
in bytes of this item is the sum of the values in item 92. A name
can be partially qualified, in which case the missing system
name is taken from the =_DEFAULTS DEFINE. The volume
name can be a full eight characters, including the dollar sign,
only if the system (specified or implied) is the same as the
system on which the primary partition is being created. Item 99
is an alternate form for this item.
When item 90 is supplied and the file to be created is key-sequenced, items 94 and
95 must also be supplied following item 93 or item 99, and they must be supplied as
consecutive items in the order presented here:
94 2 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.
The minimum value is 1.
95 * Partition partial-key values. For partitioned key-sequenced disk
files, the concatenated partial-key values. Because 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.
97 * Partition descriptors (32-bit). An array of 8-byte values, one for
each secondary partition. Each entry has the following
structure:
INT (32) priextentsize;
INT (32) secextentsize;
These values give the primary and secondary extent sizes in
pages. For Format 1 files, the size must be less than 65,536.
The length of this item in bytes is eight times item 90. Item 91
is an alternate form for this item.
Table 5-3. FILE_CREATELIST_ Item Codes (page 5 of 12)
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.
Item
Code
Size
(Bytes) Description