Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-159
CREATE Procedure
(Superseded by FILE_CREATELIST_ Procedure )
recordlen input
INT:value
is the maximum length of the logical record in bytes. If omitted, 80 is used. This
parameter is ignored for unstructured files.
The formulas for computing the maximum record size (MRS) based on
data-
blocklen are:
data-blocklen input
INT:value
for structured files, is the length in bytes of each block of records in the file. The
value of
data-blocklen cannot be greater than 4096. The value of data-
blocklen must be at least recordlen + 24. For a key-sequenced file, the value
of
data-blocklen must be at least recordlen + 34.
If omitted, 1024 is the default value used for
data-blocklen. Regardless of the
specified record length and data-block size, the maximum number of records that
can be stored in a data block is 511.
Data-block sizes are rounded up to power-of-two multiples of the sector size; 512,
1024, 2048, and 4096. For example, if a 3K byte block were specified, the system
would use 4096.
key-sequenced-params input
INT:ref:3
is a three-word array containing parameters that describe this file. This parameter
is required for key-sequenced files, but you can omit the parameter for other file
types. See “Considerations” for the format of this array.
alternate-key-params input
INT:ref:*
is an array containing parameters describing any alternate keys for this file. This
parameter is required if the file has alternate keys; otherwise, you can omit this
parameter. If included, the first word must be 0 if you do not have alternate keys.
See “Considerations” for the format of this array.
For this type of file MRS equals
Relative and entry-sequenced
files
data-blocklen - 24
Key-sequenced files
data-blocklen - 34
Unstructured files 4096