Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-43
FILE_CREATELIST_ Procedure
44 2
Block length. For structured disk objects, the size of a block of
records; for unstructured disk files, controls the internal buffer
size. The supplied value is rounded up to 512, 1024, 2048, or
4096. The default value is 4096. For details, see the
blocklen
parameter of FILE_CREATE_. Item 197 is an alternate form for
this item.
45 2 Key offset. For key-sequenced disk files, the byte offset from
the beginning of the record to the primary-key field. Either this
item or item 198 is required for key-sequenced files.
46 2 Key length. For key-sequenced disk files, the maximum
number of bytes in the file’s primary-key field. The maximum
value is 255. Required for key-sequenced files.
47 2 Lock-key length. For key-sequenced files, specifies the generic
lock-key length. The length must be between 1 and the key
length of the file, or can be 0 to automatically use the key length
of the file. The length must be 0 for non-key-sequenced files.
50 2 Primary extent size. For disk objects other than SQL shorthand
views, an unsigned integer specifying the size of the first extent,
in pages (2048-byte units). The maximum extent size is 65,535
pages (134,215,680 bytes). If this item is omitted or is equal to
0, a size of 1 is used. The value might be rounded up to an
even number during file creation. Item 199 is an alternate form
for this item.
51 2 Secondary extent size. For disk objects other than SQL
shorthand views, an unsigned integer specifying the size of
extents after the first one, in pages (2048-byte units). The
maximum extent size is 65,535 (134,215,680 bytes). (A file can
have up to 15 secondary extents allocated.) If this item is
omitted or equal to 0, the primary extent size is used. The
supplied value might be rounded up to an even number during
file creation.
52 2 Maximum extents. For disk objects other than SQL shorthand
views, the maximum number of extents allowed for the file. The
minimum and default value is 16. See under “Considerations”
for FILE_CREATE_ for the limits on this value. (For partitioned
files that are not key-sequenced, the only value permitted
is 16.)
Table 5-3. FILE_CREATELIST_ Item Codes (page 2 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