Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-162
CREATE Procedure
(Superseded by FILE_CREATELIST_ Procedure )
nf-alt-files
a 1-byte value, specifies the number of alternate-key files for this primary file.
nk-alt-keys
a 1-byte value, specifies the number of alternate-key fields in this primary file.
The key description for key k consists of four words, each of the form:
key-specifier
(INT:value)
is a 2-byte value that uniquely identifies this alternate-key field. It must be
nonzero. This value is passed to the KEYPOSITION procedure for references
to this key field.
key-attributes
(INT:value)
describes the key:
<0> 1 Means that a null value is specified. See null-value, below.
<1> 1 Means that the key is unique. If an attempt is made to insert a record
that duplicates an existing value in this field, the insertion is rejected
with a “duplicate record” error.
<2> 1 Means that Enscribe cannot perform automatic updating of this key.
<3> 0 Means that alternate key records with duplicate key values are ordered
by the value of the primary record key field. This attribute has meaning
only for alternate keys that allow duplicates.
1 Means that alternate key records with duplicate key values are ordered
by the sequence in which those records were inserted into the
alternate key file. This attribute is allowed only for alternate keys that
allow duplicates.
<4:15>key-offset
Specifies the number of bytes from the beginning of the record where
this key field starts.
null-value
(BYTE:value)
08
[k * 4 + 1] key-specifier
[k * 4 + 2]
key-attributes
[k * 4 + 3]
null-value key-len
[k * 4 + 4]
key-filenum