Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-163
CREATE Procedure
(Superseded by FILE_CREATELIST_ Procedure )
a 1-byte value, is used to specify a null value if key-attributes.<0> is
equal to 1.
During a write operation, if a null value is specified for an alternate-key field
and if the null value is encountered in all bytes of this key field, the file system
does not enter the reference to the record in the alternate-key file. (If the file is
read using this alternate-key field, records containing a null value in this field
will not be found.)
During a WRITEUPDATE operation (
write-count = 0), if a null value is
specified and if the null value is encountered in all bytes of this key field within
buffer, the file system deletes the record from the primary file but does not
delete the reference to the record in the alternate file.
key-len
(BYTE:value)
specifies the length, in bytes, of the alternate-key field. The maximum key
length of an alternate key that allows duplicates and is defined as insertion-
ordered (see
key-attributes, above) is:
255 - (10 + primary key length)
key-filenum
(INT:value)
is the relative number in the alternate-key parameter array of this key's
alternate-key file. The first alternate-key file's
key-filenum = 0.
The file name for file f consists of 12 words, beginning at:
[nk * 4 + 1 + f * 12]
This file name has the following form:
[0:3] $volname (blank-fill)
or
\
sysnum volname (blank-fill)
[4:7] subvol-name (blank-fill)
[8:11] file-id (blank-fill)